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

130 lines
4.6 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>Hold Output Queue (HLDOUTQ)</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="HLDOUTQ.Top_Of_Page"></a>
<h2>Hold Output Queue (HLDOUTQ)</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="#HLDOUTQ.PARAMETERS.TABLE">Parameters</a><br>
<a href="#HLDOUTQ.COMMAND.EXAMPLES">Examples</a><br>
<a href="#HLDOUTQ.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="HLDOUTQ"></a>
<p>The Hold Output Queue (HLDOUTQ) command prevents all currently waiting spooled files, and all spooled files that are added to the output queue after the command is issued, from being processed by a spooling writer. This command has no effect on jobs currently running and adding spooled files to the output queue. It also has no effect on the spooled output that is being produced by a spooling writer at the time the command is issued. When the spooling writer completes all copies of the current output file, it cannot begin the output for any other files until the queue is released.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#HLDOUTQ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="HLDOUTQ.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" rowspan="3"><a href="#HLDOUTQ.OUTQ"><b>OUTQ</b></a></td>
<td valign="top">Output queue</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</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></table>
<table width="100%">
<tr><td align="right"><a href="#HLDOUTQ.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="HLDOUTQ.OUTQ"></a>
<h3>Output queue (OUTQ)</h3>
<p>Specifies the name of the output queue that will have its current and future spooled files withheld from further processing.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Output queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the output queue to hold.
</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="#HLDOUTQ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="HLDOUTQ.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
HLDOUTQ OUTQ(QPRINT)
</pre>
</p>
<p>This command prevents the processing of the spooled files on the QPRINT queue and any spooled files added to the queue. They are held until the queue is released or cleared. A specific job (with its spooled files) can also be ended with the ENDJOB command, which removes the spooled files from the output queue.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#HLDOUTQ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="HLDOUTQ.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2207</b></dt>
<dd>Not authorized to use object &amp;1 in library &amp;3 type *&amp;2.
</dd>
<dt><b>CPF3330</b></dt>
<dd>Necessary resource not available.
</dd>
<dt><b>CPF3357</b></dt>
<dd>Output queue &amp;1 in library &amp;2 not found.
</dd>
<dt><b>CPF3426</b></dt>
<dd>Output queue &amp;1 in library &amp;2 already held.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#HLDOUTQ.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>