782 lines
29 KiB
HTML
782 lines
29 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>Start Printer Writer (STRPRTWTR)</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="STRPRTWTR.Top_Of_Page"></a>
|
||
|
|
<h2>Start Printer Writer (STRPRTWTR)</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="#STRPRTWTR.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#STRPRTWTR.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#STRPRTWTR.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="STRPRTWTR"></a>
|
||
|
|
<p>The Start Printer Writer (STRPRTWTR) command starts a spooling writer to the specified printer. The writer, which is a system job, takes spooled files from an output queue and produces (writes) the output on the printer device. This command specifies the name of the printer, the names of the output and message queues used, and the name of the writer.
|
||
|
|
</p>
|
||
|
|
<p>More than one writer can be active at the same time (as determined by the spooling subsystem description), and up to 10 writers can be active to the same output queue. Each writer must have a unique writer name, its own device, and only one type of writer (print, remote, or diskette) can be active to a single output queue. A writer that has been started can be actively writing output or waiting for a file entry to be put on the output queue. The writer can be changed, held, or canceled if the Change Writer (CHGWTR), Hold Writer (HLDWTR), or End Writer (ENDWTR) command is used. Because each writer runs independently of the job that started it, you can continue doing other work on the system after you start a writer.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRPRTWTR.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="#STRPRTWTR.DEV"><b>DEV</b></a></td>
|
||
|
|
<td valign="top">Printer</td>
|
||
|
|
<td valign="top"><i>Name</i>, *ALL, *SYSVAL</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#STRPRTWTR.OUTQ"><b>OUTQ</b></a></td>
|
||
|
|
<td valign="top">Output queue</td>
|
||
|
|
<td valign="top">Single values: <b><u>*DEV</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" rowspan="3"><a href="#STRPRTWTR.MSGQ"><b>MSGQ</b></a></td>
|
||
|
|
<td valign="top">Queue for writer messages</td>
|
||
|
|
<td valign="top">Single values: <b><u>*DEVD</u></b>, *REQUESTER<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Queue for writer messages</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="#STRPRTWTR.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</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Form type</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*ALL</u></b>, *STD, *FORMS</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Message option</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*INQMSG</u></b>, *MSG, *NOMSG, *INFOMSG</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPRTWTR.FILESEP"><b>FILESEP</b></a></td>
|
||
|
|
<td valign="top">File separators</td>
|
||
|
|
<td valign="top">0-9, <b><u>*FILE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPRTWTR.SEPDRAWER"><b>SEPDRAWER</b></a></td>
|
||
|
|
<td valign="top">Drawer for separators</td>
|
||
|
|
<td valign="top">1-255, <b><u>*DEVD</u></b>, *FILE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPRTWTR.WTR"><b>WTR</b></a></td>
|
||
|
|
<td valign="top">Writer</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*DEV</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#STRPRTWTR.AUTOEND"><b>AUTOEND</b></a></td>
|
||
|
|
<td valign="top">Auto-end options</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Automatically end writer</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*NO</u></b>, *YES</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: If yes, when to end</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*NORDYF</u></b>, *FILEEND</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPRTWTR.ALWDRTPRT"><b>ALWDRTPRT</b></a></td>
|
||
|
|
<td valign="top">Allow direct print</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPRTWTR.ALIGN"><b>ALIGN</b></a></td>
|
||
|
|
<td valign="top">Align page</td>
|
||
|
|
<td valign="top">*FILE, <b><u>*WTR</u></b>, *FIRST</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPRTWTR.INIT"><b>INIT</b></a></td>
|
||
|
|
<td valign="top">Initialize printer</td>
|
||
|
|
<td valign="top"><b><u>*WTR</u></b>, *FIRST, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPRTWTR.FILE"><b>FILE</b></a></td>
|
||
|
|
<td valign="top">Spooled file</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b>, *LAST</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#STRPRTWTR.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</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="#STRPRTWTR.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</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRPRTWTR.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="#STRPRTWTR.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="#STRPRTWTR.PAGE"><b>PAGE</b></a></td>
|
||
|
|
<td valign="top">Starting page</td>
|
||
|
|
<td valign="top"><i>Integer</i>, <b><u>*BEGIN</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="STRPRTWTR.DEV"></a>
|
||
|
|
<h3>Printer (DEV)</h3>
|
||
|
|
<p>Specifies the printer device used to print the spooled file. The device must be available before the writer can be started.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Start a printer writer for every printer configured on the system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>Start a printer writer for the system default printer.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name that the printer device being started is identified by.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.OUTQ"></a>
|
||
|
|
<h3>Output queue (OUTQ)</h3>
|
||
|
|
<p>Specifies the output queue from which the writer processes spooled files.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEV</u></b></dt>
|
||
|
|
<dd>Use the default output queue associated with the printer specified on the <b>Printer (DEV)</b> parameter.
|
||
|
|
</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 that the writer processes spooled files from.
|
||
|
|
</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 current library entry exists in the library list, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the output queue is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.MSGQ"></a>
|
||
|
|
<h3>Queue for writer messages (MSGQ)</h3>
|
||
|
|
<p>Specifies the message queue that is used by this user.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEVD</u></b></dt>
|
||
|
|
<dd>The messages are sent to the message queue specified in the printer's device description.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*REQUESTER</b></dt>
|
||
|
|
<dd>The messages are sent to the workstation message queue of the workstation of the user who started the process. If this value is specified for a batch job, *DEVD is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Queue for writer messages</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the message queue where writer messages should be sent.
|
||
|
|
</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 message queue. If no current library entry exists in the library list, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the message queue is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.FORMTYPE"></a>
|
||
|
|
<h3>Form type options (FORMTYPE)</h3>
|
||
|
|
<p>Specifies which form type should be selected to print. This parameter specifies that only the files with this form type are processed now. All other files are left on the output queue as available. If you wish to change the type of form to be printed after the writer is started, you should use the Change Writer (CHGWTR) command.
|
||
|
|
</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>*ALL</u></b></dt>
|
||
|
|
<dd>All available files on the output queue will be processed regardless of their form type.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FORMS</b></dt>
|
||
|
|
<dd>All available files on the output queue with the same form type are processed as a group before the writer moves on to the next form type. The writer first chooses the first available file on the queue. After the first file is complete, all files with the same form type will be processed. The writer again chooses the first available file on the queue and repeats the process for that form type.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STD</b></dt>
|
||
|
|
<dd>The writer processes spooled files with a form type of *STD.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>form-type</i></b></dt>
|
||
|
|
<dd>Specify the type of form for which you want spooled files processed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Message option</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*INQMSG</u></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="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.FILESEP"></a>
|
||
|
|
<h3>File separators (FILESEP)</h3>
|
||
|
|
<p>Specifies how to control the number of file separator pages that are printed before each file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FILE</u></b></dt>
|
||
|
|
<dd>The number of separators that was specified for each individual file is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-9</i></b></dt>
|
||
|
|
<dd>Specify the number of separator pages to print. Whenever you respond to the change form type message indicating that a new form type has been put on the printer, the writer issues a message inquiring how many file separator pages should be printed with the new form type.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.SEPDRAWER"></a>
|
||
|
|
<h3>Drawer for separators (SEPDRAWER)</h3>
|
||
|
|
<p>Specifies which paper drawer is selected for printing job and file separators.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEVD</u></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="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.WTR"></a>
|
||
|
|
<h3>Writer (WTR)</h3>
|
||
|
|
<p>Specifies the name of the spooling writer being started. Each writer name must be unique.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEV</u></b></dt>
|
||
|
|
<dd>The name of the writer is the same as the name of the printer device specified on the <b>Printer (DEV)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name by which the writer being started is identified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.AUTOEND"></a>
|
||
|
|
<h3>Auto-end options (AUTOEND)</h3>
|
||
|
|
<p>Specifies whether the writer ends automatically.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Automatically end writer</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The writer does not end when the last available file has been removed from the output queue; it waits for another spooled file entry to be put on the queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The writer automatically ends after it has reached the state specified by the second part of this parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: If yes, when to end</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NORDYF</b></dt>
|
||
|
|
<dd>The writer automatically ends when there are no ready files (all the available files have been removed from the output queue).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILEEND</b></dt>
|
||
|
|
<dd>The writer stops after it has finished processing one spooled file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.ALWDRTPRT"></a>
|
||
|
|
<h3>Allow direct print (ALWDRTPRT)</h3>
|
||
|
|
<p>Specifies whether the printer writer allows files to be printed directly to the printer. A file printed directly to the printer is created by specifying SPOOL(*NO) for a printer file. When direct printing is allowed, the non-spooled printer file is printed immediately if the printer is available or, if the printer is busy, the non-spooled printer file waits until the printer is available. The maximum wait is the length of time specified on the WAITFILE parameter on the printer file, after which the job is automatically canceled. The user can cancel a non-spooled printer file only with an End Job (ENDJOB) command.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The printer does not allow non-spooled printer files to be printed to the device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The printer can be used to print spooled and non-spooled output. See the Create, Change, or Override Printer File (CRTPRTF, CHGPRTF, or OVRPRTF) command to set the value of the WAITFILE parameter.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Nonspooled files wait up to 30 seconds regardless of whether the value specified on the WAITFILE parameter is less than 30 seconds.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.ALIGN"></a>
|
||
|
|
<h3>Align page (ALIGN)</h3>
|
||
|
|
<p>Specifies how to control the forms alignment.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*WTR</u></b></dt>
|
||
|
|
<dd>The writer keeps track of the output that is printed and issues a forms alignment message whenever it determines that forms may need to be aligned.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILE</b></dt>
|
||
|
|
<dd>The forms alignment message is issued for every file that has *YES specified for the <b>Align page</b> prompt (ALIGN parameter). This option should be taken whenever the automatic forms alignment control provided by the writer does not provide the desired results.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FIRST</b></dt>
|
||
|
|
<dd>The forms alignment message is issued only for the first file printed. No alignment messages are issued when subsequent errors occur on the printer.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.INIT"></a>
|
||
|
|
<h3>Initialize printer (INIT)</h3>
|
||
|
|
<p>Specifies how often to initialize the printer device.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is ignored if TRANSFORM(*YES) or a user data transform program was specified on the printer device description.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*WTR</u></b></dt>
|
||
|
|
<dd>The writer initializes the printer device when necessary.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FIRST</b></dt>
|
||
|
|
<dd>The writer initializes the printer device only before the first file is printed, or after a device error occurs.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The writer initializes the printer device before each file and each copy of the file is printed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.FILE"></a>
|
||
|
|
<h3>Spooled file (FILE)</h3>
|
||
|
|
<p>Specifies the first (or only) spooled file to print on the printer. If several files are available on the output queue, the next file produced is the first one available with the highest priority.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No spooled file name is specified; the first spooled file that becomes available on the output queue is processed first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The spooled file which was being printed when the writer ended will start to print when the writer is restarted.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the spooled file that is the first (or only) file to be written to the printer.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.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 Start Printer Writer (STRPRTWTR) command was issued 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 of the 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="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.SPLNBR"></a>
|
||
|
|
<h3>Spooled file number (SPLNBR)</h3>
|
||
|
|
<p>Specifies the number of the spooled file that is processed first. This parameter is valid only if a spooled file name is specified on the <b>Spooled file</b> prompt (FILE parameter).
|
||
|
|
</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 specified file from the job on the specified output queue that is to be processed first.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.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="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.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="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRPRTWTR.PAGE"></a>
|
||
|
|
<h3>Starting page (PAGE)</h3>
|
||
|
|
<p>Specifies the page number of the first page to print from the first file. This parameter is valid only if a spooled file name is specified on the <b>Spooled file</b> prompt (FILE parameter).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*BEGIN</b></dt>
|
||
|
|
<dd>The restart page of the spooled file is the first page to print.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If this value has not been changed using the Change Spooled File Attribute (CHGSPLFA) command, the file will print in the same manner as it would if the value were *BEGIN.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>integer</i></b></dt>
|
||
|
|
<dd>Specify the number of the first page to print. This number must be within the page range of the file to be valid.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRPRTWTR.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRPRTWTR DEV(QSYSPRT) OUTQ(QPRINTS) WTR(TOM)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command starts a spooling writer named TOM. This writer takes the output from the output queue named QPRINTS and prints the output on the printer named QSYSPRT. Writer messages are sent to the system operator's message queue, and the writer waits for more output when the queue is emptied.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRPRTWTR.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF0906</b></dt>
|
||
|
|
<dd>A duplicate job named &3/&2/&1 was found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1338</b></dt>
|
||
|
|
<dd>Errors occurred on SBMJOB command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1764</b></dt>
|
||
|
|
<dd>Writer already started for device &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1842</b></dt>
|
||
|
|
<dd>Cannot access system value &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2115</b></dt>
|
||
|
|
<dd>Object &1 in &2 type *&3 damaged.
|
||
|
|
</dd>
|
||
|
|
<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>CPF3305</b></dt>
|
||
|
|
<dd>Output queue &1 in library &2 assigned to another writer.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3309</b></dt>
|
||
|
|
<dd>No files named &1 are active.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3310</b></dt>
|
||
|
|
<dd>Writer &1 already started.
|
||
|
|
</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>CPF3347</b></dt>
|
||
|
|
<dd>Device &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3357</b></dt>
|
||
|
|
<dd>Output queue &1 in library &2 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3362</b></dt>
|
||
|
|
<dd>Objects in QTEMP not valid for parameter values.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3363</b></dt>
|
||
|
|
<dd>Message queue &1 in library &2 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3369</b></dt>
|
||
|
|
<dd>Device &1 not printer device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF336B</b></dt>
|
||
|
|
<dd>Not found or not authorized to driver exit program &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3418</b></dt>
|
||
|
|
<dd>Duplicate file &1 number &2 found in job.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF346A</b></dt>
|
||
|
|
<dd>Transform exit program &1 in library &2 not found or user is not authorized.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF346B</b></dt>
|
||
|
|
<dd>Driver exit program &1 in library &2 not found or user is not authorized.
|
||
|
|
</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>CPF3478</b></dt>
|
||
|
|
<dd>File &1 not found in job &5/&4/&3 on output queue &6 in library &7.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRPRTWTR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|