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

514 lines
18 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 Job Queue Entry (CHGJOBQE)</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="CHGJOBQE.Top_Of_Page"></a>
<h2>Change Job Queue Entry (CHGJOBQE)</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="#CHGJOBQE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGJOBQE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGJOBQE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGJOBQE"></a>
<p>The Change Job Queue Entry (CHGJOBQE) command changes an existing job queue entry in the specified subsystem description. This command can be issued while a subsystem is active or inactive. A job queue entry identifies the job queue from which jobs are selected to run in the subsystem. Jobs can be placed on a job queue by spooling readers or by using the following commands:
</p>
<ul>
<li>Submit Job (SBMJOB)
</li>
<li>Submit Data Base Jobs (SBMDBJOB)
</li>
<li>Submit Diskette Jobs (SBMDKTJOB)
</li>
<li>Transfer Job (TFRJOB)
</li>
<li>Transfer Batch Job (TFRBCHJOB)
</li>
</ul>
<p>In a subsystem, job queues with lower sequence numbers are processed first.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>The job associated with an active subsystem can only find objects that exist in the system auxiliary storage pool (ASP) or in a basic user ASP. Therefore, objects that are referenced by this command should exist in the system ASP or in a basic user ASP.
</li>
</ol>
<p><b>Restrictions:</b>
</p>
<ol>
<li>To use this command, you must have:
<ul>
<li>object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing that subsystem description.
</li>
</ul>
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGJOBQE.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="#CHGJOBQE.SBSD"><b>SBSD</b></a></td>
<td valign="top">Subsystem description</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: Subsystem description</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="#CHGJOBQE.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 2</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="#CHGJOBQE.MAXACT"><b>MAXACT</b></a></td>
<td valign="top">Maximum active jobs</td>
<td valign="top">0-1000, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CHGJOBQE.SEQNBR"><b>SEQNBR</b></a></td>
<td valign="top">Sequence number</td>
<td valign="top">1-9999, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGJOBQE.MAXPTY1"><b>MAXPTY1</b></a></td>
<td valign="top">Max active priority 1</td>
<td valign="top">0-99, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGJOBQE.MAXPTY2"><b>MAXPTY2</b></a></td>
<td valign="top">Max active priority 2</td>
<td valign="top">0-99, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGJOBQE.MAXPTY3"><b>MAXPTY3</b></a></td>
<td valign="top">Max active priority 3</td>
<td valign="top">0-99, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGJOBQE.MAXPTY4"><b>MAXPTY4</b></a></td>
<td valign="top">Max active priority 4</td>
<td valign="top">0-99, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGJOBQE.MAXPTY5"><b>MAXPTY5</b></a></td>
<td valign="top">Max active priority 5</td>
<td valign="top">0-99, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGJOBQE.MAXPTY6"><b>MAXPTY6</b></a></td>
<td valign="top">Max active priority 6</td>
<td valign="top">0-99, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGJOBQE.MAXPTY7"><b>MAXPTY7</b></a></td>
<td valign="top">Max active priority 7</td>
<td valign="top">0-99, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGJOBQE.MAXPTY8"><b>MAXPTY8</b></a></td>
<td valign="top">Max active priority 8</td>
<td valign="top">0-99, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGJOBQE.MAXPTY9"><b>MAXPTY9</b></a></td>
<td valign="top">Max active priority 9</td>
<td valign="top">0-99, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGJOBQE.SBSD"></a>
<h3>Subsystem description (SBSD)</h3>
<p>Specifies the name and library of the subsystem description that contains the job queue entry being changed.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Subsystem description</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the subsystem description where the job queue entry is being changed.
<p><b>Note:</b> The following IBM-supplied objects are not valid on this parameter:
</p>
<ul>
<li>QSYSSBSD
</li>
</ul>
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the thread's library list are searched until a match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the library where the subsystem description is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.JOBQ"></a>
<h3>Job queue (JOBQ)</h3>
<p>Specifies the name and library of the job queue that is a source of batch jobs that are started by the subsystem. If the job queue does not exist when the entry is added or changed, a library qualifier other than *LIBL must be specified because the job queue name is kept in the subsystem description.
</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>Specifies the name of the job queue that is a source of batch jobs that are started by the subsystem.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the thread's library list are searched until a match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the library where the job queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.MAXACT"></a>
<h3>Maximum active jobs (MAXACT)</h3>
<p>Specifies the maximum number of jobs that can be active at the same time from this job queue.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The maximum number of jobs that can be active at the same time does not change.
</dd>
</dl>
<dl>
<dt><b>*NOMAX</b></dt>
<dd>There is no maximum for the number of jobs that can be started at the same time through this job queue entry. However, the maximum activity level of the routing entries, the subsystem, or the specific job priority level might prevent jobs from being started. If *NOMAX is specified, all the jobs on the job queue are started, even though the activity level of the storage pool being used might prohibit them from running at the same time.
</dd>
<dt><b><i>0-1000</i></b></dt>
<dd>Specify the maximum number of jobs that can be active at the same time from this job queue.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.SEQNBR"></a>
<h3>Sequence number (SEQNBR)</h3>
<p>Specifies a sequence number for this job queue, which is used by the subsystem to determine the order in which the job queues are processed.
</p>
<p>The subsystem first selects jobs from the job queue with the lowest sequence number. When all jobs on that queue have been processed or the number of jobs specified on the <b>Maximum active jobs (MAXACT)</b> parameter has been reached, the subsystem processes jobs on the queue with the next higher sequence number. This sequence continues until all job queue entries have been processed, or until the subsystem has reached its limit for overall maximum jobs. In some cases, the sequence is interrupted and the subsystem processes a job queue with a lower sequence number. This occurs for this subsystem when one of the following conditions occurs:
</p>
<ul>
<li>A held job or job queue is released.
</li>
<li>A job is placed on or transferred to a job queue.
</li>
<li>A new job queue is allocated.
</li>
<li>A job ends.
</li>
</ul>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The sequence number assigned to this job queue does not change.
</dd>
</dl>
<dl>
<dt><b><i>1-9999</i></b></dt>
<dd>Specify the sequence number assigned to this job queue. The sequence number must be unique in the subsystem description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.MAXPTY1"></a>
<h3>Max active priority 1 (MAXPTY1)</h3>
<p>Specifies the number of jobs that can be started for a specified job priority level.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of jobs started in a specific priority level does not change.
</dd>
</dl>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The number of jobs started in a specific priority level is not limited.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the number of jobs started in a specific priority level. A value of 0 indicates that no jobs are started from a specific priority level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.MAXPTY2"></a>
<h3>Max active priority 2 (MAXPTY2)</h3>
<p>Specifies the number of jobs that can be started for a specified job priority level.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of jobs started in a specific priority level does not change.
</dd>
</dl>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The number of jobs started in a specific priority level is not limited.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the number of jobs started in a specific priority level. A value of 0 indicates that no jobs are started from a specific priority level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.MAXPTY3"></a>
<h3>Max active priority 3 (MAXPTY3)</h3>
<p>Specifies the number of jobs that can be started for a specified job priority level.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of jobs started in a specific priority level does not change.
</dd>
</dl>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The number of jobs started in a specific priority level is not limited.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the number of jobs started in a specific priority level. A value of 0 indicates that no jobs are started from a specific priority level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.MAXPTY4"></a>
<h3>Max active priority 4 (MAXPTY4)</h3>
<p>Specifies the number of jobs that can be started for a specified job priority level.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of jobs started in a specific priority level does not change.
</dd>
</dl>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The number of jobs started in a specific priority level is not limited.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the number of jobs started in a specific priority level. A value of 0 indicates that no jobs are started from a specific priority level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.MAXPTY5"></a>
<h3>Max active priority 5 (MAXPTY5)</h3>
<p>Specifies the number of jobs that can be started for a specified job priority level.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of jobs started in a specific priority level does not change.
</dd>
</dl>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The number of jobs started in a specific priority level is not limited.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the number of jobs started in a specific priority level. A value of 0 indicates that no jobs are started from a specific priority level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.MAXPTY6"></a>
<h3>Max active priority 6 (MAXPTY6)</h3>
<p>Specifies the number of jobs that can be started for a specified job priority level.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of jobs started in a specific priority level does not change.
</dd>
</dl>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The number of jobs started in a specific priority level is not limited.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the number of jobs started in a specific priority level. A value of 0 indicates that no jobs are started from a specific priority level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.MAXPTY7"></a>
<h3>Max active priority 7 (MAXPTY7)</h3>
<p>Specifies the number of jobs that can be started for a specified job priority level.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of jobs started in a specific priority level does not change.
</dd>
</dl>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The number of jobs started in a specific priority level is not limited.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the number of jobs started in a specific priority level. A value of 0 indicates that no jobs are started from a specific priority level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.MAXPTY8"></a>
<h3>Max active priority 8 (MAXPTY8)</h3>
<p>Specifies the number of jobs that can be started for a specified job priority level.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of jobs started in a specific priority level does not change.
</dd>
</dl>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The number of jobs started in a specific priority level is not limited.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the number of jobs started in a specific priority level. A value of 0 indicates that no jobs are started from a specific priority level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGJOBQE.MAXPTY9"></a>
<h3>Max active priority 9 (MAXPTY9)</h3>
<p>Specifies the number of jobs that can be started for a specified job priority level.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of jobs started in a specific priority level does not change.
</dd>
</dl>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The number of jobs started in a specific priority level is not limited.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the number of jobs started in a specific priority level. A value of 0 indicates that no jobs are started from a specific priority level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGJOBQE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGJOBQE SBSD(QGPL/QBATCH) JOBQ(QGPL/QBATCH) MAXACT(4)
MAXPTY1(1) MAXPTY2(*NOMAX)
</pre>
</p>
<p>This command changes the maximum number of jobs that can be active at the same time from the job queue QBATCH in library QGPL. The sequence number of the job queue entry does not change. Up to four jobs from the QBATCH job queue can be active at the same time. Up to one job can be active from priority level 1. There is no maximum for the number of jobs that can be active at the same time from priority level 2. Priority levels 3 through 9 do not change.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGJOBQE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1619</b></dt>
<dd>Subsystem description &amp;1 in library &amp;2 damaged.
</dd>
<dt><b>CPF1691</b></dt>
<dd>Active subsystem description may or may not have changed.
</dd>
<dt><b>CPF1697</b></dt>
<dd>Subsystem description &amp;1 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGJOBQE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>