203 lines
7.0 KiB
HTML
203 lines
7.0 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 Physical File Member (DSPPFM)</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="DSPPFM.Top_Of_Page"></a>
|
|
<h2>Display Physical File Member (DSPPFM)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#DSPPFM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPPFM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPPFM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPPFM"></a>
|
|
<p>The Display Physical File Member (DSPPFM) command displays a physical database file member. Records are shown in arrival sequence, even if the file has a keyed access path. You can page through the file, locate a particular record by record number, or specify a starting position in the record. You can also select a character or hexadecimal display of the records.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPPFM.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="#DSPPFM.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>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"><a href="#DSPPFM.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">Member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b>, *LAST</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPFM.FROMRCD"><b>FROMRCD</b></a></td>
|
|
<td valign="top">From record</td>
|
|
<td valign="top"><i>Unsigned integer</i>, <b><u>1</u></b>, *END, *ALLDATA</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPPFM.FILE"></a>
|
|
<h3>File (FILE)</h3>
|
|
<p>Specifies the name and library of the physical file containing the member to be displayed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<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 used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</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="#DSPPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFM.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the name of the file member displayed.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*FIRST</b></dt>
|
|
<dd>The first member of the specified physical file is displayed.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The last member of the specified physical file is displayed.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of the file member.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPFM.FROMRCD"></a>
|
|
<h3>From record (FROMRCD)</h3>
|
|
<p>Specifies which record in a physical file is shown on the top line of the initial display. If the specified record number is a deleted record, the display is positioned on the first record that follows the record that has been deleted. You can display as many records as needed using the page-up and page-down keys.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>1</u></b></dt>
|
|
<dd>Record number one, or the first non-deleted record, of the physical file is shown. If the file is a distributed file, this will be the first non-deleted record of the local member, and only local data will be shown.
|
|
</dd>
|
|
<dt><b>*END</b></dt>
|
|
<dd>The last non-deleted record in the physical file is shown. The *END value shows the last complete page so that the last record in the physical file appears at the bottom of the screen. If the file is a distributed file, this will be the last non-deleted record of the local member, and only local data will be shown.
|
|
</dd>
|
|
<dt><b>*ALLDATA</b></dt>
|
|
<dd>All the data for a distributed file, including remote data, is shown. If *ALLDATA is specified for a non-distributed file, it will be treated the same as FROMRCD(1).
|
|
</dd>
|
|
<dt><b><i>record-number</i></b></dt>
|
|
<dd>Specify the number of the record shown on the top line of the initial display. If the file is a distributed file, this will be the record number of the local member, and only local data will be shown.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPFM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Displaying the First File Member</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPFM FILE(TESTA)
|
|
</pre>
|
|
</p>
|
|
<p>This command shows the first member of a physical file named TESTA. The library list is used to locate the file.
|
|
</p>
|
|
<p><b>Example 2: Displaying a File Member</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPFM FILE(SAMPLE/TESTB) MBR(PROGRAM)
|
|
</pre>
|
|
</p>
|
|
<p>This command shows member PROGRAM of physical file TESTB in library SAMPLE.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPFM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF8056</b></dt>
|
|
<dd>File &1 in &2 not a physical file.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9812</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9822</b></dt>
|
|
<dd>Not authorized to file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9846</b></dt>
|
|
<dd>Error while processing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|