198 lines
6.3 KiB
HTML
198 lines
6.3 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 Group Job (ENDGRPJOB)</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="ENDGRPJOB.Top_Of_Page"></a>
|
|
<h2>End Group Job (ENDGRPJOB)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#ENDGRPJOB.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ENDGRPJOB.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ENDGRPJOB.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ENDGRPJOB"></a>
|
|
<p>The End Group Job (ENDGRPJOB) command ends a single job within a group and resumes another job within the group. You can specify the following:
|
|
</p>
|
|
<ul>
|
|
<li>Which job in the group is ended
|
|
</li>
|
|
<li>Which job in the group gains control (this is valid only when a job is ending itself)
|
|
</li>
|
|
<li>Whether a job log is created for the job being ended
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDGRPJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ENDGRPJOB.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"><a href="#ENDGRPJOB.GRPJOB"><b>GRPJOB</b></a></td>
|
|
<td valign="top">Group job</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDGRPJOB.RSMGRPJOB"><b>RSMGRPJOB</b></a></td>
|
|
<td valign="top">Group job to be resumed</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDGRPJOB.LOG"><b>LOG</b></a></td>
|
|
<td valign="top">Job log</td>
|
|
<td valign="top"><b><u>*NOLIST</u></b>, *LIST</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDGRPJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ENDGRPJOB.GRPJOB"></a>
|
|
<h3>Group job (GRPJOB)</h3>
|
|
<p>Specifies the group job name of the job being ended.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The group job that issued this command is ended.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the group job name of the job being ended.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDGRPJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDGRPJOB.RSMGRPJOB"></a>
|
|
<h3>Group job to be resumed (RSMGRPJOB)</h3>
|
|
<p>Specifies the group job name of the job that is resumed after the active job in the group has ended. This parameter is valid only when the job that issues this command is ending itself.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRV</u></b></dt>
|
|
<dd>The most recently active group job is resumed.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the group job name of the job that is resumed after the active job in the group ends.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDGRPJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDGRPJOB.LOG"></a>
|
|
<h3>Job log (LOG)</h3>
|
|
<p>Specifies whether to produce the job log for the ending group job.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOLIST</u></b></dt>
|
|
<dd>The information in the job log is not spooled to an output queue.
|
|
</dd>
|
|
<dt><b>*LIST</b></dt>
|
|
<dd>The information in the job log is spooled to an output queue.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDGRPJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDGRPJOB.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Ending Group Job that Issued Command</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDGRPJOB GRPJOB(*) LOG(*LIST) RSMGRPJOB(GROUPJOB1)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends the job that is currently running. Its job log is spooled to an output file for printing. When the job completes running, group job GROUPJOB1 becomes the active job in the group.
|
|
</p>
|
|
<p><b>Example 2: Printing Output of Ended Job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDGRPJOB GRPJOB(GROUPJOB2) LOG(*LIST)
|
|
</pre>
|
|
</p>
|
|
<p>Assume that the job issuing the ENDGRPJOB command is group job GROUPJOB1, which wants to end GROUPJOB2. Group job GROUPJOB2 ends. Its job log is spooled to an output file for printing.
|
|
</p>
|
|
<p><b>Example 3: Ending a Job That's Part of a Secondary Job Pair</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDGRPJOB GRPJOB(*) LOG(*NOLIST)
|
|
</pre>
|
|
</p>
|
|
<p>Assume that the job issuing the ENDGRPJOB command is the only job in the group and is part of a secondary job pair. The job issuing the command ends. The job's job log is not spooled to an output file. When the job ends, the other job in the secondary job pair is resumed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDGRPJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDGRPJOB.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1309</b></dt>
|
|
<dd>Subsystem cannot complete the &1 command.
|
|
</dd>
|
|
<dt><b>CPF1314</b></dt>
|
|
<dd>Value &1 for parameter &2 not allowed.
|
|
</dd>
|
|
<dt><b>CPF1317</b></dt>
|
|
<dd>No response from subsystem for job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF1322</b></dt>
|
|
<dd>The End Group Job command not allowed at this time.
|
|
</dd>
|
|
<dt><b>CPF1323</b></dt>
|
|
<dd>Group job &1 not ended; parameters do not agree.
|
|
</dd>
|
|
<dt><b>CPF1324</b></dt>
|
|
<dd>Group job &1 not ended; parameters do not agree.
|
|
</dd>
|
|
<dt><b>CPF1325</b></dt>
|
|
<dd>Group job &1 not ended; group job &2 does not exist.
|
|
</dd>
|
|
<dt><b>CPF1326</b></dt>
|
|
<dd>Group job &1 does not exist.
|
|
</dd>
|
|
<dt><b>CPF1327</b></dt>
|
|
<dd>Cannot end group job &1 with ENDGRPJOB.
|
|
</dd>
|
|
<dt><b>CPF1351</b></dt>
|
|
<dd>Function check occurred in subsystem for job &3/&2/&1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDGRPJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|