Displaying the content of a joined file

The file information within the joined file can be displayed by using the Joined File Display command.

Note

If the name of a member file that constitutes a joined file uses half-width Katakana or a lowercase letter of alphabet, the command converts these characters into EBCDIC Katakana when outputting them.

(1) Joined File Display command

Program interface

CALL Library name/UTLDSPFIL PARM(['LIB=Library name'] 'F=filename' ['D']
   ['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.

F=filename

Joined file name (Mandatory)

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

D

Display of the contents of the Format Information and the Multi Format Information (Optional)

If omitted, the contents of the Format Information and the Multi Format Information are not displayed.

G

Control of error messages that the Joined File Display command outputs (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Joined File 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 Joined File 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

UTLDSPFIL JOINFILE( ) JOINMBR( ) DETAILS( )
   LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

JOINFILE

Library name and file name of the joined file (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.

JOINMBR

Member name of the joined file ("*FILE" by default)

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

DETAILS

Display of the contents of the Format Information and the Multi Format Information ("*NO" by default)

*NO :

Contents of the Format Information and the Multi Format Information are not displayed.

*YES :

Contents of the Format Information and the Multi Format Information are displayed.

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.

(2) Output example

        VERSION  V05L00                                                         
     NO FILE NAME                                                               
        DATE       TIME                                              CODE TYPE  
        DATA SIZE     REC CNT    REC LEN. FILE TYPE             BLOCK SIZE      
      1 HULDLIB/HUL001(TXTDATA)                                                 
        2017/12/29 20:31:00                                          IBM KANJI  
              640           5         128 TEXT                           0      
      2 HULDLIB/HUL002(BINDATA)                                                 
        2017/12/29 20:31:00                                          IBM KANJI  
            40860         454          90 BINARY                         0      
      3 HULDLIB/HUL003(FMTDATA)                                                 
        2017/12/29 20:31:00                                          IBM KANJI  
              640           5         128 FORMAT                         0      
        START  LENGTH  POINT  TYPE                                              
            1       3      0     X                                              
            4     100      0     M                                              
      4 HULDLIB/HUL004(MFTDATA)                                                 
        2017/12/29 20:31:00                                          IBM KANJI  
              640           5         128 MULTI FORMAT                   0      
        KEY START:1          KEY LENGTH:3                                       
        KEY INFORMATION:                                                        
        KEY                      START  LENGTH  POINT  TYPE                     
        (DEFAULT)                                                               
                                     1       3      0     X                     
                                     4     100      0     M                     
        001                                                                     
                                     1       3      0     X                     
                                     4      20      0     N                     
                                    24      20      0     N                     
                                    44      50      0     X                     
        002                                                                     
                                     1       3      0     X                     
                                     4      20      0     N                     
                                    24       8      0     9                     
                                    32      10      0     X                     
                                    42       8      0     9                     
                                    50       3      0     9

= Remarks =

The date format varies depending on a value of the Date Format (DATEFMT) that is specified in the System Environment Settings

For details, refer to Administration Manual.