234 lines
11 KiB
HTML
234 lines
11 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>End Job Abnormal (ENDJOBABN)</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="ENDJOBABN.Top_Of_Page"></a>
|
||
|
|
<h2>End Job Abnormal (ENDJOBABN)</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="#ENDJOBABN.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#ENDJOBABN.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#ENDJOBABN.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="ENDJOBABN"></a>
|
||
|
|
<p>The End Job Abnormal (ENDJOBABN) command ends a job that cannot be ended successfully by running the End Job (ENDJOB) command with *IMMED specified for the <b>How to end (OPTION)</b> parameter. The ENDJOBABN command cannot be issued against a job until 10 minutes have passed following the request for immediate ending. This allows sufficient time for normal job ending functions to be attempted.
|
||
|
|
</p>
|
||
|
|
<p>When the ENDJOBABN command is issued, most of the end-of-job processing is bypassed (including spooling of the job log, the end of job display for interactive jobs, and the end-of-job processing for the specific functions that are being performed). The part of the end-of-job processing that is attempted is allowed only five minutes to complete. If it does not do so in five minutes, the job is forced to end at that point. Because some of the job cleanup is not performed, the ENDJOBABN command should only be used when a job that is in the process of immediate ending does not finish ending and resources in use by the job are needed by another job or by the system. When the ENDJOBABN command is used, some resources in use by the ended job may be left unavailable until the next IPL.
|
||
|
|
</p>
|
||
|
|
<p>Use of the ENDJOBABN command causes the next system end to be marked as ABNORMAL. Certain system functions are then called during the subsequent IPL to clear up conditions that may have resulted from running the ENDJOBABN command. This does not, however, cause any machine recovery functions to be called, nor do any access paths need to be rebuilt. Some storage in use by the job may become unavailable after the ENDJOBABN command is run and that available storage can be reclaimed by using the Reclaim Storage (RCLSTG) command.
|
||
|
|
</p>
|
||
|
|
<p>Bypassing the job log writing process causes the job to have the status of JOBLOG PENDING (as shown on the DSPJOB status attributes display) after it has been ended with the ENDJOBABN command. The job log writing is not performed until the next IPL. However, the contents of the job log can be printed or shown by using the Display Job Log (DSPJOBLOG) command.
|
||
|
|
</p>
|
||
|
|
<p>When the ENDJOBABN command is run, the following functions are performed successfully:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Journaling entries
|
||
|
|
</li>
|
||
|
|
<li>Commitment control
|
||
|
|
<p>Before ending the job abnormally, you should verify that no logical unit of work is in an in doubt state due to a two-phase commit operation that is in progress. If it is, then pending committable changes at this system will not be committed or rolled back. Therefore, database integrity may not be maintained on all related systems. For specific instructions on how to determine these conditions, and for a description of all the impacts of ending this job abnormally under these conditions, see the Commitment control article in the Information Center.
|
||
|
|
</p>
|
||
|
|
</li>
|
||
|
|
<li>Making database files available for use by others
|
||
|
|
</li>
|
||
|
|
<li>Releasing file locks
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>This command fails to end a job or takes more than five minutes to do so in the following situations:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>When the job runs under a subsystem monitor that is hung, is abnormally slow, or has ended abnormally (the subsystem monitor performs part of the ending function).
|
||
|
|
</li>
|
||
|
|
<li>When the machine interface (MI) instruction running in the job is hung or is abnormally slow. The job cannot end until the MI instruction that is currently running completes or reaches a point of interruption.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>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 ended, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority. 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.
|
||
|
|
</li>
|
||
|
|
<li>After the ENDJOBABN command is run, subsequent ENDJOBABN commands cannot be issued against the job.
|
||
|
|
</li>
|
||
|
|
<li>Users cannot end a reader, writer, subsystem monitor, or system job.
|
||
|
|
</li>
|
||
|
|
<li>Users cannot run the ENDJOBABN command until ten minutes after immediate ending of the job is started. Immediate ending of the job is started in the following ways:
|
||
|
|
<ul>
|
||
|
|
<li>When the End Job (ENDJOB) command with OPTION(*CNTRLD) is specified and the delay time ends.
|
||
|
|
</li>
|
||
|
|
<li>When the ENDJOB command with OPTION(*IMMED) is issued.
|
||
|
|
</li>
|
||
|
|
<li>When the End Subsystem (ENDSBS) command with OPTION(*CNTRLD) is issued against the subsystem in which the job is running and the delay time ends.
|
||
|
|
</li>
|
||
|
|
<li>When the ENDSBS command with OPTION(*IMMED) is issued against the subsystem in which the job is running.
|
||
|
|
</li>
|
||
|
|
<li>When the End System (ENDSYS) command with OPTION(*IMMED) is issued, or OPTION(*CNTRLD) is issued and the delay time ends.
|
||
|
|
</li>
|
||
|
|
<li>When the Power Down System (PWRDWNSYS) command with OPTION(*IMMED) is issued.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>If the job defines a handler for the asynchronous signal SIGTERM, the immediate ending of the job was delayed to allow the SIGTERM signal handler to run. For more information, refer to system value QENDJOBLMT. An ENDJOBABN command is not allowed while the SIGTERM signal handler is running. If the SIGTERM signal handler has run for at least 2 minutes, use ENDJOB command with OPTION(*IMMED) to stop the SIGTERM signal handler.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJOBABN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="ENDJOBABN.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="#ENDJOBABN.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="#ENDJOBABN.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="#ENDJOBABN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="ENDJOBABN.JOB"></a>
|
||
|
|
<h3>Job name (JOB)</h3>
|
||
|
|
<p>Specifies the qualified job name of the job to be ended.
|
||
|
|
</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 run.
|
||
|
|
</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="#ENDJOBABN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJOBABN.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="#ENDJOBABN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ENDJOBABN.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ENDJOBABN JOB(000310/SMITH/PAYROLL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command ends the batch job 000310/SMITH/PAYROLL after the failure of an earlier attempt to end it with the ENDJOB command. The ENDJOBABN command can be issued only after waiting at least ten minutes for the job to end after issuing the ENDJOB command.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJOBABN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ENDJOBABN.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>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>CPF1351</b></dt>
|
||
|
|
<dd>Function check occurred in subsystem for job &3/&2/&1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1359</b></dt>
|
||
|
|
<dd>ENDJOBABN not allowed at this time for job &3/&2/&1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1360</b></dt>
|
||
|
|
<dd>&3/&2/&1 already ending because of ENDJOBABN.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1362</b></dt>
|
||
|
|
<dd>Job &3/&2/&1 has completed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJOBABN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|