Format Information Display command

You can view the records that have been registered in the Format Information in a form of list.

Note

Ensure that the CCSID (Coded Character Set Identifier) settings of your emulator (Host Code-Page) and the job that executes this command satisfy one of the following conditions: If your configuration does not meet one of the following, HULFT does not display a list properly.

[Configuration 1]

Complete agreement of CCSID (Coded Character Set Identifier) settings between your emulator and HULFT Character Set in the System Environment Settings file
Setting the CCSID (Coded Character Set Identifier) of the job to 65535

[Configuration 2]

Complete agreement of CCSID (Coded Character Set Identifier) settings between your emulator and HULFT Character Set in the System Environment Settings file
Complete agreement of CCSID (Coded Character Set Identifier) settings between the job and HULFT Character Set in the System Environment Settings file

Program interface

CALL Library name/UTLILIST PARM(['LIB=Library name'] 'I=FMT' 'ID=formatid' 
   ['G'] ['OUTPUT=filename'] ['EXIT' CL variable name])

Explanation of parameters

LIB=Library name

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

I=FMT

Target management information type, which must be set to the Format Information. (Mandatory)

ID=formatid

Target Format ID of the record to be displayed (Mandatory)

Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.

G

Control of error messages that the Format Information Display command outputs (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Format Information Display command outputs (Optional)

Specify this parameter in the format of Library name/File name(Member name).

When omitted, error messages are not output.

The number of log records that a log file can retain is unlimited.

EXIT CL variable name

Specifies to receive the error code output by the Format Information Display command and specifies the CL variable name to set the error code value (Optional)

The CL variable name must be immediately after the EXIT tag.

HULFT sets an error code to the CL variable only if the command ends unsuccessfully.

When omitted, an error code is not set.

Command interface

UTLILIST FILETYPE(FMT formatid) LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

FILETYPE(FMT formatid)

The Format Information (FMT) and the Format ID to be displayed (Mandatory)

Specify formatid as a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.

LIBRARY

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

MSG

Control of error messages ("*YES" by default)

*NO :: Suppress error messages.
*YES :: Show error messages.

FILE

Name of the library and the file to which error messages are output (Optional)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

When omitted, error messages are not output. The number of log records that a log file can retain is unlimited.

MBR

Member name of the file to which error messages are output ("*FILE" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

Output example

Displaying the content for the format ID "FORMAT01"

FMT=FMT0001                                                                
COMMENT=FORMAT PERSONAL DATA                                               
ITEM              START  LENGTH  POINT  TYPE                               
TYPE                 1      1    0      X                                  
NAME                 2     20    0      N                                  
AGE                 22     50    0      X                                  
TEL                 72     13    0      9