Multi Format Information
The Multi Format Information stores the definition records of various data formatting in a Send file. You can specify a maximum of 20 Format IDs and their associated keywords per record of the Multi Format Information.
Besides, you can specify the default format ID, which HULFT can use for the data that is not associated with any keywords. There are two ways to register records in the information.
-
Registration using the Management Console
->Refer to Creating and editing a record of the Multi Format Information
-
Registration using parameter file and command
->Refer to Registering and updating a record in management information.
(1) Fields
The table below carries the values and optional statuses for the registration using the Management Console. The optional statuses for the registration using parameter file and command may differ from those for the registration using the Management Console. For the detail on optional statuses for the registration using parameter file and command, refer to Registering and updating a record in management information.
|
Field Name |
Default Value |
Valid Values |
Optional |
Remarks |
|
|---|---|---|---|---|---|
|
Screen |
File |
||||
|
Multi Format ID |
MFMT |
|
Alphanumeric characters |
|
Within 50 bytes starting with an alphabetic letter |
|
Key Start Position |
KEYSTART |
1 |
from 1 to 19997 |
|
|
|
Key Length |
KEYLEN |
|
from 1 to 20 |
|
|
|
Default Format ID |
DFMTID |
|
Alphanumeric characters |
✔ |
Within 50 bytes starting with an alphabetic letter |
|
Key Value |
MFORMAT DEF |
|
Alphanumeric characters |
|
Within 20 bytes |
|
Format ID |
|
Alphanumeric characters |
|
Within 50 bytes starting with an alphabetic letter |
|
|
Comment |
COMMENT |
|
Characters |
✔ |
Within 60 bytes |
|
✔ |
: |
Optional |
|
Blank |
: |
Mandatory |
|
*1 |
: |
You can register a string "DEFEND" as a value for Key Value on the HULFT Management Console. However, you cannot register a string "DEFEND" as a value for the Key Value when you use the Management Information Batch Registration command (UTLIUPDT), because the string is a reserved word in the command. |
(2) Explanations of each field
This section explains the fields to be specified in a record of the Multi Format Information. A string within brackets () is the tag of a field name to be specified when you use a parameter file to register the information.
- Multi Format ID (MFMT)
-
The ID to identify the registered definition record of multiple formatting
This ID is used as a multi format ID in the Send Management Information.
- Key Start Position (KEYSTART)
-
Start position of a keyword, which is set per record
The sum of Key Start Position and Key Length must not exceed "19998".
When you set the Key Start Positions outside the range of the area that is specified by the Format ID that is used in a record of the Multi Format Information, the Key Value is not correctly applied.
- Key Length (KEYLEN)
-
Length of the keyword to be set per record
- Default Format ID (DFMTID)
-
This field specifies the format ID which HULFT uses by default for data that does not match any key.
If you specify the Default Format ID beforehand, HULFT applies the formatting specified by the Default Format ID, when the data is not associated with any of the keys that are registered in a record of the Multi Format Information. If you do not specify this parameter, HULFT gives a conversion error when the data is not associated with any of the keywords.
- Key Value
-
A keyword to associate with the Format ID
Specify alphanumeric characters of the same length as that of the Key Length.
Specify one of the following for the field type in the area where you set the Key Value:
- X :
-
Character
- M :
-
Variable-length Characters
- Format ID
-
Format ID to be used when HULFT detects the string that is specified for the Key Value
Specify the Format IDs that are registered in the Format Information. Each keyword that is specified for the Key Value requires an individual Format ID. HULFT identifies the Format ID to be used by the keyword specified for the Key Value, and applies the formatting that is specified by the Format ID to data.
- Comment (COMMENT)
-
Comment on the multi format
(3) Points to be noted on the settings
Case where Key Value is not correctly applied
The Key Start Position shifts when the data of which Field Type of the Format Information is "P" (Signed Internal Decimal) or "S" (Signed External Decimal) comes before the Key Start Position. Such misalignment prevents a correct value from being applied to the Key Value.
Starting position of formatting
When HULFT applies the formatting that is specified in the Format Information to the data that is associated with the Key Value, the application starts formatting the data from the first byte, regardless of the value that is set for the Key Start Position.
Handling of Key Value
In the Format Information, register the record in which the formatting of the string that is specified for the Key Value is defined.
Record Length
When the lengths of the data to be formatted that are specified by Format IDs (Including Default Format ID) vary, a record length in a Send file must be longer than the maximum data length of the data to be formatted.