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

155 lines
4.9 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>Clear Job Queue (CLRJOBQ)</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="CLRJOBQ.Top_Of_Page"></a>
<h2>Clear Job Queue (CLRJOBQ)</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="#CLRJOBQ.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CLRJOBQ.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CLRJOBQ.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CLRJOBQ"></a>
<p>The Clear Job Queue (CLRJOBQ) command removes, from the specified job queue, all the job entries for batch jobs (including jobs that are in the hold state). Any jobs that are currently being read in and any interactive jobs that have been rerouted to the job queue remain on the queue. The running of jobs that were started from the job queue is not affected.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CLRJOBQ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CLRJOBQ.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="#CLRJOBQ.JOBQ"><b>JOBQ</b></a></td>
<td valign="top">Job 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: Job 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="#CLRJOBQ.LOG"><b>LOG</b></a></td>
<td valign="top">Job log</td>
<td valign="top"><b><u>*JOB</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CLRJOBQ.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CLRJOBQ.JOBQ"></a>
<h3>Job queue (JOBQ)</h3>
<p>Specifies the job queue that is to be cleared of all waiting or held jobs.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Job queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job queue that is to be cleared.
</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 job 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 job queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CLRJOBQ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CLRJOBQ.LOG"></a>
<h3>LOG (LOG)</h3>
<p>Specifies whether to use the message logging values associated with a job for jobs removed from the job queue.
</p>
<dl>
<dt><b>*JOB</b></dt>
<dd>Use the message logging values specified for each job when the job is removed from the job queue.
</dd>
<dt><b>*NONE</b></dt>
<dd>No job log spooled files will be generated for the removed jobs.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CLRJOBQ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CLRJOBQ.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CLRJOBQ JOBQ(QBATCH)
</pre>
</p>
<p>This command removes all jobs currently in the IBM-supplied job queue, QBATCH. Any job currently being read in is not affected.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CLRJOBQ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CLRJOBQ.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>CPF3307</b></dt>
<dd>Job queue &amp;1 in &amp;2 not found.
</dd>
<dt><b>CPF3330</b></dt>
<dd>Necessary resource not available.
</dd>
<dt><b>CPF3416</b></dt>
<dd>&amp;1 entries deleted. &amp;2 entries not deleted from job queue &amp;3 in library &amp;4.
</dd>
<dt><b>CPF9843</b></dt>
<dd>Object &amp;1 in library &amp;3 type &amp;2 cannot be accessed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CLRJOBQ.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>