190 lines
7.1 KiB
HTML
190 lines
7.1 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 Job (RLSJOB)</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="RLSJOB.Top_Of_Page"></a>
|
|
<h2>Release Job (RLSJOB)</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="#RLSJOB.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RLSJOB.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RLSJOB.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RLSJOB"></a>
|
|
<p>The Release Job (RLSJOB) command makes a job eligible for processing either after that job is held from processing by the Hold Job (HLDJOB) command, or if the job was submitted to the system as a held job by the Batch Job (BCHJOB) command or Submit Job (SBMJOB) command. The job being released can be on the job queue, on an output queue, or active in a subsystem (competing for system resources) when it is held. Releasing a job causes all threads within the job to be released. Spooled output files being held because *YES is specified for the <b>Hold spooled files</b> (SPLFILE) parameter in the Hold Job (HLDJOB) command are also released. Only those spooled output files which are on output queues in the library name space of the thread issuing this command (RLSJOB) will be released. If the <b>Spooled file action (SPLFACN)</b> job attribute is *DETACH and the job is ended while the spooled files are held, the spooled files cannot be released using the RLSJOB command. To release spooled files after the job has been removed from the system, use the Release Spooled File (RLSSPLF) command.
|
|
</p>
|
|
<p><b>Restrictions:</b> The issuer of the command must be running under a user profile which is the same as the job user identity of the job being released, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority.
|
|
</p>
|
|
<p>The job user identity is the name of the user profile by which a job is known to other jobs. It is described in more detail in the Work Management book.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RLSJOB.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="4"><a href="#RLSJOB.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top"><i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#RLSJOB.DUPJOBOPT"><b>DUPJOBOPT</b></a></td>
|
|
<td valign="top">Duplicate job option</td>
|
|
<td valign="top"><b><u>*SELECT</u></b>, *MSG</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RLSJOB.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the name of the job being released.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Job name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job being released.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: User</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the user name that identifies the user profile under which the job is started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 3: Number</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>000000-999999</i></b></dt>
|
|
<dd>Specify the system-assigned job number.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>If no user name or job number is specified, all jobs currently in the system are searched for the job name. If more than one occurrence of the specified name is found, a qualified job name must be provided either explicitly or through the selection display. Refer to the <b>Duplicate job option (DUPJOBOPT)</b> parameter for more information.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RLSJOB.DUPJOBOPT"></a>
|
|
<h3>Duplicate job option (DUPJOBOPT)</h3>
|
|
<p>Specifies the action taken when duplicate jobs are found by this command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SELECT</u></b></dt>
|
|
<dd>The selection display is shown when duplicate jobs are found during an interactive session. Otherwise, a message is issued.
|
|
</dd>
|
|
<dt><b>*MSG</b></dt>
|
|
<dd>A message is issued when duplicate jobs are found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RLSJOB.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Releasing a Job for Processing</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RLSJOB JOB(PAYROLL)
|
|
</pre>
|
|
</p>
|
|
<p>This command releases the job PAYROLL for processing. If the corresponding HLDJOB command had specified SPLFILE(*YES), any spooled files for job PAYROLL are also released.
|
|
</p>
|
|
<p><b>Example 2: Releasing a Job for Processing</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RLSJOB JOB(DEPTXYZ/PAYROLL)
|
|
</pre>
|
|
</p>
|
|
<p>This command releases job name PAYROLL that was submitted by a user through the user profile DEPTXYZ and later held. The qualified form of the job name is used when jobs with duplicate names exist in the system.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RLSJOB.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>CPF1321</b></dt>
|
|
<dd>Job &1 user &2 job number &3 not found.
|
|
</dd>
|
|
<dt><b>CPF1332</b></dt>
|
|
<dd>End of duplicate job names.
|
|
</dd>
|
|
<dt><b>CPF1340</b></dt>
|
|
<dd>Job control function not performed.
|
|
</dd>
|
|
<dt><b>CPF1341</b></dt>
|
|
<dd>Reader or writer &3/&2/&1 not allowed as job name.
|
|
</dd>
|
|
<dt><b>CPF1343</b></dt>
|
|
<dd>Job &3/&2/&1 not valid job type for function.
|
|
</dd>
|
|
<dt><b>CPF1344</b></dt>
|
|
<dd>Not authorized to control job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF1349</b></dt>
|
|
<dd>Job &3/&2/&1 not released, the job is not held.
|
|
</dd>
|
|
<dt><b>CPF1351</b></dt>
|
|
<dd>Function check occurred in subsystem for job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF1352</b></dt>
|
|
<dd>Function not done. &3/&2/&1 in transition condition.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RLSJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|