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 | Uppercase alphanumeric characters | Mandatory | Within 8 bytes | Outside the panel | ✓ | |
| A2 | File Name | Alphanumeric characters | Mandatory | Within 200 bytes | Basic Settings | ✓ | |
| A3 | Transfer Type | TEXT | *1 | Mandatory | Basic Settings | ✓ | |
| A4 | Compression Preference *5 | None | *1 | Mandatory | Basic Settings | ✓ | |
| A5 | Code Conversion | Sending Host | *1 | Mandatory | Basic Settings | ✓ | |
| A6 | Compression Unit | 0, from 1 to 32760 | Optional | Unit: byte | Basic Settings | ✓ | |
| A7 | Pre-send Job ID | Alphanumeric characters | Optional | Within 8 bytes | Basic Settings | ✓ | |
| A8 | Successful Job ID | Alphanumeric characters | Optional | Within 8 bytes | Basic Settings | ✓ | |
| A9 | Unsuccessful Job ID | Alphanumeric characters | Optional | Within 8 bytes | Basic Settings | ✓ | |
| A10 | Format/Multi Format ID | Alphanumeric characters | Optional | Within 8 bytes *2 | Basic Settings | ✓ | |
| A11 | Interface DBID | Alphanumeric characters | Optional | Within 8 bytes *2 | Basic Settings | ✓ | |
| A12 | Transfer Group ID | *3 | Alphanumeric characters | Optional | Within 8 bytes | Outside the panel | ✓ |
| A13 | Comment | Alphanumeric characters | Optional | Within 60 bytes | Outside the panel | ✓ | |
| A14 | Transfer Interval | 0 | From 0 to 32760 | Mandatory | Unit: msec | Extension Settings | ✓ |
| A15 | Send File Mode | Keep | *1 | Mandatory | Extension Settings | ✓ | |
| A16 | Transfer Block Length | 4096 | From 128 to 65520 | Mandatory | Unit: byte | Extension Settings | ✓ |
| A17 | Transfer Block Count | 3 | From 1 to 99 | Mandatory | Extension Settings | ✓ | |
| A18 | Transfer Priority | 50 | From 1 to 256 | Mandatory | Extension Settings | ✓ | |
| A19 | Interfacing with Exchanger | No (*4) | *1 | Optional | Extension Settings | ✓ | |
| A20 | EBCDIC Code Set | Kana | *1 | Mandatory | Extension Settings | ✓ | |
| A21 | Cipher Key | Alphanumeric characters | Optional | From 8 to 20 bytes | Extension Settings | ✓ | |
| A22 | Shiftcode Mode | Add | *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 default value of the field is automatically set. |
| *4: | The check box is not selected. |
| *5: | The field name is 'Compression Level' in the Send Management Information for the client. |
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 | 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 | Alphanumeric characters | *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 Send file that is stored on UNIX.
Specify the absolute path. You can omit this field if you have selected the Interfacing with Exchanger check box.
You can specify the name of a file that uses network resources only in HULFT7 for UNIX/Linux-EX.
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 |
This field specifies whether HULFT carries out compression when the file is transferred.
<Table> Setting Values for Compression Preference
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| None | N | No compression |
| Horizontal | 1 | Compression within each record |
| Vertical | 2 | Compression across records |
| [Remarks] | The field name is 'Compression Level' in the Send Management Information for the client. |
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 record processing units when binary files are compressed.
You cannot omit this field if you specify 'BINARY' (B) for the Transfer Type and anything other than 'None' (N) for the Compression Preference.
Processing is carried out faster for larger setting values. (However, more memory is used.)
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 (UNIX/Linux).
If you omit this field, HULFT does not start the job.
You cannot specify this field if you have selected the Interfacing with Exchanger check box.
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 (UNIX/Linux).
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 (UNIX/Linux).
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 (UNIX/Linux).
For details about the multi format ID, refer to Multi Format Information (UNIX/Linux).
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 files 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.
In addition, you can interface with the 'DB Interface Option' by specifying the database ID (up to 8 alphanumeric characters, starting with an alphabetic character) for loading sent data into a UNIX, Linux, Nonstop, or Windows database. You cannot use 'CSV' or 'XML' for the database ID.
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 (UNIX/Linux).
| [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.
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 starting file transfer.
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 this specification is omitted in the CSV file for Collecting and Distributing System Management Information, HULFT-HUB sets '50.'
(A19) Interfacing with Exchanger
This field specifies the interface between the Send system and HULFT Exchanger Option.
<Table> Setting Values for Interfacing with Exchanger
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| Check box selected | Y | Interface with Exchanger |
| Check box not selected | N (default value) | Do not interface with Exchanger |
This is related to interfacing with HULFT Exchanger to carry out the Send processing and the Receive processing. For details about HULFT Exchanger interfacing, refer to the manual for HULFT Exchanger Option.
This field specifies the EBCDIC code system (encoding code scheme) that is used for conversion from ASCII to EBCDIC.
<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 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 whether to add shift codes when HULFT carries out code conversion.
<Table> Setting Values for Shiftcode Mode
| On-screen Options |
Values in CSV File |
Description |
|---|---|---|
| Add | Y | Add shift codes |
| Do Not Add | N | Do not add shift codes |
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.
| [Note] | You cannot view this additional information on the Management screen on the client (HULFT) side. |
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 to which this Send Management Information belongs.
| [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. |