xcu_chap03.html

IEEE 1003.1-2003, Single Unix Specification v3

<p>When the session leader associated with a running job exits, the batch job shall be placed in the EXITING state.</p>

<p>A batch job for which the session leader has terminated is defined to be in the EXITING state, and the batch server that manages
such a batch job cannot accept job modification requests that affect the batch job. While a batch job is in the EXITING state, the
batch server that manages the batch job is staging output files and notifying clients of job completion. Once a batch job has
exited, it no longer exists as an object managed by a batch server.</p>

<p>A batch job that is being moved from a routing queue to another queue is defined to be in the TRANSITING state.</p>

<p>When a batch job in a routing queue has been selected to be moved to a new destination, then the batch job shall be in either
the QUEUED state or the TRANSITING state, depending on the batch server implementation.</p>

<p>Batch jobs with either an <i>Execution_Time</i> attribute value set in the future or a <i>Hold_Types</i> attribute of value not
equal to NO_HOLD, or both, may be routed or held in the routing queue. The treatment of jobs with the <i>Execution_Time</i> or
<i>Hold_Types</i> attributes in a routing queue is implementation-defined.</p>

<p>When a batch job in a routing queue has not been selected to be moved to a new destination and the batch job has a
<i>Hold_Types</i> attribute value of other than NO_HOLD, then the job should be in the HELD state. <basefont size="2"></p>

<dl>
<dt><b>Note:</b></dt>

<dd>The effect of a hold upon a batch job in a routing queue is implementation-defined. The implementation should use the state
that matches whether the batch job can route with a hold or not.</dd>
</dl>

<basefont size="3"> 

<p>When a batch job in a routing queue has not been selected to be moved to a new destination and the batch job has:</p>

<ul>
<li>
<p>A <i>Hold_Types</i> attribute value of NO_HOLD</p>
</li>

<li>
<p>An <i>Execution_Time</i> attribute in the past</p>
</li>
</ul>

<p>then the batch job shall be in the QUEUED state.</p>

<p>When a batch job in a routing queue has not been selected to be moved to a new destination and the batch job has:</p>

<ul>
<li>
<p>A <i>Hold_Types</i> attribute value of NO_HOLD</p>
</li>

<li>
<p>An <i>Execution_Time</i> attribute in the future</p>
</li>
</ul>

<p>then the batch job may be in the WAITING state. <basefont size="2"></p>

<dl>
<dt><b>Note:</b></dt>

<dd>The effect of a future execution time upon a batch job in a routing queue is implementation-defined. The implementation should
use the state that matches whether the batch job can route with a hold or not.</dd>
</dl>

<basefont size="3"> 

<p><a href="#tagtcjh_8">Next State Table</a> describes the next state of a batch job, given the current state of the batch job and
the type of request. <a href="#tagtcjh_9">Results/Output Table</a> describes the response of a batch server to a request, given the
current state of the batch job and the type of request.</p>

<h4><a name="tag_03_02_02"></a>Deferred Batch Services</h4>

<p>This section describes the deferred services performed by batch servers: job execution, job routing, job exit, job abort, and
the rerunning of jobs after a restart.</p>

<h5><a name="tag_03_02_02_01"></a>Batch Job Execution</h5>

<p>To execute a batch job is to create a session leader (a process) that runs the shell program indicated by the
<i>Shell_Path_List</i> attribute of the batch job. The script is passed to the program as its standard input. An implementation may
pass the script to the program by other implementation-defined means. At the time a batch job begins execution, it is defined to
enter the RUNNING state.<br>
</p>

<center><b><a name="tagtcjh_8"></a> Table: Next State Table</b></center>

<center>
<table border="1" cellpadding="3" align="center">
<tr valign="top">
<th align="center">
<p class="tent"><b>&nbsp;</b></p>
</th>
<th colspan="7" align="center">
<p class="tent"><b>Current State</b></p>
</th>
</tr>

<tr valign="top">
<th align="center">
<p class="tent"><b>&nbsp;</b></p>
</th>
<th colspan="7" align="center">
<p class="tent"><b>_</b></p>
</th>
</tr>

<tr valign="top">
<th align="center">
<p class="tent"><b>Request Type</b></p>
</th>
<th align="center">
<p class="tent"><b>X</b></p>
</th>
<th align="center">
<p class="tent"><b>Q</b></p>
</th>
<th align="center">
<p class="tent"><b>R</b></p>
</th>
<th align="center">
<p class="tent"><b>H</b></p>
</th>
<th align="center">
<p class="tent"><b>W</b></p>
</th>
<th align="center">
<p class="tent"><b>E</b></p>
</th>
<th align="center">
<p class="tent"><b>T</b></p>
</th>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Queue Batch Job Request</i></p>
</td>
<td align="center">
<p class="tent">Q</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Modify Batch Job Request</i></p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">Q</p>
</td>
<td align="center">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">H</p>
</td>
<td align="center">
<p class="tent">W</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">T</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Delete Batch Job Request</i></p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">X</p>
</td>
<td align="center">
<p class="tent">E</p>
</td>
<td align="center">
<p class="tent">X</p>
</td>
<td align="center">
<p class="tent">X</p>
</td>
<td align="center">
<p class="tent">E</p>
</td>
<td align="center">
<p class="tent">X</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Batch Job Message Request</i></p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">Q</p>
</td>
<td align="center">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">H</p>
</td>
<td align="center">
<p class="tent">W</p>
</td>
<td align="center">
<p class="tent">E</p>
</td>
<td align="center">
<p class="tent">T</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Rerun Batch Job Request</i></p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">Q</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Signal Batch Job Request</i></p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">H</p>
</td>
<td align="center">
<p class="tent">W</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Batch Job Status Request</i></p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">Q</p>
</td>
<td align="center">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">H</p>
</td>
<td align="center">
<p class="tent">W</p>
</td>
<td align="center">
<p class="tent">E</p>
</td>
<td align="center">
<p class="tent">T</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Batch Queue Status Request</i></p>
</td>
<td align="center">
<p class="tent">X</p>
</td>
<td align="center">
<p class="tent">Q</p>
</td>
<td align="center">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">H</p>
</td>
<td align="center">
<p class="tent">W</p>
</td>
<td align="center">
<p class="tent">E</p>
</td>
<td align="center">
<p class="tent">T</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Server Status Request</i></p>
</td>
<td align="center">
<p class="tent">X</p>
</td>
<td align="center">
<p class="tent">Q</p>
</td>
<td align="center">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">H</p>
</td>
<td align="center">
<p class="tent">W</p>
</td>
<td align="center">
<p class="tent">E</p>
</td>
<td align="center">
<p class="tent">T</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Select Batch Jobs Request</i></p>
</td>
<td align="center">
<p class="tent">X</p>
</td>
<td align="center">
<p class="tent">Q</p>
</td>
<td align="center">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">H</p>
</td>
<td align="center">
<p class="tent">W</p>
</td>
<td align="center">
<p class="tent">E</p>
</td>
<td align="center">
<p class="tent">T</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Move Batch Job Request</i></p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">Q</p>
</td>
<td align="center">
<p class="tent">R</p>
</td>
<td align="center">
<p class="tent">H</p>
</td>
<td align="center">
<p class="tent">W</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">T</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Hold Batch Job Request</i></p>