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

188 lines
5.8 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>Start Prestart Jobs (STRPJ)</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="STRPJ.Top_Of_Page"></a>
<h2>Start Prestart Jobs (STRPJ)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>Yes
</td>
<td valign="top" align="right">
<a href="#STRPJ.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRPJ.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRPJ.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRPJ"></a>
<p>The Start Prestart Jobs (STRPJ) command starts jobs for a prestart job entry in an active subsystem when there are no currently active prestart jobs for the prestart job entry.
</p>
<p>This command is valid after an ENDPJ command is complete, or when all prestart jobs have been ended by the system due to an error or were never started during subsystem start up due to STRJOBS (*NO) on the ADDPJE command. The number of jobs started is determined by the INLJOBS value on the prestart job entry.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>To use this command, you must have:
<ul>
<li>job control (*JOBCTL) special authority.
</li>
<li>use (*USE) authority to the subsystem description.
</li>
<li>execute (*EXECUTE) authority to the library that contains the program.
</li>
</ul>
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRPJ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRPJ.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="#STRPJ.SBS"><b>SBS</b></a></td>
<td valign="top">Subsystem</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#STRPJ.PGM"><b>PGM</b></a></td>
<td valign="top">Program</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 2</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Program</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#STRPJ.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRPJ.SBS"></a>
<h3>Subsystem (SBS)</h3>
<p>Specifies the name of the active subsystem that contains the prestart job entry.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the active subsystem that contains the prestart job entry.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRPJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRPJ.PGM"></a>
<h3>Program (PGM)</h3>
<p>Specifies the name of the program that identifies the prestart job entry. This program name is used to match an incoming request.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Program</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the program that identifies the prestart job entry.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the thread's library list are searched until a match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the program's library.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRPJ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRPJ.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
STRPJ SBS(SBS1) PGM(PJLIB/PJPGM)
</pre>
</p>
<p>This command starts prestart jobs for prestart job entry PJPGM in subsystem SBS1. Subsystem SBS1 must be active when this command is issued. The number of jobs started is the number specified in the INLJOBS value of prestart job entry PJPGM. The subsystem starts program PJPGM in library PJLIB.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRPJ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRPJ.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF0921</b></dt>
<dd>Start Prestart Jobs command not allowed now.
</dd>
<dt><b>CPF1226</b></dt>
<dd>Start prestart jobs failed.
</dd>
<dt><b>CPF1227</b></dt>
<dd>No authority has been granted to use command.
</dd>
<dt><b>CPF1317</b></dt>
<dd>No response from subsystem for job &amp;3/&amp;2/&amp;1.
</dd>
<dt><b>CPF1351</b></dt>
<dd>Function check occurred in subsystem for job &amp;3/&amp;2/&amp;1.
</dd>
<dt><b>CPF1834</b></dt>
<dd>Prestart job entry for program &amp;1 in &amp;2 does not exist.
</dd>
<dt><b>CPF1835</b></dt>
<dd>Not authorized to subsystem description.
</dd>
<dt><b>CPF9810</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF9811</b></dt>
<dd>Program &amp;1 in library &amp;2 not found.
</dd>
<dt><b>CPF9820</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
<dt><b>CPF9821</b></dt>
<dd>Not authorized to program &amp;1 in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRPJ.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>