368 lines
12 KiB
HTML
368 lines
12 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 Spooled File (DSPSPLF)</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="DSPSPLF.Top_Of_Page"></a>
|
|
<h2>Display Spooled File (DSPSPLF)</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="#DSPSPLF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPSPLF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPSPLF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPSPLF"></a>
|
|
<p>The Display Spooled File (DSPSPLF) command shows the data records in the specified spooled file. The current contents of the file (data records) can be displayed any time an entry for the spooled file is on the output queue. The screen provides various functions to display various parts of the file and to scan for a specific character string.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPSPLF.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"><a href="#DSPSPLF.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Spooled file</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#DSPSPLF.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#DSPSPLF.SPLNBR"><b>SPLNBR</b></a></td>
|
|
<td valign="top">Spooled file number</td>
|
|
<td valign="top">1-999999, <b><u>*ONLY</u></b>, *LAST, *ANY</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPSPLF.JOBSYSNAME"><b>JOBSYSNAME</b></a></td>
|
|
<td valign="top">Job system name</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ONLY</u></b>, *CURRENT, *ANY</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPSPLF.CRTDATE"><b>CRTDATE</b></a></td>
|
|
<td valign="top">Spooled file created</td>
|
|
<td valign="top">Single values: <b><u>*ONLY</u></b>, *LAST<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Creation date</td>
|
|
<td valign="top">
|
|
<i>Date</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Creation time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*ONLY</u></b>, *LAST</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPSPLF.FOLD"><b>FOLD</b></a></td>
|
|
<td valign="top">Fold records</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPSPLF.FILE"></a>
|
|
<h3>Spooled file (FILE)</h3>
|
|
<p>Specifies the spooled file which has its records displayed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the file name of the spooled file to be displayed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPSPLF.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the name of the job that created the spooled file whose data records are to be displayed.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The job that issued this command is the job that created the spooled file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Job name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job that created the spooled file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: User</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the user name that identifies the user profile under which the job is run.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 3: Number</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>000000-999999</i></b></dt>
|
|
<dd>Specify the system-assigned job number.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPSPLF.SPLNBR"></a>
|
|
<h3>Spooled file number (SPLNBR)</h3>
|
|
<p>Specifies the number of the job's spooled file that is to be displayed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>Only one spooled file in the job has the specified file name; therefore, the number of the spooled file is not necessary.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The spooled file with the highest number and the specified file name is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ANY</b></dt>
|
|
<dd>The spooled file number is not used to determine which spooled file is used. Use this value when the job system name parameter or the spooled file create date and time parameter is to take precedence over the spooled file number when selecting a spooled file.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>1-999999</i></b></dt>
|
|
<dd>Specify the number of the spooled file having the specified file name whose data records are displayed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPSPLF.JOBSYSNAME"></a>
|
|
<h3>Job system name (JOBSYSNAME)</h3>
|
|
<p>Specifies the system where the job that created the spooled file (JOB parameter) ran. This parameter is considered after the job name, user name, job number, spooled file name, and spooled file number parameter requirements have been met.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and spooled file create date and time.
|
|
</dd>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>The spooled file created on the current system with the specified job name, user name, job number, spooled file name, spooled file number, and create date and time is used.
|
|
</dd>
|
|
<dt><b>*ANY</b></dt>
|
|
<dd>The job system name is not used to determine which spooled file is used. Use this value when the spooled file create date and time parameter is to take precedence over the job system name when selecting a spooled file.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the system where the job that created the spooled file ran.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPSPLF.CRTDATE"></a>
|
|
<h3>Spooled file created (CRTDATE)</h3>
|
|
<p>Specifies the date and time the spooled file was created. This parameter is considered after the job name, user name, job number, spooled file name, spooled file number, and job system name parameter requirements have been met.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and job system name.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The spooled file with the latest create date and time of the specified job name, user name, job number, spooled file name, spooled file number, and job system name is used.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Creation date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>date</i></b></dt>
|
|
<dd>Specify the date the spooled file was created.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Creation time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The spooled file with the latest create time of the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date is used.
|
|
</dd>
|
|
<dt><b><i>time</i></b></dt>
|
|
<dd>Specify the time the spooled file was created.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPSPLF.FOLD"></a>
|
|
<h3>Fold records (FOLD)</h3>
|
|
<p>Specifies whether the first display has the records folded (wrapped) if they are longer than the length of the display line.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The records are not folded. When the length of the record is longer than one line, the remaining positions of the record are not shown.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The initial display shows the first record folded on one or more display lines if it is longer than one line.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPSPLF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
DSPSPLF FILE(QPRINT) JOB(PAYROLL01) SPLNBR(4) FOLD(*NO)
|
|
</pre>
|
|
</p>
|
|
<p>In this example, the spooled file QPRINT is displayed. The file is the fourth file produced by the job PAYROLL01. The record positions that are longer than the length of the display line are truncated on the first display.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPSPLF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2207</b></dt>
|
|
<dd>Not authorized to use object &1 in library &3 type *&2.
|
|
</dd>
|
|
<dt><b>CPF3303</b></dt>
|
|
<dd>File &1 not found in job &5/&4/&3.
|
|
</dd>
|
|
<dt><b>CPF3308</b></dt>
|
|
<dd>Error occurred when trying to display data.
|
|
</dd>
|
|
<dt><b>CPF3309</b></dt>
|
|
<dd>No files named &1 are active.
|
|
</dd>
|
|
<dt><b>CPF3330</b></dt>
|
|
<dd>Necessary resource not available.
|
|
</dd>
|
|
<dt><b>CPF3340</b></dt>
|
|
<dd>More than one file with specified name found in job &5/&4/&3.
|
|
</dd>
|
|
<dt><b>CPF3342</b></dt>
|
|
<dd>Job &5/&4/&3 not found.
|
|
</dd>
|
|
<dt><b>CPF3343</b></dt>
|
|
<dd>Duplicate job names found.
|
|
</dd>
|
|
<dt><b>CPF3344</b></dt>
|
|
<dd>File &1 number &8 no longer in the system.
|
|
</dd>
|
|
<dt><b>CPF3359</b></dt>
|
|
<dd>Not able to display data.
|
|
</dd>
|
|
<dt><b>CPF3386</b></dt>
|
|
<dd>File &1 in &2 not a data base file.
|
|
</dd>
|
|
<dt><b>CPF3387</b></dt>
|
|
<dd>Cannot display data in file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF3394</b></dt>
|
|
<dd>Cannot convert spooled file data.
|
|
</dd>
|
|
<dt><b>CPF33F9</b></dt>
|
|
<dd>Error occurred while displaying file &1 number &6.
|
|
</dd>
|
|
<dt><b>CPF3427</b></dt>
|
|
<dd>Job &5/&4/&3 not interactive job.
|
|
</dd>
|
|
<dt><b>CPF3428</b></dt>
|
|
<dd>DSPSPLF command ended for file &1 number &8.
|
|
</dd>
|
|
<dt><b>CPF3429</b></dt>
|
|
<dd>File &1 number &7 cannot be displayed, copied, or sent.
|
|
</dd>
|
|
<dt><b>CPF3434</b></dt>
|
|
<dd>Data in file &1 in &2 member &3 not in required format.
|
|
</dd>
|
|
<dt><b>CPF3435</b></dt>
|
|
<dd>Requested data not found in file &1 in &2 member &3.
|
|
</dd>
|
|
<dt><b>CPF3478</b></dt>
|
|
<dd>File &1 not found in job &5/&4/&3 on output queue &6 in library &7.
|
|
</dd>
|
|
<dt><b>CPF3492</b></dt>
|
|
<dd>Not authorized to spooled file.
|
|
</dd>
|
|
<dt><b>CPF7D41</b></dt>
|
|
<dd>Error occurred while logging order assistance request.
|
|
</dd>
|
|
<dt><b>CPF7D42</b></dt>
|
|
<dd>Error occurred while performing database operation.
|
|
</dd>
|
|
<dt><b>CPF9812</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9815</b></dt>
|
|
<dd>Member &5 file &2 in library &3 not found.
|
|
</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>CPF9871</b></dt>
|
|
<dd>Error occurred while processing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|