270 lines
9.4 KiB
HTML
270 lines
9.4 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>Create Job Queue (CRTJOBQ)</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="CRTJOBQ.Top_Of_Page"></a>
|
||
|
|
<h2>Create Job Queue (CRTJOBQ)</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="#CRTJOBQ.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTJOBQ.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTJOBQ.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTJOBQ"></a>
|
||
|
|
<p>The Create Job Queue (CRTJOBQ) command creates a new job queue. A job queue contains entries for jobs that are waiting to be processed by the system. Jobs can be placed on a job queue by using any of the following commands:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Start Database Reader (STRDBRDR)
|
||
|
|
</li>
|
||
|
|
<li>Start Diskette Reader (STRDKTRDR)
|
||
|
|
</li>
|
||
|
|
<li>Start Printer Writer (STRPRTWTR)
|
||
|
|
</li>
|
||
|
|
<li>Start Diskette Writer (STRDKTWTR)
|
||
|
|
</li>
|
||
|
|
<li>Submit Job (SBMJOB)
|
||
|
|
</li>
|
||
|
|
<li>Submit Database Jobs (SBMDBJOB)
|
||
|
|
</li>
|
||
|
|
<li>Submit Diskette Jobs (SBMDKTJOB)
|
||
|
|
</li>
|
||
|
|
<li>Transfer Job (TFRJOB)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>After you create a new job queue, you must add an entry for it in the appropriate subsystem description. To do this use the Add Job Queue Entry (ADDJOBQE) command.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTJOBQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTJOBQ.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="#CRTJOBQ.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>*CURLIB</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CRTJOBQ.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTJOBQ.OPRCTL"><b>OPRCTL</b></a></td>
|
||
|
|
<td valign="top">Operator controlled</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTJOBQ.AUTCHK"><b>AUTCHK</b></a></td>
|
||
|
|
<td valign="top">Authority to check</td>
|
||
|
|
<td valign="top"><b><u>*OWNER</u></b>, *DTAAUT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTJOBQ.AUT"><b>AUT</b></a></td>
|
||
|
|
<td valign="top">Authority</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*USE</u></b>, *ALL, *CHANGE, *EXCLUDE, *LIBCRTAUT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTJOBQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTJOBQ.JOBQ"></a>
|
||
|
|
<h3>Job queue (JOBQ)</h3>
|
||
|
|
<p>Specifies the job queue being created.
|
||
|
|
</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 you want for the job queue being created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURLIB</u></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 library where the job queue is to be located.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The temporary library QTEMP is not a valid library name. Job queues must be in permanent libraries.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTJOBQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTJOBQ.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies the text that briefly describes the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>No text is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'description'</i></b></dt>
|
||
|
|
<dd>Specify no more than 50 characters, enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTJOBQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTJOBQ.OPRCTL"></a>
|
||
|
|
<h3>Operator controlled (OPRCTL)</h3>
|
||
|
|
<p>Specifies whether a user who has job control authority is allowed to control this job queue.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>A user with job control authority can control the queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>This queue cannot be controlled by users with job control authority unless they also have some other special authority.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTJOBQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTJOBQ.AUTCHK"></a>
|
||
|
|
<h3>Authority to check (AUTCHK)</h3>
|
||
|
|
<p>Specifies what type of authorities to the job queue allow the user to control the job queue by holding or releasing the queue. Users with some special authority may also be able to control the job queue.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*OWNER</u></b></dt>
|
||
|
|
<dd>The requester must have ownership authority to the job queue to pass the job queue authorization test. The requester can have ownership authority by being the owner of the job queue, sharing a group profile with the job queue owner, or running a program that adopts the job queue owner's authority.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DTAAUT</b></dt>
|
||
|
|
<dd>Any user with add, read, and delete authority to the job queue can control the queue.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTJOBQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTJOBQ.AUT"></a>
|
||
|
|
<h3>Authority (AUT)</h3>
|
||
|
|
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*USE</u></b></dt>
|
||
|
|
<dd>Use authority allows the user to perform basic operations on the job queue, such as submit jobs to this queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CHANGE</b></dt>
|
||
|
|
<dd>Change authority allows the user to control jobs submitted by other users if *DTAAUT was specified on the <b>Authority to check (AUTCHK)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*EXCLUDE</b></dt>
|
||
|
|
<dd>The user cannot access the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LIBCRTAUT</b></dt>
|
||
|
|
<dd>The authority for the object is the same as the value specified on the <b>Create authority (CRTAUT)</b> parameter of the library in which the object is being created. If the value specified on the CRTAUT parameter is changed, the new value will not affect any existing objects.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTJOBQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTJOBQ.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTJOBQ JOBQ(DEPTA) AUT(*EXCLUDE)
|
||
|
|
TEXT('Special queue for Dept A jobs')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a job queue named DEPTA and puts it in the current library. Because AUT(*EXCLUDE) is specified and OPRCTL(*YES) is assumed, the job queue is used and controlled only by the user who created the queue and by users with job control authority (*JOBCTL). Also, users with spool control authority (*SPLCTL) can control the queue.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTJOBQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTJOBQ.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF2182</b></dt>
|
||
|
|
<dd>Not authorized to library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2192</b></dt>
|
||
|
|
<dd>Object &1 cannot be created into library &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2207</b></dt>
|
||
|
|
<dd>Not authorized to use object &1 in library &3 type *&2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3323</b></dt>
|
||
|
|
<dd>Job queue &1 in &2 already exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3351</b></dt>
|
||
|
|
<dd>Temporary library &1 invalid for job queue &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3354</b></dt>
|
||
|
|
<dd>Library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3356</b></dt>
|
||
|
|
<dd>Cannot allocate library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3371</b></dt>
|
||
|
|
<dd>Spool user profile QSPL damaged or not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9818</b></dt>
|
||
|
|
<dd>Object &2 in library &3 not created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTJOBQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|