439 lines
15 KiB
HTML
439 lines
15 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Display File Field Description (DSPFFD)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="DSPFFD.Top_Of_Page"></a>
|
|
<h2>Display File Field Description (DSPFFD)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#DSPFFD.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPFFD.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPFFD.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPFFD"></a>
|
|
<p>The Display File Field Description (DSPFFD) command shows, prints, or places in a database file field-level information for one or more files in a specific library or all the libraries to which the user has access.
|
|
</p>
|
|
<p>If the information is put in a database file, the database file will have a record format named QWHDRFFD. The fields in record format QWHDRFFD are the same as the fields in the IBM-supplied format QWHDRFFD in file QADSPFFD in the library QSYS. The following information is contained in the database file:
|
|
</p>
|
|
<ul>
|
|
<li>For each file specified in the command, the database record contains:
|
|
<ul>
|
|
<li>The name of the file, the name of the library containing the file, the file type, and file member
|
|
</li>
|
|
<li>The file creation date and the number of record formats in the file
|
|
</li>
|
|
<li>The name of the record format used by the file, the format level identifier, the format text description, the format record length, and the number of fields in the format
|
|
</li>
|
|
<li>The information retrieval date and time
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>For each field in the record format, the record also contains the following, if applicable:
|
|
<ul>
|
|
<li>The field name and external field name
|
|
</li>
|
|
<li>The type and length of the field
|
|
</li>
|
|
<li>For fields referencing other fields, the name of the referenced file, record format, and field; if any attributes of the referenced field were changed, the attribute type is given
|
|
</li>
|
|
<li>The edit code, edit word, and column headings associated with the field
|
|
</li>
|
|
<li>A signal of whether validity checking is performed on the field
|
|
</li>
|
|
<li>The validity check message identifier, the message file, and the library
|
|
</li>
|
|
<li>The use of the field
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p>To create an OUTFILE, the user must have object operational authority to the Create Physical File (CRTPF) command and add authority to the library. To use an existing OUTFILE, the user must have object operational and add authority to the file. The user must also have object management and delete authority if *REPLACE is specified on the OUTMBR parameter.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>Before users can display each file specified, they must have object operational authority for the file.
|
|
</li>
|
|
<li>Also, of the libraries specified by the library qualifier, only the libraries for which the user has read authority are searched.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPFFD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPFFD.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPFFD.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">File</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File</td>
|
|
<td valign="top"><i>Generic name, name</i>, *ALL</td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB, *USRLIBL, *ALLUSR, *ALL</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#DSPFFD.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT, *OUTFILE</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPFFD.OUTFILE"><b>OUTFILE</b></a></td>
|
|
<td valign="top">File to receive output</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File to receive output</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPFFD.OUTMBR"><b>OUTMBR</b></a></td>
|
|
<td valign="top">Output member options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Member to receive output</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Replace or add records</td>
|
|
<td valign="top">
|
|
<b><u>*REPLACE</u></b>, *ADD</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPFFD.SYSTEM"><b>SYSTEM</b></a></td>
|
|
<td valign="top">System</td>
|
|
<td valign="top"><b><u>*LCL</u></b>, *RMT, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPFFD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPFFD.FILE"></a>
|
|
<h3>File (FILE)</h3>
|
|
<p>Specifies the name and library of the files.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>The possible values for file names are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>file-name</i></b></dt>
|
|
<dd>Specify the full name of a file. Only information for the specified file is returned.
|
|
</dd>
|
|
<dt><b><i>generic*-file-name</i></b></dt>
|
|
<dd>Specify a generic name. Information is provided for all files whose names begin with the specified characters.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All files in the library or libraries have their information shown.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*USRLIBL</b></dt>
|
|
<dd>If a current library entry exists in the library list for the current thread, the current library and the libraries in the user portion of the library list are searched. If there is no current library entry, only the libraries in the user portion of the library list are searched.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALLUSR</b></dt>
|
|
<dd>All user libraries are searched. All libraries with names that do not begin with the letter Q are searched except for the following:
|
|
<p>
|
|
<pre>
|
|
#CGULIB #DSULIB #SEULIB
|
|
#COBLIB #RPGLIB
|
|
#DFULIB #SDALIB
|
|
</pre>
|
|
</p>
|
|
<p>Although the following Qxxx libraries are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are considered user libraries and are also searched:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
QDSNX QRCLxxxxx QUSRIJS QUSRVxRxMx
|
|
QGPL QSRVAGT QUSRINFSKR
|
|
QGPL38 QSYS2 QUSRNOTES
|
|
QMGTC QSYS2xxxxx QUSROND
|
|
QMGTC2 QS36F QUSRPOSGS
|
|
QMPGDATA QUSER38 QUSRPOSSA
|
|
QMQMDATA QUSRADSM QUSRPYMSVR
|
|
QMQMPROC QUSRBRM QUSRRDARS
|
|
QPFRDATA QUSRDIRCL QUSRSYS
|
|
QRCL QUSRDIRDB QUSRVI
|
|
</pre>
|
|
</p>
|
|
<ol>
|
|
<li>'xxxxx' is the number of a primary auxiliary storage pool (ASP).
|
|
</li>
|
|
<li>A different library name, in the format QUSRVxRxMx, can be created by the user for each previous release supported by IBM to contain any user commands to be compiled in a CL program for the previous release. For the QUSRVxRxMx user library, VxRxMx is the version, release, and modification level of a previous release that IBM continues to support.
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All libraries in the system, including QSYS, are searched.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPFFD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPFFD.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*OUTFILE</b></dt>
|
|
<dd>The output is directed to the database output file specified on the <b>File to receive output</b> prompt (OUTFILE parameter).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPFFD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPFFD.OUTFILE"></a>
|
|
<h3>File to receive output (OUTFILE)</h3>
|
|
<p>Specifies the name and library of the database output file to which the output of the command is directed. If the file does not exist, this command creates a database output file in the specified library.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the file. If no current entry exists in the library list, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library where the file is located.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>The outfile format must be the same as QWHDRFFD of system file QADSPFFD. For more information on the outfile format, refer to Database information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter book.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPFFD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPFFD.OUTMBR"></a>
|
|
<h3>Output member options (OUTMBR)</h3>
|
|
<p>Specifies the name of the database file member that receives the output of the command.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member in the file receives the output. If no members exist in the file, the system creates a member with the name of the file specified in the <b>File to receive output</b> prompt (OUTFILE parameter).
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of the file member that receives the output. If the name does not exist, the system creates it.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible values for how information is stored are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
|
<dd>The output data replaces any existing records in the specified file member.
|
|
</dd>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>The output data is added to the end of existing records in the specified file member.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPFFD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPFFD.SYSTEM"></a>
|
|
<h3>System (SYSTEM)</h3>
|
|
<p>Specifies whether the information that is returned is about files on the local system or files on remote systems.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LCL</u></b></dt>
|
|
<dd>The information returned is about local files only.
|
|
</dd>
|
|
<dt><b>*RMT</b></dt>
|
|
<dd>The information returned is about remote files only.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The information returned is about both local and remote files.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPFFD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPFFD.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Displaying Information About a File on the Local System</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPFFD FILE(LIB1/FILE2)
|
|
</pre>
|
|
</p>
|
|
<p>This command shows the field-level information about file FILE2 in LIB1 on the local system. The information is shown at the work station where the command was entered.
|
|
</p>
|
|
<p><b>Example 2: Displaying Information About Files on the Local and Remote Systems</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPFFD FILE(*ALL/*ALL) SYSTEM(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command shows the field-level information of all files in all libraries authorized to the user on the local system and on all remote systems. For distributed data management files, the display shows only information about the remote file that is named on the RMTFILE parameter of the CRTDDMF command. The information is shown at the work station where the command was entered.
|
|
</p>
|
|
<p><b>Example 3: Directing Output to a Database File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPFFD FILE(QGPL/FLDREF) OUTPUT(*OUTFILE)
|
|
OUTFILE(QGPL/FLDREFX)
|
|
</pre>
|
|
</p>
|
|
<p>This command puts the field-level information for the file FLDREF in the QGPL library on the local system into a database file named FLDREFX in the general purpose library, QGPL. The FLDREFX file in the QGPL library can then be processed by a program.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPFFD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPFFD.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF3012</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF3014</b></dt>
|
|
<dd>No file specified as &1 in &2 can be displayed.
|
|
</dd>
|
|
<dt><b>CPF3024</b></dt>
|
|
<dd>File &1 not allowed for SYSTEM(&3).
|
|
</dd>
|
|
<dt><b>CPF3052</b></dt>
|
|
<dd>Description for file &1 not available.
|
|
</dd>
|
|
<dt><b>CPF3061</b></dt>
|
|
<dd>Record format &3 not found for outfile &1.
|
|
</dd>
|
|
<dt><b>CPF3063</b></dt>
|
|
<dd>Output file &1 in &2 not physical file.
|
|
</dd>
|
|
<dt><b>CPF3064</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF3066</b></dt>
|
|
<dd>Error creating output file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF3067</b></dt>
|
|
<dd>Error while opening file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF3068</b></dt>
|
|
<dd>Error while writing to file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF3069</b></dt>
|
|
<dd>Error while closing file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF3070</b></dt>
|
|
<dd>Error creating member &3 in file &1.
|
|
</dd>
|
|
<dt><b>CPF3072</b></dt>
|
|
<dd>File &1 in &2 is a system file.
|
|
</dd>
|
|
<dt><b>CPF3074</b></dt>
|
|
<dd>Not authorized to library &1.
|
|
</dd>
|
|
<dt><b>CPF3075</b></dt>
|
|
<dd>Library &1 not available.
|
|
</dd>
|
|
<dt><b>CPF3076</b></dt>
|
|
<dd>Error occurred when on display.
|
|
</dd>
|
|
<dt><b>CPF3077</b></dt>
|
|
<dd>Error occurred when canceling display.
|
|
</dd>
|
|
<dt><b>CPF3084</b></dt>
|
|
<dd>Error clearing member &3 in file &1.
|
|
</dd>
|
|
<dt><b>CPF326B</b></dt>
|
|
<dd>Damage to file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9851</b></dt>
|
|
<dd>Overflow value for file &1 in &2 too small.
|
|
</dd>
|
|
<dt><b>CPF9852</b></dt>
|
|
<dd>Page size too narrow for file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF9899</b></dt>
|
|
<dd>Error occurred during processing of command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPFFD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|