xcu_chap03.html

IEEE 1003.1-2003, Single Unix Specification v3

</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">H</p>
</td>
<td align="center">
<p class="tent">R/H</p>
</td>
<td align="center">
<p class="tent">H</p>
</td>
<td align="center">
<p class="tent">H</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>Release 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">Q/W/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 Shutdown 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">Q</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>Locate 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>
</table>
</center>

<h5><a name="tag_03_02_02_02"></a>Legend</h5>

<dl compact>
<dt>X</dt>

<dd>Nonexistent</dd>

<dt>Q</dt>

<dd>QUEUED</dd>

<dt>R</dt>

<dd>RUNNING</dd>

<dt>H</dt>

<dd>HELD</dd>

<dt>W</dt>

<dd>WAITING</dd>

<dt>E</dt>

<dd>EXITING</dd>

<dt>T</dt>

<dd>TRANSITING</dd>

<dt>e</dt>

<dd>Error</dd>
</dl>

<p>A batch server that has an execution queue containing jobs is said to own the queue and manage the batch jobs in that queue. A
batch server that has been started shall execute the batch jobs in the execution queues owned by the batch server. The batch server
shall schedule for execution those jobs in the execution queues that are in the QUEUED state. The algorithm for scheduling jobs is
implementation-defined.</p>

<p>A batch server that executes a batch job shall create, in the environment of the session leader of the batch job, an environment
variable named <i>PBS_ENVIRONMENT ,</i> the value of which is the string PBS_BATCH encoded in the portable character set.</p>

<p>A batch server that executes a batch job shall create, in the environment of the session leader of the batch job, an environment
variable named <i>PBS_QUEUE ,</i> the value of which is the name of the execution queue of the batch job encoded in the portable
character set.</p>

<p>To rerun a batch job is to requeue a batch job that is currently executing and then kill the session leader of the executing job
by sending a SIGKILL prior to completion; see <a href="#tag_03_02_03_11">Rerun Batch Job Request</a> . A batch server that reruns a
batch job shall append the standard output and standard error files of the batch job to the corresponding files of the previous
execution, if they exist, with appropriate annotation. If either file does not exist, that file shall be created as in normal
execution.<br>
</p>

<center><b><a name="tagtcjh_9"></a> Table: Results/Output 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">O</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">O</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</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>Delete Batch Job Request</i></p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">O</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">e</p>
</td>
<td align="center">
<p class="tent">O</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>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">O</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">O</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>Batch Job Status Request</i></p>
</td>
<td align="center">
<p class="tent">e</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</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">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
<td align="center">
<p class="tent">O</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><i>Server Status Request</i></p>
</td>