Send Management Information
This topic explains how to register the file information for the file to be sent.
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. Send Management Information
<Table> List of Fields for Send 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 *4 | Alphanumeric characters | Mandatory | From 3 to 33 bytes | Basic Settings | ✓ | |
| A3 | Transfer Type | TEXT | *1 | Mandatory | Basic Settings | ✓ | |
| A4 | Compression Level | None | *1 | Mandatory | Basic Settings | ✓ | |
| A5 | Code Conversion | Sending Host | *1 | Mandatory | Basic Settings | ✓ | |
| A6 | Pre-send Job ID | Alphanumeric characters | Optional | Within 8 bytes (starting with an alphabetic character) | Basic Settings | ✓ | |
| A7 | Successful Job ID | Alphanumeric characters | Optional | Within 8 bytes (starting with an alphabetic character) | Basic Settings | ✓ | |
| A8 | Unsuccessful Job ID | Alphanumeric characters | Optional | Within 8 bytes (starting with an alphabetic character) | Basic Settings | ✓ | |
| A9 | Format/Multi Format ID | Alphanumeric characters | Optional | Within 8 bytes (starting with an alphabetic character) *2 | Basic Settings | ✓ | |
| A10 | Interface DBID | Alphanumeric characters | Optional | Within 8 bytes *2 | Basic Settings | ✓ | |
| A11 | Transfer Group ID | *3 | Alphanumeric characters | Mandatory | Within 8 bytes (starting with an alphabetic character) | Outside the panel | ✓ |
| A12 | Comment | Alphanumeric characters | Optional | Within 60 bytes | Outside the panel | ✓ | |
| A13 | Transfer Interval | 0 | From 0 to 32767 | Mandatory | Unit: msec | Extension Settings | ✓ |
| A14 | Send File Mode | Keep | *1 | Mandatory | Extension Settings | ✓ | |
| A15 | Transfer Block Length | 4096 | From 128 to 65520 | Mandatory | Extension Settings | ✓ | |
| A16 | Transfer Block Count | 3 | From 1 to 99 | Mandatory | Extension Settings | ✓ | |
| A17 | Transfer Priority | 50 | From 1 to 256 | Mandatory | Extension Settings | ✓ | |
| A18 | EBCDIC Code Set | Kana | *1 | Mandatory | Extension Settings | ✓ | |
| A19 | Subsequent Character | No Cut | *1 | Mandatory | Extension Settings | ✓ | |
| A20 | Cipher Key | Alphanumeric characters | Optional | From 8 to 20 bytes | Extension Settings | ✓ | |
| A21 | Shiftcode Mode | Cut | *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: | You can configure this setting when you select 'FORMAT' (F) or 'MULTIFORMAT' (M) for the Transfer Type. |
| *3: | When you register a Transfer definition in HULFT-HUB Manager, the field is automatically set. |
| *4: | This information is shown as 'Send File Name' on the Collecting and Distributing System Management Information screen. |
2. Additional information other than Send Management Information
You can view both the Send Management Information and the following additional information on each screen where you edit Transfer definitions.
<Table> List of Fields for Additional Information other than Send Management Information
| No. | Field Name | Default Value | Setting Value | Specification | Remarks | Transfer | Batch |
|---|---|---|---|---|---|---|---|
| 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 | - | ✓ |
| *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 Send 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. Send Management Information
This field specifies the ID to identify the file to be sent.
This field specifies the file that is stored on i5/OS.
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.'
| [Remarks] | This information is shown as 'Send File Name' on the Collecting and Distributing System Management Information screen. |
This field specifies the data type of the file to be sent.
<Table> Setting Values for Transfer Type
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| FORMAT | F | Format data |
| BINARY | B | Binary data |
| TEXT | T | Text data |
| MULTIFORMAT | M | Multi format data |
| [Note] | For transferring stored files, you can only specify 'BINARY' (B). |
This field specifies whether HULFT carries out compression when the file is transferred.
<Table> Setting Values for Compression Level
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| None | N | No compression |
| Horizontal | 1 | Compression within each record |
| Vertical | 2 | Compression across records |
This field specifies the host that carries out code conversion for the file to be sent.
<Table> Setting Values for Code Conversion
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| Sending Host | S | Sending side conversion |
| Receiving Host | R | Receiving side conversion |
| No Conversion | N | No conversion |
This field specifies the ID of the job that HULFT starts before the Send processing is carried out.
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 sending 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 sending 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 registered ID for format or multi format of the file to be sent.
For details about the format ID, refer to Format Information (i5OS).
For details about the multi format ID, refer to Multi Format Information (i5OS).
If the Transfer Type is 'FORMAT' (F), the Format ID is required; if the Transfer Type is 'MULTIFORMAT' (M), the Multi Format ID is required.
This field specifies the interface on the host on the receiving side for sending data.
| - CSV: | Carry out CSV conversion of the Receive file on the host on the receiving side |
| - XML: | Carry out XML conversion of the Receive file on the host on the receiving side |
To receive the file in CSV format (UNIX, Linux, Nonstop, Windows) or XML format (UNIX, Linux, Windows) on the host on the receiving side, specify the fixed characters that are shown above.
If you omit this field, HULFT does not carry out receiving in CSV format and receiving in XML format. To interface, select 'FORMAT' (F) or 'MULTIFORMAT' (M) for the Transfer Type.
This field specifies the ID for which the sending destination host for the file to be sent 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 comment regarding the file to be sent.
| [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 interval from the end of the transfer of one block (the product of the Transfer Block Length and the Transfer Block Count) to the transfer of the next block.
This allows files to be transferred without monopolizing the network (intermittent transfer).
This field specifies whether to apply the exclusive control during sending of the Send file, and the processing when the sending of the file ends successfully.
<Table> Setting Values for Send File Mode
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| Keep | K | Do not lock during sending, and save the file after the sending of the file ends successfully |
| Clear | C | Lock during sending, and make the file a 0-byte file after the sending of the file ends successfully |
| Delete | D | Lock during sending, and delete the file after the sending of the file ends successfully |
| Lock | L | Lock during sending, and save the file after the sending of the file ends successfully |
| [Note] | If you select anything other than 'Keep' (K) for the Send File Mode, HULFT cannot carry out multicasting that transmits from HULFT on the sending side to all transfer destinations (client-side multicasting function). |
This field specifies the length of one block for transfer.
You cannot set this value so that the product of the Transfer Block Length and the Transfer Block Count exceeds '65520.'
This field specifies the number of blocks per transfer.
You cannot set this value so that the product of the Transfer Block Length and the Transfer Block Count exceeds '65520.'
This field specifies the priority in the queue for transferring files.
Greater priority is given to smaller numeric values.
If there is more than one transfer processing in the queue, you can start the Send processing for the file you want to send first by setting a lower value for the transfer priority.
If you omit this specification in the CSV file for Collecting and Distributing System Management Information, HULFT-HUB sets '50.'
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 | 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 | IBM Kana Extension |
| User Table 1 | V | User Table 1 |
| User Table 2 | W | User Table 2 |
| User Table 3 | X | User Table 3 |
| [Note] | You cannot select 'Kana Extension' (H) in versions lower than HULFT Ver.7.3.0. |
This field specifies the handling of subsequent characters.
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| Space Cut | S | Cut trailing spaces |
| No Cut | N | Do not cut trailing spaces or NULLs |
You can select only 'No Cut' (N) if you selected 'BINARY' (B), 'FORMAT' (F), or 'MULTIFORMAT' (M) for the Transfer Type.
This field specifies the key for encrypting data.
Security is applied to the file to be sent. Set the same cipher key that has been set in the Receive Management Information on the remote host.
This field specifies how HULFT handles shift codes when HULFT sends data to a host that does not use shift codes.
<Table> Setting Values for Shiftcode Mode
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| Cut | C | Cut shift codes from data |
| Space | S | Replace with space code |
2. Additional information other than Send Management Information
This additional information is displayed together with the Send Management Information on each screen where you edit Transfer definitions. You can view and modify this information on screens in HULFT-HUB Manager.
This field shows the host name of the client on which the Send Management Information is registered.
| [Remarks] | You can view this field only on the Transfer Information screen (cannot be modified). |
This field specifies the alias for the file to be sent.
It is recommended that you assign a unique name in the Send 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 Send 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 Send 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. Replacement message
You can replace variables with the messages that you specify when issuing the Send File or with received messages, by specifying the variables from '&MSG0' to '&MSG5' in the following fields (Message Transmission function):
| - File Name | |
| - Pre-send Job ID | |
| - Successful Job ID | |
| - Format ID | |
| - Multi Format ID | |
| - Interface DBID | |
| - Transfer Group 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. |