List of Multi Format Information fields

You can register up to 20 keys, the Format IDs, and the Default Format ID in the information. For the registration method, refer to Using the Multi Format Information.

Field List

Table 4.82 List of Multi Format Information Fields
Field Name	Setting Value	Optional	Remarks
Multi Format ID	Alphanumeric characters and "_"	-	Within 50 bytes starting with an alphabetic character
Comment	Characters	✓	Within 60 bytes (*1)
Default Format ID	Alphanumeric characters	✓	Within 50 bytes starting with an alphabetic character
Key Start Position	1–19997	-
Key Length	1–20	-
Key Value	Alphanumeric characters	-	Within 20 bytes
Format ID	Alphanumeric characters and "_"	-	Within 50 bytes starting with an alphabetic character

✓	:	Optional
-	:	Mandatory

On the HULFT Manager Management Console, you can enter a string of up to 60 characters. When the destination host is HULFT Ver.8.1 or higher, the size of the string that you entered will be checked based on the code set that is set in HULFT at the connection destination. When HULFT checks and confirms that the size of the string meets the condition that is given in the remarks, the characters that you entered will be saved in HULFT.

Explanation of each field

This section explains the fields to be specified in the Multi Format Information.

Multi Format ID

ID to identify the registered multi format information

This multi format ID is associated with Multi Format ID in the Send Management Information.

Comment

Comment for the formats

Default Format ID

Specify the default format ID when the registered key is inconsistent with the key in the data.

When this is specified, the format of Default Format ID will be set when the key in the data does not match the key registered in the Multi Format Information. If omitted, a conversion error will occur when the key in the file does not match with any key registered.

Key Start Position

Key start position to be set per record

The sum of the values set for Key Start Position and Key Length cannot exceed '19998.'

When you set a value that is greater than the length of a record of the Format Information for Key Start Position, the key value is not correctly applied.

Key Length

Length of the key to be set per record

Key Value

Key to be set in each record

Specify alphanumeric characters of the same length as that of the key length.

Specify one of the following values for Field Type in the area where you set the key value:

X:: Character
M:: Variable-length Characters

Format ID

Format ID used when the keys match

Specify the format ID that is registered in the Format Information. It is necessary to register as many format IDs as the number of key values. HULFT identifies the format ID based on the key value and applies the format to the data.

Points to be noted when configuring settings

When the key value is not correctly applied

The correct key value might not be applied when you place the following fields before Key Start Position. This is because such a setting causes a misalignment with the key start position.

P (Signed Internal Decimal)
S (Signed External Decimal)

Starting position of the format

When you apply the Format Information that matches the key value, HULFT starts applying the information from the first byte in the record, regardless of the key start position.

Handling of key value

As for the Format Information that is to be registered in format management information, register the format including Key Value.

Record Length

When the format lengths specified in the Format Information (including the default format ID) are different, the Send file record length must be more than the maximum format length.

Comment

Even if double-byte characters that are registered in Comment can be displayed on the HULFT Manager Management Console, the characters may not be displayed correctly on the HULFT Management Console for HULFT10 for IBMi.