166 lines
5.9 KiB
HTML
166 lines
5.9 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 Optical File (DSPOFRDAR)</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="DSPOFRDAR.Top_Of_Page"></a>
|
|
<h2>Display Optical File (DSPOFRDAR)</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="#DSPOFRDAR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPOFRDAR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPOFRDAR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPOFRDAR"></a>
|
|
<p>The Display Optical File (DSPOFRDAR) Command displays the contents of an optical file. The file may be a physical or logical optical file. The data is displayed in the sequence specified by the access path for the file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPOFRDAR.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="#DSPOFRDAR.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Optical 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: Optical 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="#DSPOFRDAR.NBRRCDS"><b>NBRRCDS</b></a></td>
|
|
<td valign="top">Number of records</td>
|
|
<td valign="top"><i>Decimal number</i>, <b><u>100</u></b>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPOFRDAR.FROMRCD"><b>FROMRCD</b></a></td>
|
|
<td valign="top">From record</td>
|
|
<td valign="top"><i>Decimal number</i>, <b><u>1</u></b>, *END</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPOFRDAR.FILE"></a>
|
|
<h3>Optical file (FILE)</h3>
|
|
<p>Specifies the name of the optical file whose contents is to be displayed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Optical file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the optical file to be displayed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is where the file is located. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the optical file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPOFRDAR.NBRRCDS"></a>
|
|
<h3>Number of records (NBRRCDS)</h3>
|
|
<p>Specifies the maximum number of records you want to display. Because optical files may contain millions of records, you may want to limit the number of records to save time. All of the records are copied to a temporary database file before they are displayed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>100</u></b></dt>
|
|
<dd>The first 100 records in the optical file are copied to the temporary database file.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All of the records in the optical file are copied to the temporary database file.
|
|
</dd>
|
|
<dt><b><i>number-of-records</i></b></dt>
|
|
<dd>Specify the number of records to copy to the temporary database file. Valid values range from 1 through 99999999999.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPOFRDAR.FROMRCD"></a>
|
|
<h3>From record (FROMRCD)</h3>
|
|
<p>Specifies which record in an optical file is shown on the top line of the initial display. This value must be between 1 and the value specified for the Number of records (NBRRCDS) parameter. You can display other records within the range of records specified by the NBRRCDS parameter using the page-up and page-down keys.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>1</u></b></dt>
|
|
<dd>Record number one in the optical file is shown.
|
|
</dd>
|
|
<dt><b>*END</b></dt>
|
|
<dd>The last record (as specified by the NBRRCDS parameter) is shown. The *END value shows the last complete page so that the last record in the optical file appears at the bottom of the display.
|
|
</dd>
|
|
<dt><b><i>record-number</i></b></dt>
|
|
<dd>Specify the number of the record to show on the top line of the initial display.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="DSPOFRDAR.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPOFRDAR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>RDR5402</b></dt>
|
|
<dd>Unable to display description for Optical File &1 in &2.
|
|
</dd>
|
|
<dt><b>RDR5405</b></dt>
|
|
<dd>Unable to display contents of Optical File &1 in &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|