DISPLAY FILE command

Summary

Privileges

Any user (only the file manager can display certain file information)

Function

Displays information about a Model 204 file

Syntax

DISPLAY FILE [(display-option [,display-option]...)] {ALL | filename [,filename]...}

Where:

display-option

is one of the options listed below: Option Displays... DEFINITIONS File name, the values of the file parameters, the names of the file parameters, and the names of the file data sets; this is the default. Specifying DEFINITIONS is equivalent to specifying FPARMS, TABLES, and DDNAMES. FPARMS File characteristic parameters and the names of the sort or hash key field, if the privilege-controlling bit is set to 1 (PRIVDEF parameter). If you are a file manager, FPARMS also displays the record security field. TABLES File table parameters. DDNAMES Names of the data sets that make up the file, if you are a file manager. ABBREV File name and/or the values of the file parameters in abbreviated format. ABBREV can be specified with DEFINITIONS, FPARMS, or TABLES. Specifying ABBREV by itself is equivalent to specifying ABBREV with DEFINITIONS. NOUSE File output on your terminal even if a USE command precedes the DISPLAY. Any alternate device remains open, but is not used.

filename

The name of an existing Model 204 file.

Syntax notes

ABBREV can be specified in conjunction with DEFINITIONS, FPARMS, or TABLE, but not DDNAMES. NOUSE can be combined with any of the DISPLAY options.

Display options must be enclosed in parentheses and separated by commas or by one or more blanks.

Example

DISPLAY FILE (DDNAMES) CENSUS CENSUS DDNAMES: CENSUS CENSUS1 CENSUS2

Note: A file cannot be created unless the first DDNAME is equal to the filename.

Usage notes

The DISPLAY FILE command displays information on one or more open Model 204 files. This information includes the value of file parameters and the names of the data sets that make up the files. Model 204 lists information about the specified files, or, if ALL is specified, about all of the user's open files. File information is listed in the format specified by the DISPLAY options.

All the files specified in the command must be open at the time that you issue the command. Files that are not open are not listed. An error message is generated by use of the DISPLAY FILE command without the correct privilege.