198 lines
6.8 KiB
HTML
198 lines
6.8 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>Release Writer (RLSWTR)</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="RLSWTR.Top_Of_Page"></a>
|
|
<h2>Release Writer (RLSWTR)</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="#RLSWTR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RLSWTR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RLSWTR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RLSWTR"></a>
|
|
<p>The Release Writer (RLSWTR) command releases a held writer so that files on the output queue can now be processed. If the writer was writing a file when it was held, the writer can be released to resume writing this same file or it can be released to start writing the next file. In any case, data from the file that was being written when the Hold Writer (HLDWTR) command was issued is not lost.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>You must specify a value for <b>either</b> the <b>Resume writing at (OPTION)</b> parameter or the <b>Starting page (PAGE)</b> parameter. You cannot specify both.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RLSWTR.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="#RLSWTR.WTR"><b>WTR</b></a></td>
|
|
<td valign="top">Writer</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RLSWTR.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Resume writing at</td>
|
|
<td valign="top">-32766-32766, <b><u>*CURRENT</u></b>, *BEGIN, *BYPASS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RLSWTR.PAGE"><b>PAGE</b></a></td>
|
|
<td valign="top">Starting page</td>
|
|
<td valign="top"><i>Integer</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RLSWTR.WTR"></a>
|
|
<h3>Writer (WTR)</h3>
|
|
<p>Specifies the spooling writer to release. After releasing the writer, you will be able to process the files on the output queue (provided the output queue is not held).
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the writer to be released.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RLSWTR.OPTION"></a>
|
|
<h3>Resume writing at (OPTION)</h3>
|
|
<p>Specifies the point in the file where you want the writer to begin. Only the first option *CURRENT can be specified when the writer is not producing a file. The last three options (*BYPASS, +number, and -number) can be specified only if the writer was held while it was producing this file. Also, the only valid option for the diskette writer is *CURRENT.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The writer is released at the point where it had been held by the Hold Writer (HLDWTR) command.
|
|
</dd>
|
|
<dt><b>*BEGIN</b></dt>
|
|
<dd>The writer is released at the beginning of the current file.
|
|
</dd>
|
|
<dt><b>*BYPASS</b></dt>
|
|
<dd>The writer is released at the beginning of the next file. The current file is to be implicitly held on the queue.
|
|
</dd>
|
|
<dt><b><i>+number</i></b></dt>
|
|
<dd>The writer is released <b>n</b> number of pages past the point where it was held.
|
|
</dd>
|
|
<dt><b><i>-number</i></b></dt>
|
|
<dd>The writer is to be released <b>n</b> number of pages before the point where it was held.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RLSWTR.PAGE"></a>
|
|
<h3>Starting page (PAGE)</h3>
|
|
<p>Specifies the page where the writer starts printing. This parameter is mutually exclusive with the <b>Resume writing at (OPTION)</b> parameter and is only valid for a printer writer. This parameter can be specified only if the writer was held while producing the file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>integer</i></b></dt>
|
|
<dd>Specify the page number in this file where you want the writer to start printing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RLSWTR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Releasing a Writer at Beginning of File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RLSWTR WTR(PRINTER) OPTION(*BEGIN)
|
|
</pre>
|
|
</p>
|
|
<p>This command releases writer PRINTER to begin producing the current file at its beginning.
|
|
</p>
|
|
<p><b>Example 2: Releasing Writer at Specified Point</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RLSWTR WTR(PRTR) OPTION(-3)
|
|
</pre>
|
|
</p>
|
|
<p>This command releases writer PRTR to begin printing again at a point three pages before the point where the writer was held. That is, the last three pages previously printed are the first three pages printed this time.
|
|
</p>
|
|
<p><b>Example 3: Starting Printing on Page Ten</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RLSWTR WTR(PRTR) PAGE(10)
|
|
</pre>
|
|
</p>
|
|
<p>This command releases writer PRTR to start printing again at page ten.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RLSWTR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1317</b></dt>
|
|
<dd>No response from subsystem for job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF1340</b></dt>
|
|
<dd>Job control function not performed.
|
|
</dd>
|
|
<dt><b>CPF1352</b></dt>
|
|
<dd>Function not done. &3/&2/&1 in transition condition.
|
|
</dd>
|
|
<dt><b>CPF3313</b></dt>
|
|
<dd>Writer &1 not active nor on job queue.
|
|
</dd>
|
|
<dt><b>CPF3314</b></dt>
|
|
<dd>PAGE parameter allowed only for print writers.
|
|
</dd>
|
|
<dt><b>CPF3316</b></dt>
|
|
<dd>Writer &3/&2/&1 not released because writer not held.
|
|
</dd>
|
|
<dt><b>CPF3317</b></dt>
|
|
<dd>OPTION parameter value not allowed for diskette writer.
|
|
</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>CPF3334</b></dt>
|
|
<dd>Previous hold to writer &3/&2/&1 pending.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSWTR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|