377 lines
13 KiB
HTML
377 lines
13 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>Change Writer (CHGWTR)</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="CHGWTR.Top_Of_Page"></a>
|
|
<h2>Change Writer (CHGWTR)</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="#CHGWTR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGWTR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGWTR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGWTR"></a>
|
|
<p>The Change Writer (CHGWTR) command allows you to change the following attributes of an active printer writer:
|
|
</p>
|
|
<ul>
|
|
<li>Change the form type to be processed by this writer
|
|
</li>
|
|
<li>Change the number of file separators for this writer
|
|
</li>
|
|
<li>Change the output queue to be used for this writer
|
|
</li>
|
|
</ul>
|
|
<p>This command lets you process all files of a given form type together. Spooled files are not necessarily in form type sequence when they reside on the output queue, so this helps the operator to manage the output without continually having to change forms. It also lets you change and use another output queue for this printer without ending and starting the writer each time.
|
|
</p>
|
|
<p>If changes are made while the writer is in hold (HLD) status, the changes do not take effect until after the writer is released. The changes are then made based on the value specified on the OPTION parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGWTR.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="#CHGWTR.WTR"><b>WTR</b></a></td>
|
|
<td valign="top">Writer</td>
|
|
<td valign="top"><i>Name</i>, *SYSVAL</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGWTR.OUTQ"><b>OUTQ</b></a></td>
|
|
<td valign="top">Output queue</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *DEV<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" rowspan="3"><a href="#CHGWTR.FORMTYPE"><b>FORMTYPE</b></a></td>
|
|
<td valign="top">Form type options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Form type</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*SAME</u></b>, *ALL, *STD, *FORMS</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Message option</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *INQMSG, *MSG, *NOMSG, *INFOMSG</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGWTR.FILESEP"><b>FILESEP</b></a></td>
|
|
<td valign="top">File separators</td>
|
|
<td valign="top">0-9, <b><u>*SAME</u></b>, *FILE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGWTR.SEPDRAWER"><b>SEPDRAWER</b></a></td>
|
|
<td valign="top">Drawer for separators</td>
|
|
<td valign="top">1-255, <b><u>*SAME</u></b>, *DEVD, *FILE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGWTR.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">When to change writer</td>
|
|
<td valign="top"><b><u>*NORDYF</u></b>, *FILEEND</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGWTR.WTR"></a>
|
|
<h3>Writer (WTR)</h3>
|
|
<p>Specifies the printer writer being changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SYSVAL</b></dt>
|
|
<dd>The writer started to the system default printer is to be changed.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the printer writer you wish to change.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGWTR.OUTQ"></a>
|
|
<h3>Output queue (OUTQ)</h3>
|
|
<p>Specifies the output queue which this writer will use to process spooled files. The output queue must be available before the writer is changed. If the output queue is in a primary or secondary auxiliary storage pool, the output queue must be in the library name space of the writer job.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The output queue being used remains the same.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*DEV</b></dt>
|
|
<dd>The output queue associated with the printer device for the spooled file is used.
|
|
</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.
|
|
</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 job is used to locate the output queue. 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 in which the output queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGWTR.FORMTYPE"></a>
|
|
<h3>Form type options (FORMTYPE)</h3>
|
|
<p>Specifies the form type to be used when processing output for the writer. A file's form type is originally derived from the form type that was used to produce the spooled file.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The form load message is issued when the spooled file to be printed has a form type different from the form type of the last spooled file that was printed on the device. The last form type printed is kept from the last STRPRTWTR, CHGWTR, or VRYCFG command issued.
|
|
</p>
|
|
<p>Consider the following example:
|
|
</p>
|
|
<ol>
|
|
<li>The last spooled file printed on printer PRT01 had the form type *STD.
|
|
</li>
|
|
<li>The user changes the form type on PRT01 to XYZ using the following command:
|
|
<p>
|
|
<pre>
|
|
CHGWTR PRT01 FORMTYPE(XYZ)
|
|
</pre>
|
|
</p>
|
|
</li>
|
|
<li>No spooled file with the form type XYZ is printed on PRT01.
|
|
</li>
|
|
<li>The user then sends a spooled file with the form type *STD to PRT01. The form load message is not issued, despite the intervening CHGWTR command, because the last spooled file printed on PRT01 had the same form type as the spooled file being printed.
|
|
<p>The form load message would be issued if a spooled file with the form type XYZ were actually printed on PRT01.
|
|
</p>
|
|
</li>
|
|
</ol>
|
|
<p><b>Element 1: Form type</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The current form type value does not change.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All form types are processed by the writer.
|
|
</dd>
|
|
<dt><b>*FORMS</b></dt>
|
|
<dd>All available files with the same form type are processed as a group before the writer moves on to the next form type. The writer initially chooses the first available file on the queue. After the first file is complete, all files with the same form type as the first are processed. Then, the writer again chooses the first available file on the queue, and the process is repeated.
|
|
</dd>
|
|
<dt><b>*STD</b></dt>
|
|
<dd>The writer processes spooled files with form type *STD.
|
|
</dd>
|
|
<dt><b><i>form-type</i></b></dt>
|
|
<dd>Specify the type of form to be used by the writer. Only files with this form type are processed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Message option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The current message attribute does not change.
|
|
</dd>
|
|
<dt><b>*INQMSG</b></dt>
|
|
<dd>An inquiry message is sent to the message queue when a spooled file has a form type that is different than the form type in the printer.
|
|
</dd>
|
|
<dt><b>*INFOMSG</b></dt>
|
|
<dd>An informational message is sent to the message queue when no spooled files requiring this form type remain in the output queue.
|
|
</dd>
|
|
<dt><b>*MSG</b></dt>
|
|
<dd>An inquiry message is sent to the message queue when a spooled file has a form type that is different than the form type in the printer and an informational message is sent when no spooled files requiring this form type remain in the output queue.
|
|
</dd>
|
|
<dt><b>*NOMSG</b></dt>
|
|
<dd>Neither an inquiry message nor an informational message is sent to the message queue.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGWTR.FILESEP"></a>
|
|
<h3>File separators (FILESEP)</h3>
|
|
<p>Specifies the number of file separator pages to print before each file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The number of file separators remains the same.
|
|
</dd>
|
|
<dt><b>*FILE</b></dt>
|
|
<dd>Print the number of file separator pages that is specified for each individual file.
|
|
</dd>
|
|
<dt><b><i>0-9</i></b></dt>
|
|
<dd>Specify the number of file separator pages to print.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGWTR.SEPDRAWER"></a>
|
|
<h3>Drawer for separators (SEPDRAWER)</h3>
|
|
<p>Specifies which paper drawer is selected for printing separators.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The drawer specified for separator pages does not change.
|
|
</dd>
|
|
<dt><b>*DEVD</b></dt>
|
|
<dd>The value stored in the device description for the printer is used.
|
|
</dd>
|
|
<dt><b>*FILE</b></dt>
|
|
<dd>The separator pages are printed from the same drawer as the spooled file.
|
|
</dd>
|
|
<dt><b>1</b></dt>
|
|
<dd>The separator pages are printed from drawer 1.
|
|
</dd>
|
|
<dt><b>2</b></dt>
|
|
<dd>The separator pages are printed from drawer 2.
|
|
</dd>
|
|
<dt><b>3</b></dt>
|
|
<dd>The separator pages are printed from drawer 3.
|
|
</dd>
|
|
<dt><b><i>1-255</i></b></dt>
|
|
<dd>Specify a number to indicate the drawer from which the separator pages are printed.
|
|
<p>
|
|
<b>Note: </b>For some printers, SEPDRAWER(3) implies an envelope drawer.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGWTR.OPTION"></a>
|
|
<h3>When to change writer (OPTION)</h3>
|
|
<p>Specifies when the change occurs.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NORDYF</u></b></dt>
|
|
<dd>The change occurs when there are no files on the output queue that meet the writer's current form type selection values.
|
|
</dd>
|
|
<dt><b>*FILEEND</b></dt>
|
|
<dd>The change occurs at the end of the current file (For example, when the current report finishes printing).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGWTR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGWTR WTR(MYWTR) FORMTYPE(MYFORM *NOMSG) OPTION(*FILEEND)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes writer MYWTR, which has been producing files of some other form type, to produce files with a form type of MYFORM at the end of the file now being produced. The writer is also prevented from sending an informational message when it runs out of eligible files with form type MYFORM.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGWTR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1842</b></dt>
|
|
<dd>Cannot access system value &1.
|
|
</dd>
|
|
<dt><b>CPF2207</b></dt>
|
|
<dd>Not authorized to use object &1 in library &3 type *&2.
|
|
</dd>
|
|
<dt><b>CPF3313</b></dt>
|
|
<dd>Writer &1 not active nor on job queue.
|
|
</dd>
|
|
<dt><b>CPF3330</b></dt>
|
|
<dd>Necessary resource not available.
|
|
</dd>
|
|
<dt><b>CPF3331</b></dt>
|
|
<dd>Not authorized to control writer &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF3357</b></dt>
|
|
<dd>Output queue &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF3456</b></dt>
|
|
<dd>Cannot change writer &1 to output queue &4 in library &5.
|
|
</dd>
|
|
<dt><b>CPF3457</b></dt>
|
|
<dd>Cannot change writer &1.
|
|
</dd>
|
|
<dt><b>CPF3458</b></dt>
|
|
<dd>Change writer &1 not allowed. End writer pending.
|
|
</dd>
|
|
<dt><b>CPF3459</b></dt>
|
|
<dd>Writer &1 not eligible for change.
|
|
</dd>
|
|
<dt><b>CPF3460</b></dt>
|
|
<dd>Change writer &1 not allowed.
|
|
</dd>
|
|
<dt><b>CPF3463</b></dt>
|
|
<dd>Output queue for device &1 not found.
|
|
</dd>
|
|
<dt><b>CPF3464</b></dt>
|
|
<dd>Not authorized to output queue &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|