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

285 lines
10 KiB
HTML
Raw 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 Printing Status (WRKPRTSTS)</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="WRKPRTSTS.Top_Of_Page"></a>
<h2>Work with Printing Status (WRKPRTSTS)</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="#WRKPRTSTS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKPRTSTS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKPRTSTS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKPRTSTS"></a>
<p>The Work with Printing Status (WRKPRTSTS) command allows you to list the statuses of a specified spooled file.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKPRTSTS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKPRTSTS.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="#WRKPRTSTS.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="#WRKPRTSTS.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="#WRKPRTSTS.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="#WRKPRTSTS.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="#WRKPRTSTS.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#WRKPRTSTS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKPRTSTS.FILE"></a>
<h3>Spooled file (FILE)</h3>
<p>Specifies the name of a file created by a user program or the name of the device file used to create this file.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKPRTSTS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKPRTSTS.JOB"></a>
<h3>Job name (JOB)</h3>
<p>Specifies the name of the job that created the spooled file. This parameter is valid only if a spooled file name is specified on the <b>Spooled file (FILE)</b> parameter.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The job from which this WRKPRTSTS command was entered 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 job qualifier is given, all of the jobs currently in the system are searched for the simple job name.
</dd>
</dl>
<p><b>Qualifier 2: User</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user profile under which the spooled file was created.
</dd>
</dl>
<p><b>Qualifier 3: Number</b>
</p>
<dl>
<dt><b><i>000000-999999</i></b></dt>
<dd>Specify the system-assigned number of the job that created the spooled file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKPRTSTS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKPRTSTS.SPLNBR"></a>
<h3>Spooled file number (SPLNBR)</h3>
<p>Specifies the number of the spooled file being processed. This parameter is valid only if a spooled file name is specified on the <b>Spooled file (FILE)</b> parameter.
</p>
<dl>
<dt><b><u>*ONLY</u></b></dt>
<dd>Only one spooled file from the job on the specified queue has the specified file name; no spooled file number is needed. If *ONLY is specified and more than one spooled file on the output queue has the same name, an error message is shown.
</dd>
<dt><b>*LAST</b></dt>
<dd>The highest-numbered spooled file that is on the specified output queue and that has the specified file name is processed first.
</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>number</i></b></dt>
<dd>Specify the number of the job's spooled file that is on the specified output queue and that is being processed first.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKPRTSTS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKPRTSTS.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="#WRKPRTSTS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKPRTSTS.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="#WRKPRTSTS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKPRTSTS.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
WRKPRTSTS FILE(MYFILE)
</pre>
</p>
<p>This command assumes that the user has a spooled file on an output queue that does not have a printer attached to it. When the user specifies this command, the Work with Printing Status panel will be shown. One status message that would apply to the file named MYFILE would be, "This file is not associated with a started printer." Depending on the status of MYFILE, other status types could be shown.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKPRTSTS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKPRTSTS.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<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>CPF3342</b></dt>
<dd>Job &amp;5/&amp;4/&amp;3 not found.
</dd>
<dt><b>CPF3344</b></dt>
<dd>File &amp;1 number &amp;8 no longer in the system.
</dd>
<dt><b>CPF34B4</b></dt>
<dd>WRKPRTSTS command not valid for diskette files.
</dd>
<dt><b>CPF34B5</b></dt>
<dd>Printer &amp;1 is not found.
</dd>
<dt><b>CPF34B6</b></dt>
<dd>More than one printer was selected
</dd>
<dt><b>CPF34B7</b></dt>
<dd>Printer must be selected from list of printers.
</dd>
<dt><b>CPF9871</b></dt>
<dd>Error occurred while processing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKPRTSTS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>