ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/strgrpjs.htm

192 lines
6.7 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Start Group using JS (STRGRPJS)</title>
</head>
<body bgcolor="white">
<a name="STRGRPJS.Top_Of_Page"></a>
<h2>Start Group using JS (STRGRPJS)</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="#STRGRPJS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRGRPJS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRGRPJS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRGRPJS"></a>
<p>The Start Group using Job Scheduler (STRGRPJS) command allows you to start a job group. The group will start with the first job you specify and submit all jobs that follow the job. For instance, if a group contains 10 jobs, and you specify sequence number 5 for the <b>Job (JOB)</b> parameter, then jobs 5 through 10 will be submitted as a result of the STRGRPJS command. If you want to process the entire group, you should specify the name of the job that has sequence number 1. You can specify the submission time and parameter data associated with the group.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRGRPJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRGRPJS.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="#STRGRPJS.JOB"><b>JOB</b></a></td>
<td valign="top">Job entry</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: Job</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top">Element 2: Group</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top">Element 3: Group sequence</td>
<td valign="top">
1-99</td>
</tr>
<tr>
<td valign="top"><a href="#STRGRPJS.TIME"><b>TIME</b></a></td>
<td valign="top">Submit time</td>
<td valign="top"><b><u>*SCHED</u></b>, *IMMED</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#STRGRPJS.PARM"><b>PARM</b></a></td>
<td valign="top">Parameters</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Parameter name</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top">Element 2: Parameter data</td>
<td valign="top">
<i>Character value</i></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#STRGRPJS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRGRPJS.JOB"></a>
<h3>Job entry (JOB)</h3>
<p>Specifies the name of the job, the group of which the job is a member and the sequence of the job within the group. You must specify all elements of the parameter.
</p>
<p>This is a required parameter.
</p>
<p><b>Element 1: Job</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job in the group that you want to submit.
</dd>
</dl>
<p><b>Element 2: Group</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the group that you are starting.
</dd>
</dl>
<p><b>Element 3: Group sequence</b>
</p>
<dl>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the sequence number of the job in the group that you want to start processing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRGRPJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRGRPJS.TIME"></a>
<h3>Submit time (TIME)</h3>
<p>Specifies the time that you want this group to be submitted. A group can be submitted immediately or at the next scheduled time.
</p>
<dl>
<dt><b><u>*SCHED</u></b></dt>
<dd>The group is to be submitted by Advanced Job Scheduler at the next scheduled time.
</dd>
<dt><b>*IMMED</b></dt>
<dd>The group is submitted immediately. This is the default for a sequence number greater than 1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRGRPJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRGRPJS.PARM"></a>
<h3>Parameters (PARM)</h3>
<p>Specifies the name of the parameter that you want to use for the submitted group. Parameters that you specify must be defined in Advanced Job Scheduler.
</p>
<p>Any character is valid for entry into this field. Validity will be checked to the extent of the use of the parameter within your programs or of the Advanced Job Scheduler job when submitted. The number of characters in the parameter data should correspond with the length placed in the <b>Parameter length</b>field when the parameter was added to Advanced Job Scheduler. Data entered in shorter length than the <b>Parameter length</b>field will pass data padded with blanks to the length of the parameter. Leading blanks and embedded blanks will be passed to the parameter in your request data exactly as keyed. Apostrophes ( ' ) used in parameter data must appear in pairs to be valid. If only one apostrophe is used, the parameter will be rejected with the error "Quotes ('') in Parameter Data Must Appear In Pairs". You must correct this error before continuing.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The group that you are submitting does require any parameters entered here.
</dd>
</dl>
<p><b>Other values (up to 50 repetitions)</b>
</p>
<p><b>Element 1: Parameter name</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the parameter that you want to use with this group.
</dd>
</dl>
<p><b>Element 2: Parameter data</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the parameter data for the parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRGRPJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRGRPJS.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
STRGRPJS JOB(JOB02 APDAILY 20) TIME(*IMMED)
</pre>
</p>
<p>This command starts a group called APDAILY immediately, starting with the job sequence number 20.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRGRPJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRGRPJS.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#STRGRPJS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>