Receive Management Information
This topic explains how to register the file information for the file to be received.
You can view and modify this information on the following screens:
- Transfer Information screen
- Collecting and Distributing System Management Information screen
You can also import and export this information on the following screen:
- Collecting and Distributing System Management Information screen
List of Fields
1. Receive Management Information
<Table> List of Fields for Receive Management Information
| No. | Field Name | Default Value | Setting Value | Specification | Remarks | Transfer | Distribute |
|---|---|---|---|---|---|---|---|
| A1 | File ID | Alphanumeric characters | Mandatory | Within 8 bytes (starting with an alphabetic character) | Outside the panel | ✓ | |
| A2 | File Name | Alphanumeric characters | Mandatory | From 3 to 33 bytes | Basic Settings | ✓ | |
| A3 | Record Length | From 1 to 32766 | Mandatory | Basic Settings | ✓ | ||
| A4 | Receive Mode | Single Receive | *1 | Mandatory | Basic Settings | ✓ | |
| A5 | Registration Mode | New Creation | *1 | Mandatory | Basic Settings | ✓ | |
| A6 | Generation File | No | *1 | Mandatory | Basic Settings | ✓ | |
| A7 | Error Recovery | Delete | *1 | Mandatory | Basic Settings | ✓ | |
| A8 | Generation File Count | 0 | 0, 2 to 9999 | Mandatory | Basic Settings | ✓ | |
| A9 | Successful Job ID | Alphanumeric characters | Optional | Within 8 bytes (starting with an alphabetic character) | Basic Settings | ✓ | |
| A10 | Unsuccessful Job ID | Alphanumeric characters | Optional | Within 8 bytes (starting with an alphabetic character) | Basic Settings | ✓ | |
| A11 | Comment | Alphanumeric characters | Optional | Within 60 bytes | Outside the panel | ✓ | |
| A12 | Transfer Group ID | *2 | Alphanumeric characters | Optional | Within 8 bytes (starting with an alphabetic character) | Outside the panel | ✓ |
| A13 | EBCDIC Code Set | Kana | *1 | Mandatory | Extension Settings | ✓ | |
| A14 | Notification | Receive Completion | *1 | Mandatory | Extension Settings | ✓ | |
| A15 | Cipher Key | Alphanumeric characters | Optional | From 8 to 20 bytes | Extension Settings | ✓ | |
| A16 | Verify Data | No | *1 | Mandatory | Extension Settings | ✓ |
| *1: | When you configure settings on the screen, select an option from the list that is shown on the screen. |
| *2: | When you register a Transfer definition in HULFT-HUB Manager, the field is automatically set. |
| [Note] | You cannot view or modify the Format ID setting value on screens in HULFT-HUB Manager. |
2. Additional information other than Receive Management Information
You can view both the Receive Management Information and the following additional information on each screen where you edit Transfer definitions.
<Table> List of Fields for Additional Information other than Receive Management Information
| No. | Field Name | Default Value | Setting Value | Specification | Remarks | Transfer | Distribute |
|---|---|---|---|---|---|---|---|
| B1 | Host Name | Alphanumeric characters | *1 | Outside the panel | - | ||
| B2 | File Alias *2 | Alphanumeric characters | Optional | Within 256 bytes | Outside the panel | ✓ | |
| B3 | Batch Distribution ID | Alphanumeric characters | *1 | - | ✓ | ||
| B4 | Business Group ID | *3 | Mandatory | - | ✓ |
| *1: | You are allowed only to view this field on the screen. |
| *2: | This information is shown as 'Alias' on the Collecting and Distributing System Management Information screen. |
| *3: | When you configure settings on the screen, select an option from the list that is shown on the screen. |
| [Legend] | |
| Default Value | Value that is set for the field when you create a new management information record on a screen |
| Specification | Whether the specification is mandatory or optional when you update the management information record on a screen |
| Transfer | Transfer Information screen |
| Distribute | Collecting and Distributing System Management Information screen |
| ✓ | Availability of the field |
Explanation of Each Field
The following describes the fields that are configured in the Receive Management Information.
For a field for which you select an option from the list, the following shows both the options that are displayed on the screen and the values that are described in the CSV file to be used for Collecting and Distributing System Management Information.
1. Receive Management Information
This field specifies the ID to identify the file to be received.
This field specifies the file to be stored in i5OS.
For physical data files, specify the format as 'Library Name/File Name (Member Name).'
For stored files, specify the format as 'Library Name/File Name.'
By specifying '&SNDFILE' (physical data files) and '&SNDFILES' (stored files), you can use the Send file name on the host on the sending side as the Receive file name. If the host on the sending side is i5OS, specify '&SNDLIB' to use the library name of the Send file as the library name of the Receive file. For details about the naming rules when you use the Send file name as the Receive file name, refer to <Table> File Naming Rules.
When specifying '&SNDFILE,' '&SNDFILES,' and '&SNDLIB,' select 'Single Receive' (S) for the Receive Mode.
This field specifies the record length of the file to be received.
If a Receive file does not exist, specify the record length for the Receive file to be created. If a Receive file already exists, specify the record length for that file.
If the record length that is specified in the management information is not the same as the record length of the Receive file, the operation will be different depending on the Receive Mode setting. If 'Single Receive' (S) is specified for the Receive Mode, HULFT ignores the record length that is specified in the management information when receiving the file. If 'Multiple Receive' (M) is specified for the Receive Mode, a receiving error will occur.
This field specifies the receive mode for the file to be received.
<Table> Setting Values for Receive Mode
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| Single Receive | S | Receive the file from a single host |
| Multiple Receive | M | Receive files from multiple hosts and create a single file |
If you select 'Multiple Receive' (M), select 'Append' (M) for the Registration Mode and 'Keep' (K) for the Error Recovery.
This field specifies the registration mode for the file to be received.
<Table> Setting Values for Registration Mode
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| New Creation | N | New creation mode |
| Replace | R | Replace mode |
| Append | M | Append mode |
When you select 'Single Receive' (S) for the Receive Mode and 'Append' (M) for the Registration Mode, if an error occurs while a file is being received the receiving data up until the error occurred will be appended.
This field specifies whether HULFT creates generation files for the Receive file.
<Table> Setting Values for Generation File
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| No | N | Generation File Management is not available |
| Yes | Y | Generation File Management is available |
If you select 'Yes' (Y), select either 'New Creation' (N) or 'Replace' (R) for the Registration Mode and select 'Delete' (D) for the Error Recovery.
This field specifies how to treat the Receive file when receiving fails.
<Table> Setting Values for Error Recovery
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| Delete | D | Delete the Receive file |
| Keep | K | Save the Receive file at the point the failure occurs |
| Restore | R | Restore the file before receiving started |
| [Note] | |
| 1. | Points to be noted when you select 'Delete' (D) |
| When you select 'New Creation' (N) for the Registration Mode, if an error occurs because the Receive file already exists, HULFT will not delete the existing file. | |
| 2. | Points to be noted when you select 'Keep' (K) |
| When you select 'Multiple Receive' (M) for the Receive Mode, if an error occurs while HULFT is receiving data to temporary files, the receiving data up until the point where the error occurred will not be written to the Receive file. If an error occurs while data in the temporary files is being copied to the Receive file, the receiving data up until the point where the error occurred will be appended. Therefore, there must be a system to check for duplicate data with an application program. | |
| 3. | Points to be noted when you select 'Restore' (R) |
| When you select 'Append' (M) for the Registration Mode, if an error occurs while a file is being received the receiving data up until the error occurred will be appended. |
This field specifies the generation file count for the file to be received.
If you selected 'Yes' (Y) for the Generation File, set a numeric value from 2 to 9999.
If you selected 'No' (N) for the Generation File, set '0.'
In CSV files for Collecting and Distributing System Management Information, you can omit this setting if you specified 'N' for the Generation File (AS).
This field specifies the ID of the job that HULFT starts when the receiving of the file ends successfully.
For details about the job ID, refer to Job Information (i5OS).
If you omit this field, HULFT does not start the job.
This field specifies the ID of the job that HULFT starts when the receiving of the file ends unsuccessfully.
For details about the job ID, refer to Job Information (i5OS).
If you omit this field, HULFT does not start the job.
This field specifies the comment regarding the file to be received.
| [Note] | If you enter double-byte codes on a screen in HULFT-HUB Manager, shift codes may be added to the double-byte codes when the information is registered on the client side. If the data exceeds 60 bytes when shift codes are added, HULFT will cut the data of the 61st byte and after. |
| [Remarks] | For clients that are running HULFT Ver.7.3.0 or higher, you can enter lowercase alphabetic characters. |
This field specifies the ID for which the host on the sending side for the file to be received is registered.
For details about the transfer group ID, refer to Transfer Group Information (i5OS).
| [Note] | For Transfer definitions that are registered on the Transfer Information screen in HULFT-HUB Manager, HULFT-HUB automatically selects as default values the transfer group IDs (for transfer groups that are registered on the client side) that include the host on the receiving side that is selected in the transfer map. If there is no relevant transfer group ID, HULFT-HUB automatically sets an 8-character transfer group ID that starts with 'HB.' |
This field specifies the EBCDIC code system (encoding code scheme) that is used for single byte code conversion.
<Table> Setting Values for EBCDIC Code Set
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| Kana | A (default value) | EBCDIC Kana |
| Lower Case | B | EBCDIC Lower Case |
| ASCII | C | EBCDIC ASCII |
| ASPEN | D | EBCDIC ASPEN |
| Standard | E | IBM Standard |
| Standard Extension | F | IBM Standard Extension |
| NEC Kana | G | NEC Kana |
| Kana Extension | H | Kana Extension |
| User Table 1 | V | User Table 1 |
| User Table 2 | W | User Table 2 |
| User Table 3 | X | User Table 3 |
You can use this setting when the Code Conversion for the Send Management Information on the host on the sending side is 'Receiving Host' (R).
| [Note] | You cannot select 'Kana Extension' (H) in versions lower than HULFT Ver.7.3.0. |
This field specifies the Receive Completion Notification to be sent to the host on the sending side.
<Table> Setting Values for Notification
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| Receive Completion | T (default value) | Notify after receive completion |
| Successful Job Completion | J | Notify after successful job completion |
This field specifies the key for decrypting data.
Specify this field to decrypt data that has been encrypted. Set the same cipher key that has been set in the Send Management Information on the remote host.
If a cipher key is specified on the host on the receiving side but not specified in the Send Management Information on the host on the sending side, HULFT ignores the cipher key.
This field specifies whether or not to verify data of the file to be received.
<Table> Setting Values for Verify Data
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| No | 0 (default value) | Do not verify data |
| Yes | 1 | Verify data |
2. Additional information other than Receive Management Information
This additional information is displayed together with the Receive Management Information on each screen where you edit Transfer definitions. You can view and modify this information on screens in HULFT-HUB Manager.
| [Note] | You cannot view this additional information on the Management screen on the client (HULFT) side. |
This field shows the host name for the client for which the Receive Management Information is registered.
| [Remarks] | You can view this field on the Transfer Information screen (cannot be updated). |
This field specifies the alias for the Receive file.
It is recommended that you assign a unique name in the Receive Management Information so that each file ID that is displayed on screens in HULFT-HUB Manager can be easily identified.
| [Remarks] | This information is shown as 'Alias' on the Collecting and Distributing System Management Information screen. |
This field shows the Batch Distribution Information ID with which the Receive Management Information is registered as distribution data.
| [Remarks] | You can view this field on the Collecting and Distributing System Management Information screen (cannot be modified). |
This field specifies the Business Group ID that uses this Receive Management Information.
| [Remarks] | You can view this field on the Collecting and Distributing System Management Information screen. |
Points to be Noted When Configuring Settings
1. Specification of Registration Mode, Receive Mode, and Generation File
The combinations that can be specified in the Receive Management Information are shown below.
<Table> Setting Combinations in Receive Management Information
|
Receive Mode | Single Receive (S) | Multiple Receive (M) | |||
|---|---|---|---|---|---|---|
| Registration Mode |
|
Generation File | Yes (Y) | No (N) | Yes (Y) | No (N) |
| Error Recovery |
|
|||||
| New Creation (N) | Delete (D) | ✓ | ✓ | |||
| Keep (K) | ✓ | |||||
| Restore (R) | ✓ | |||||
| Replace (R) | Delete (D) | ✓ | ✓ | |||
| Keep (K) | ✓ | |||||
| Restore (R) | ✓ | |||||
| Append (M) | Delete (D) | ✓ | ||||
| Keep (K) | ✓ | ✓ | ||||
| Restore (R) | ✓ | |||||
2. Stored files
When specifying a stored file for the Receive File Name, select 'Single Receive' (S) for the Receive Mode. You cannot specify 'Append' (M) as the Registration Mode.
3. Replacement message
You can replace variables with received messages by specifying the variables from '&MSG0' to '&MSG5' in the following fields (Message Transmission function):
| - File Name | |
| - Transfer Group ID | |
| - Successful Job ID |
| [Note] | |
| - | You can edit the Transfer Group ID only on the Collecting and Distributing System Management Information screen. On the Transfer Information screen, you can select only an ID that has been set automatically by HULFT-HUB Manager or an existing transfer group ID, and therefore you cannot carry out replacement with message. |
| - | For details about the Message Transmission function, refer to Administration Manual for the client. |
4. File naming rules
The naming rules when you use the Send file name as the Receive file name are shown below.
| Host Type | Send File Name | Receive File Name (i5OS) | |||
|---|---|---|---|---|---|
| &SNDLIB&SNDFILE | MYLIB/&SNDFILE | &SNDLIB&SNDFILES | MYLIB/&SNDFILES | ||
| Mainframe |
Sequential Organization file HULFT.DAT.SND.F01 |
Conversion error | MYLIB/FO1(SND) | Conversion error | MYLIB/SND |
|
Partitioned Organization file HULFT.DAT.F02(SND) |
Conversion error | MYLIB/FO2(SND) | Conversion error | MYLIB/SND | |
| UNIX/Linux | /HULFT/DAT/SND.F03 | Conversion error | MYLIB/FO3(SND) | Conversion error | MYLIB/SND |
| Windows | C:\HULFT\DAT\SND.F04 | Conversion error | MYLIB/FO4(SND) | Conversion error | MYLIB/SND |
| i5OS
|
Physical file HULFT/F05(SND) |
HULFT/F05 | MYLIB/FO5(SND) | Conversion error | Conversion error |
|
Stored file HULFT/F06 |
Conversion error | Conversion error | HULFT/F06 | MYLIB/F06 | |