254 lines
8.5 KiB
HTML
254 lines
8.5 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 Job (HLDJOB)</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="HLDJOB.Top_Of_Page"></a>
|
|
<h2>Hold Job (HLDJOB)</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="#HLDJOB.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#HLDJOB.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#HLDJOB.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="HLDJOB"></a>
|
|
<p>The Hold Job (HLDJOB) command makes a job ineligible for processing by the system. The job is held until it is:
|
|
</p>
|
|
<ul>
|
|
<li>Released by the Release Job (RLSJOB) command
|
|
</li>
|
|
<li>Cleared by the Clear Job Queue (CLRJOBQ) command
|
|
</li>
|
|
<li>Ended by the End Job (ENDJOB) command
|
|
</li>
|
|
<li>Ended (while the job is active) by the End Subsystem (ENDSBS) command, the End System (ENDSYS) command, or the Power Down System (PWRDWNSYS) command
|
|
</li>
|
|
</ul>
|
|
<p>Holding a job causes all threads within the job to be held.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If you use this command to hold a job that has exclusive access to any resources on the system, these resources are not available to other jobs. Other jobs which require access to those resources will either fail or wait indefinitely.
|
|
</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 held, 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="#HLDJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="HLDJOB.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="#HLDJOB.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="#HLDJOB.SPLFILE"><b>SPLFILE</b></a></td>
|
|
<td valign="top">Hold spooled files</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#HLDJOB.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="#HLDJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="HLDJOB.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the name of the job being held.
|
|
</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.
|
|
</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="#HLDJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="HLDJOB.SPLFILE"></a>
|
|
<h3>Hold spooled files (SPLFILE)</h3>
|
|
<p>Specifies whether spooled output files created by the job being held are also held.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The spooled output files produced by the job are not held.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The spooled output files produced by the job are also held. Only those spooled output files which are on output queues in the library name space of the thread issuing this command will be held. 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 Release Job (RLSJOB) command. To release spooled files after the job has been removed from the system, use the Release Spooled File (RLSSPLF) command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="HLDJOB.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="#HLDJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="HLDJOB.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Making a Job Ineligible for Processing</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
HLDJOB JOB(PAYROLL) SPLFILE(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command makes the job named PAYROLL ineligible for processing. All spooled files for this job are also held.
|
|
</p>
|
|
<p><b>Example 2: Holding a Job that has a Duplicate Name</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
HLDJOB JOB(DEPTXYZ/PAYROLL)
|
|
</pre>
|
|
</p>
|
|
<p>This command holds the job named PAYROLL submitted by a user operating under the user profile DEPTXYZ. The qualified form of the job name is used when jobs with duplicate names exist in the system. Spooled files are not held.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="HLDJOB.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1E52</b></dt>
|
|
<dd>Not authorized to hold job &1.
|
|
</dd>
|
|
<dt><b>CPF1E53</b></dt>
|
|
<dd>Job &1 has ended and cannot be held.
|
|
</dd>
|
|
<dt><b>CPF1E54</b></dt>
|
|
<dd>Job &1 cannot be held.
|
|
</dd>
|
|
<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>CPF1342</b></dt>
|
|
<dd>Current job not allowed as job name on this command.
|
|
</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>CPF1345</b></dt>
|
|
<dd>Cannot hold job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF1346</b></dt>
|
|
<dd>Job &3/&2/&1 already held.
|
|
</dd>
|
|
<dt><b>CPF1347</b></dt>
|
|
<dd>Cannot hold job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF1348</b></dt>
|
|
<dd>Job &3/&2/&1 held but unable to hold its files.
|
|
</dd>
|
|
<dt><b>CPF1350</b></dt>
|
|
<dd>SPLFILE(*NO) specified but job &3/&2/&1 on OUTQ.
|
|
</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>
|
|
<dt><b>CPF1378</b></dt>
|
|
<dd>Job &3/&2/&1 not held at current time.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|