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

292 lines
9.5 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>Work with Writers (WRKWTR)</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="WRKWTR.Top_Of_Page"></a>
<h2>Work with Writers (WRKWTR)</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="#WRKWTR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKWTR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKWTR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKWTR"></a>
<p>The Work with Writers (WRKWTR) command gives the status of printers and writers. This can be the overall status of all writers, the overall status of all printers (along with writer information for these printers), or the detailed status of a specific writer. The status of the writers may change while the command is running.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKWTR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKWTR.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="#WRKWTR.WTR"><b>WTR</b></a></td>
<td valign="top">Writer</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*PRT</u></b>, *ALL</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#WRKWTR.OUTQ"><b>OUTQ</b></a></td>
<td valign="top">Output queue</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Output queue</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="#WRKWTR.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>
<tr>
<td valign="top"><a href="#WRKWTR.DSPFMT"><b>DSPFMT</b></a></td>
<td valign="top">Display format</td>
<td valign="top"><b><u>*INLENV</u></b>, *S36FMT, *NORMAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKWTR.ASTLVL"><b>ASTLVL</b></a></td>
<td valign="top">Assistance level</td>
<td valign="top"><b><u>*PRV</u></b>, *USRPRF, *BASIC, *INTERMED</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#WRKWTR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKWTR.WTR"></a>
<h3>Writer (WTR)</h3>
<p>Specifies the spooling writer for which detailed information is displayed, or specifies that the main attributes and status of <b>all</b> spooling writers or all printers are to be displayed.
</p>
<dl>
<dt><b><u>*PRT</u></b></dt>
<dd>A list of all printers is displayed along with information about the writers started to the printers.
</dd>
<dt><b>*ALL</b></dt>
<dd>The attributes and the current status of all spooling writers are displayed.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the spooled writer for which the detailed information is shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKWTR.OUTQ"></a>
<h3>Output queue (OUTQ)</h3>
<p>Specifies the output queue from which writers have been started. Writers that are started from this output queue are shown.
</p>
<p>This parameter is valid only if WTR(*ALL) is specified.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Work with writers started to all output queues.
</dd>
</dl>
<p><b>Qualifier 1: Output queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the output queue from which writers have been started. Writers that are started from this output queue are shown.
</dd>
</dl>
<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 searched. If no library is specified as the current library for the thread, the QGPL library is searched.
</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="#WRKWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKWTR.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 on a printer. If the System/36 display format is selected through the <b>Display format (DSPFMT)</b> parameter, this parameter is ignored. The data is presented at your terminal.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (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>
<p>
<b>Note: </b><b>*PRINT</b> cannot be specified if you are using an S/36 environment. If the command is run interactively, the output will be displayed but not printed. If the command is run in batch, an error message will be sent and no output will be produced.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKWTR.DSPFMT"></a>
<h3>Display format (DSPFMT)</h3>
<p>Specifies the format and terminology to be used on the displays that result from entering this command. This parameter is valid only if *PRT was specified on the <b>Writer</b> prompt (WTR parameter).
</p>
<dl>
<dt><b><u>*INLENV</u></b></dt>
<dd>The format and terminology to be used is determined by the SPCENV (special environment) value specified in your user profile. If the SPCENV value is *S36, the System/36 terminology is used. All other values will result in this system's terminology being used.
</dd>
<dt><b>*S36FMT</b></dt>
<dd>System/36 terminology is used to present the information.
</dd>
<dt><b>*NORMAL</b></dt>
<dd>This system's terminology is used to present the information.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKWTR.ASTLVL"></a>
<h3>Assistance level (ASTLVL)</h3>
<p>Specifies which user interface to use.
</p>
<dl>
<dt><b><u>*PRV</u></b></dt>
<dd>The previous user interface used is shown.
</dd>
<dt><b>*USRPRF</b></dt>
<dd>The user interface specified on the <b>Assistance level (ASTLVL)</b> parameter of your user profile is used.
</dd>
</dl>
<dl>
<dt><b>*BASIC</b></dt>
<dd>The Operational Assistant user interface is used.
</dd>
</dl>
<dl>
<dt><b>*INTERMED</b></dt>
<dd>The system user interface is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKWTR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKWTR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Working With the Status of All Printers and Writers</b>
</p>
<p>
<pre>
WRKWTR WTR(*ALL)
</pre>
</p>
<p>This command displays the Work with All Printers panel. From this panel, you can work with the status of all printers and writers.
</p>
<p><b>Example 2: Working With the Status of One Writer</b>
</p>
<p>
<pre>
WRKWTR WTR(DISKWRITE)
</pre>
</p>
<p>This command allows you to work with detailed information about writer DISKWRITE.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKWTR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKWTR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF0941</b></dt>
<dd>Job &amp;3/&amp;2/&amp;1 no longer in system.
</dd>
<dt><b>CPF1E99</b></dt>
<dd>Unexpected error occurred.
</dd>
<dt><b>CPF1070</b></dt>
<dd>Job &amp;3/&amp;2/&amp;1 not found.
</dd>
<dt><b>CPF1071</b></dt>
<dd>No authority to job &amp;3/&amp;2/&amp;1.
</dd>
<dt><b>CPF3302</b></dt>
<dd>Override of print file &amp;1 to file &amp;2 not valid.
</dd>
<dt><b>CPF3313</b></dt>
<dd>Writer &amp;1 not active nor on job queue.
</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>CPF3388</b></dt>
<dd>System/36 display format not allowed in batch.
</dd>
<dt><b>CPF3357</b></dt>
<dd>Output queue &amp;1 in library &amp;2 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>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="#WRKWTR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>