ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/wrksplfa.htm

328 lines
11 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Work with Spooled File Attr (WRKSPLFA)</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="WRKSPLFA.Top_Of_Page"></a>
<h2>Work with Spooled File Attr (WRKSPLFA)</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="#WRKSPLFA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKSPLFA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKSPLFA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKSPLFA"></a>
<p>The Work With Spooled File Attributes (WRKSPLFA) command shows the current attributes of the specified spooled file. The attributes can be displayed after the file is opened and while its file entry is still on the output queue.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKSPLFA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKSPLFA.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="#WRKSPLFA.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="#WRKSPLFA.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="#WRKSPLFA.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="#WRKSPLFA.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="#WRKSPLFA.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="#WRKSPLFA.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#WRKSPLFA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKSPLFA.FILE"></a>
<h3>Spooled file (FILE)</h3>
<p>Specifies the spooled file for which you wish to display the attributes.
</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 have its attributes displayed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKSPLFA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKSPLFA.JOB"></a>
<h3>Job name (JOB)</h3>
<p>Specifies the name of the job that created the spooled file.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The job that entered 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. If no other job qualifiers are given, all jobs currently in the system are searched for the simple name of the job.
</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="#WRKSPLFA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKSPLFA.SPLNBR"></a>
<h3>Spooled file number (SPLNBR)</h3>
<p>Specifies the unique number of the spooled file in the job whose attributes are 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 with the specified file name whose attributes are displayed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKSPLFA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKSPLFA.JOBSYSNAME"></a>
<h3>Job system name (JOBSYSNAME)</h3>
<p>Specifies the name of 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="#WRKSPLFA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKSPLFA.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="#WRKSPLFA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKSPLFA.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 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>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKSPLFA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKSPLFA.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
WRKSPLFA FILE(QPRINT) OUTPUT(*PRINT)
</pre>
</p>
<p>This command prints a file containing the current attributes of the spooled file QPRINT and sends it to the job's output queue to be printed. The job that entered this command must have produced only one output file named QPRINT.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKSPLFA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKSPLFA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF3302</b></dt>
<dd>Override of print file &amp;1 to file &amp;2 not valid.
</dd>
<dt><b>CPF3303</b></dt>
<dd>File &amp;1 not found in job &amp;5/&amp;4/&amp;3.
</dd>
<dt><b>CPF3309</b></dt>
<dd>No files named &amp;1 are active.
</dd>
<dt><b>CPF3330</b></dt>
<dd>Necessary resource not available.
</dd>
<dt><b>CPF3336</b></dt>
<dd>Job &amp;5/&amp;4/&amp;3 no longer in the system.
</dd>
<dt><b>CPF3340</b></dt>
<dd>More than one file with specified name found in job &amp;5/&amp;4/&amp;3.
</dd>
<dt><b>CPF3342</b></dt>
<dd>Job &amp;5/&amp;4/&amp;3 not found.
</dd>
<dt><b>CPF3343</b></dt>
<dd>Duplicate job names found.
</dd>
<dt><b>CPF3344</b></dt>
<dd>File &amp;1 number &amp;8 no longer in the system.
</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>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</dd>
<dt><b>CPF9846</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9871</b></dt>
<dd>Error occurred while processing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKSPLFA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>