DISPLAY FILE command: Difference between revisions

Revision as of 00:55, 7 March 2013

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.

@@ Line 6: / Line 6: @@
 <dd>Displays information about a <var class="product">Model&nbsp;204</var> file
 </dl>
 ==Syntax==
 <p class="syntax"><b>D</b>ISPLAY FILE [(<i>display-optio</i>n [<i>,display-option</i>]...)]
@@ Line 14: / Line 15: @@
 <table>
 <tr>
-<th>display-option</th>
+<th nowrap>display-option</th>
 <td> is one of the options listed below:
 <table>
@@ Line 51: / Line 52: @@
 <tr>
-<th><var> filename</var></th>
+<th>filename</th>
-<td> is the name of an existing <var class="product">Model&nbsp;204</var> file.</td>
+<td>The name of an existing <var class="product">Model&nbsp;204</var> file.</td>
 </tr>
+  </table>
-</table>
 ===Syntax notes===
-<p>ABBREV can be specified in conjunction with DEFINITIONS, FPARMS, or TABLE, but not DDNAMES. NOUSE can be combined with any of the DISPLAY options.</p>
+<p>
-<p>Display options must be enclosed in parentheses and separated by commas or by one or more blanks.</p>
+ABBREV can be specified in conjunction with DEFINITIONS, FPARMS, or TABLE, but not DDNAMES. NOUSE can be combined with any of the DISPLAY options.</p>
+<p>
+Display options must be enclosed in parentheses and separated by commas or by one or more blanks.</p>
 ==Example==
 <p class="code"><b>DISPLAY FILE (DDNAMES) CENSUS</b>
@@ Line 65: / Line 69: @@
 </p>
 <p class="note"><b>Note:</b> A file cannot be created unless the first DDNAME is equal to the filename.</p>
 ==Usage notes==
-<p>The DISPLAY FILE command displays information on one or more open <var class="product">Model&nbsp;204</var> files. This information includes the value of file parameters and the names of the data sets that make up the files. <var class="product">Model&nbsp;204</var> 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.</p>
+<p>
-<p>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.</p>
+The DISPLAY FILE command displays information on one or more open <var class="product">Model&nbsp;204</var> files. This information includes the value of file parameters and the names of the data sets that make up the files. <var class="product">Model&nbsp;204</var> 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.</p>
+<p>
+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.</p>
 [[Category: File manager commands]]
 [[Category: General user commands]]
 [[Category:Commands]]