DF Command - Display File

Use the DF command to display the status of one or more files. Files can be selected using the optional operands. If a file sequence range is specified, seq1 must be not greater than seq2.
spool
Use the DF command to display the status of one or more files. Files can be selected using the optional operands. If a file sequence range is specified,
seq1
must be not greater than
seq2
.
This command has the following format:
DF[file_sequence_number | seq1-seq2] [,O=] [,D=] [,Q=] [,F=] [,C=] [,FQE] [,NOESTAT] [,NUM=] [,REL=] [,TOTAL]
One or more operands can be used. If no operands are specified, the status of all the files in the ESF system is listed.
  • file_sequence_number
    Defines the sequence number of the requested release file.
  • seq1-seq2
    Defines the sequence range of the files to be released.
  • O=
    Specifies the filename to be used for file selection.
    The filename is a 1 through 8 character alphanumeric string. If an asterisk (*) represents any character, the corresponding position of the filename is considered to match the selection being performed. This enables a generic search.
  • C=
    Specifies the FCB name to be used for file selection. The FCB name is an alphanumeric string with one to four characters.
  • D=
    Specifies the file destination name to be used for file selection. The destination name is an alphanumeric string with one to eight characters.
  • F=
    Specifies the form number to be used for file selection. The form number is an alphanumeric string with one to eight characters.
  • FQE
    Replies must be unformatted file queue elements. These elements contain hexadecimal characters that cannot be displayed. This operand is used only from the MENU system.
  • NOESTAT
    Specifies that files with E (end-of-file) status are not displayed.
  • NUM=
    Specifies the number of replies wanted. The operand must be numeric, and in the range 1 through 999999.
  • Q=
    Specifies the output class to be used for file selection. The output class is a single character in the range A-Z or 0-9.
  • REL=
    Specifies the first file to be displayed relative to the first file that satisfies the rest of the operands. For example, if REL=6 is specified, the sixth file that satisfies the rest of the operands is the first to be displayed.
  • TOTAL
    Specifies the total number of files satisfying all operands specified is indicated in the heading of the reply messages.
Examples
This example displays files with filename RTEST001 and file output class P.
DF,O=RTEST001,Q=P
This example displays file with file sequence number 512.
DF512
This example displays files in the range from 19 to 341.
DF19-341
This example displays all files with a filename starting with SYS.
DF,O=SYS*****
This example displays files in the range 15 through 330 with a file name length of 6 or less, positions 3-5 being DPS, in class A.
DF15-330,O=**DPS*.,Q=A
This example displays the first five files in the spool.
DF,NUM=5
This example displays five files starting with the sixth file in the spool.
DF,REL=6,NUM=5