Format Information
This topic explains how to register the format for the file to be sent.
You can view and modify this information on the following screens:
- Register Format Information/Modify Format Information Record 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
| [Note] | For versions lower than HULFT-HUB Server Ver.3.9, if the client is HULFT Ver.8.4 or higher and the Forced Strong Key Mode is set to 'Enabled' in the System Environment Settings, connection with the client is not supported. Therefore, it is not possible to view, update, or newly register the management information for that client. |
List of Fields
1. Format Information
<Table> List of Fields for Format Information
| No. | Field Name | Default Value | Setting Value | Specification | Remarks | Update | Distribute |
|---|---|---|---|---|---|---|---|
| A1 | Format ID | Alphanumeric characters and "_" *1 | Mandatory | Within 50 bytes | ✓ | ✓ | |
| A2 | Field Name | Alphanumeric characters | Mandatory | Within 16 bytes | ✓ | ✓ | |
| A3 | Start Position | *2 | From 1 to 9999 | Optional | ✓ | ✓ | |
| A4 | Byte Count | From 1 to 9999 | Mandatory | ✓ | ✓ | ||
| A5 | Decimal Places | From 0 to 9 | Optional | ✓ | ✓ | ||
| A6 | Field Type | *3 | Mandatory | ✓ | ✓ | ||
| A7 | Comment | Half-width characters *4 | Optional | Within 60 bytes | ✓ | ✓ |
| *1: | If the Controlling Server is HULFT-HUB Server that is lower than Ver.3.10, you cannot use "_". |
| *2: | This value is achieved by adding the byte count to the start position of the previous field. |
| *3: | When you configure settings on the screen, select an option from the list that is shown on the screen. |
| *4: | You cannot specify lowercase alphabetic characters. |
2. Additional information other than Format Information
You can view both the Format Information and the following additional information on each screen where you edit Transfer definitions.
<Table> List of Fields for Additional Information other than Format Information
| No. | Field Name | Default Value | Setting Value | Specification | Remarks | Update | Distribute |
|---|---|---|---|---|---|---|---|
| B1 | Alias | Alphanumeric characters | Optional | Within 256 bytes | ✓ | ✓ | |
| B2 | Business Group ID | *1 | Mandatory | ✓ | ✓ | ||
| B3 | Batch Distribution ID | Alphanumeric characters | *2 | - | ✓ |
| *1: | When you configure settings on the screen, select an option from the list that is shown on the screen. |
| *2: | You are allowed only to view this field 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 |
| Update | Register Format Information/Modify Format Information Record 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 Format Information. You must register the data from the Field Name to the Field Type as one group of information. You can register up to 1000 groups.
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. Format Information
This field specifies the ID to identify the registered format.
This Format ID is associated with the Format ID in the Send Management Information and with the Format ID in the Multi Format Information.
This field specifies the name to identify a field.
HULFT does not accept duplicate field names for one format ID.
This field specifies the start position for the relevant field.
Specify the start position for the field (how many bytes from the beginning of the record).
If you omit the Start Position, HULFT-HUB automatically calculates this value by adding the byte count to the start position of the previous field.
If the value for the Start Position that is automatically calculated exceeds 9999, the record is not registered.
This field specifies the byte count for the relevant field.
This field specifies the number of decimal places for the relevant field.
Specify the number of decimal places for numeric value data in the field, if applicable.
This field specifies the data type for the relevant field.
<Table> Setting Values for Field Type
| On-screen Options |
Values in CSV File |
Size (bytes) |
Description of Field |
|---|---|---|---|
| X: Character | X | From 1 to 9999 |
This is the character data format for single byte codes only. It must not include double byte codes. |
| N: Double-byte Graphic Characters | N | From 2 to 9998 |
This is the character data format for double byte codes only. It must not include single byte codes. Only an even number of bytes are available. For Type-EBCDIC Code Set, use this option when a double byte code is not enclosed within shift codes. |
| M: Variable-length Characters | M | From 1 to 9999 |
This is the character data format with a mixture of single byte codes and double byte codes. For Type-EBCDIC Code Set, it is necessary for a double byte code to be enclosed within shift codes. |
| B: Binary | B | 2, 4, 8 |
This is the numeric data format for signed integers. |
| F: Floating Point | F | 4, 8 |
This is the signed floating point data format. Mainframe supports the IBM format; other host types support the floating decimal format of IEEE. |
| 9: Unsigned External Decimal | 9 | From 1 to 18 |
This is the unsigned decimal data format of zoned numeric data. |
| S: Signed External Decimal | S | From 1 to 18 |
This is the signed decimal data format of zoned numeric data. |
| P: Signed Internal Decimal | P | From 1 to 10 |
This is the signed packed decimal data format. However, this format can handle only up to 18 digits. |
| I: Image (No Conversion) | I | From 1 to 9999 |
This is the data format that indicates no conversion. |
This field specifies the comment for the format.
2. Additional information other than Format Information
This additional information is displayed together with the Format Information on each screen where you edit the Format Information. 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 specifies the alias for the format.
It is recommended that you assign a unique name in the Format Information so that each format ID that is displayed on screens in HULFT-HUB Manager can be easily identified.
This field specifies the Business Group ID that uses this Format Information.
This field shows the Batch Distribution Information ID with which the Format Information is registered as distribution data (cannot be modified).