294 lines
11 KiB
HTML
294 lines
11 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>Change Prestart Job (CHGPJ)</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="CHGPJ.Top_Of_Page"></a>
|
||
|
|
<h2>Change Prestart Job (CHGPJ)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>Conditional
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#CHGPJ.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGPJ.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGPJ.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGPJ"></a>
|
||
|
|
<p>The Change Prestart Job (CHGPJ) command changes the job attributes of the prestart job in which this command is issued to those in the job description specified in the prestart job entry, or to those in the job description specified in the user profile of the current user. When a program start request is received, the system will set the current user to the user profile specified in the program start request. The current user may subsequently be set to a different value by the Set Profile (QWTSETP) API.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>To use this command, you must have:
|
||
|
|
<ul>
|
||
|
|
<li>use (*USE) authority to the job description and execute (*EXECUTE) authority to the library that contains that job description.
|
||
|
|
</li>
|
||
|
|
<li>read (*READ) authority to the output queue (OUTQ) and execute (*EXECUTE) authority to the library that contains that output queue.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>This command must only be called by a prestart job that is servicing a program start request. This command will not work against batch prestart jobs.
|
||
|
|
</li>
|
||
|
|
<li>This command is conditionally threadsafe. Refer to <b>Considerations for Attribute Thread Safety</b> for additional information.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p><b>Considerations for Attribute Thread Safety:</b>
|
||
|
|
</p>
|
||
|
|
<p>This command is intended to be used to change the job attributes for the prestart job that the command was issued in. All of the attributes are scoped to the job.
|
||
|
|
</p>
|
||
|
|
<p>The Threadsafe column of the following table indicates whether the attributes can be changed in a manner that is threadsafe.
|
||
|
|
</p>
|
||
|
|
<p><b>Yes:</b> - Attributes marked with this value are considered to be threadsafe. These attributes can be changed safely by issuing this command from either the initial thread or from a secondary thread.
|
||
|
|
</p>
|
||
|
|
<p><b>No:</b> - Attributes marked with this value are not threadsafe. An attempt to change these attributes will be denied if multiple threads are active.
|
||
|
|
</p>
|
||
|
|
<p><b>Attribute and Thread Safety Table:</b>
|
||
|
|
</p>
|
||
|
|
<table border="1">
|
||
|
|
<tr>
|
||
|
|
<td>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
Attribute Threadsafe
|
||
|
|
---------------------------- ----------
|
||
|
|
Job accounting code (ACGCDE) No
|
||
|
|
Output priority (OUTPTY) Yes
|
||
|
|
Output queue name (OUTQ) Yes
|
||
|
|
Print text (PRTTXT) Yes
|
||
|
|
Printer device name (PRTDEV) Yes
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGPJ.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="#CHGPJ.OUTPTY"><b>OUTPTY</b></a></td>
|
||
|
|
<td valign="top">Output priority (on OUTQ)</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *PGMSTRRQS, *PJE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGPJ.PRTTXT"><b>PRTTXT</b></a></td>
|
||
|
|
<td valign="top">Print text</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *PGMSTRRQS, *PJE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGPJ.PRTDEV"><b>PRTDEV</b></a></td>
|
||
|
|
<td valign="top">Print device</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *PGMSTRRQS, *PJE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGPJ.OUTQ"><b>OUTQ</b></a></td>
|
||
|
|
<td valign="top">Output queue</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *PGMSTRRQS, *PJE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGPJ.ACGCDE"><b>ACGCDE</b></a></td>
|
||
|
|
<td valign="top">Accounting code</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *PGMSTRRQS, *PJE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGPJ.OUTPTY"></a>
|
||
|
|
<h3>Output priority (on OUTQ) (OUTPTY)</h3>
|
||
|
|
<p>Specifies the output priority for spooled output files that are produced by this job. Only those spooled output files which are on output queues in the library name space of the thread issuing this command will be changed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>This value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PGMSTRRQS</b></dt>
|
||
|
|
<dd>The value specified in the job description for the user profile of the current user is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PJE</b></dt>
|
||
|
|
<dd>The value specified in the job description for the prestart job entry in the subsystem description is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGPJ.PRTTXT"></a>
|
||
|
|
<h3>Print text (PRTTXT)</h3>
|
||
|
|
<p>Specifies the text that is printed at the bottom of each page of printed output and on separator pages.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>This value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PGMSTRRQS</b></dt>
|
||
|
|
<dd>The value specified in the job description for the user profile of the current user is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PJE</b></dt>
|
||
|
|
<dd>The value specified in the job description for the prestart job entry in the subsystem description is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGPJ.PRTDEV"></a>
|
||
|
|
<h3>Print device (PRTDEV)</h3>
|
||
|
|
<p>Specifies the name of the default printer device for this job.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>This value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PGMSTRRQS</b></dt>
|
||
|
|
<dd>The value specified in the job description for the user profile of the current user is used. If *USRPRF is specified for this parameter value in the job description, the value from the user profile of the current user is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PJE</b></dt>
|
||
|
|
<dd>The value specified in the job description for the prestart job entry in the subsystem description is used. If *USRPRF is specified for this parameter value in the job description, the value from the user profile for the prestart job entry (USER parameter) is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGPJ.OUTQ"></a>
|
||
|
|
<h3>Output queue (OUTQ)</h3>
|
||
|
|
<p>Specifies the name of the output queue that is used for spooled output produced by the prestart job. This does not affect files previously created by the prestart job.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>This value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PGMSTRRQS</b></dt>
|
||
|
|
<dd>The value specified in the job description for the user profile of the current user is used. If *USRPRF is specified for this parameter value in the job description, the value specified in the user profile of the current user is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PJE</b></dt>
|
||
|
|
<dd>The value specified in the job description for the prestart job entry in the subsystem description is used. If *USRPRF is specified for this parameter value in the job description, the value specified in the user profile for the prestart job entry (USER parameter) is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGPJ.ACGCDE"></a>
|
||
|
|
<h3>Accounting code (ACGCDE)</h3>
|
||
|
|
<p>Specifies the accounting code that is used for this job.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The accounting code does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PGMSTRRQS</b></dt>
|
||
|
|
<dd>The value specified in the job description for the user profile of the current user is used. If *USRPRF is specified for this parameter value in the job description, the value specified in the user profile of the current user is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PJE</b></dt>
|
||
|
|
<dd>The value specified in the job description for the prestart job entry in the subsystem description is used. If *USRPRF is specified for this parameter value in the job description, the value specified in the user profile for the prestart job entry (USER parameter) is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGPJ.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Changing the Output Priority</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGPJ OUTPTY(*PGMSTRRQS)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the output priority for spooled files produced by this job to the output priority in the job description associated with the user profile of the current user.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Changing the Output Queue</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGPJ OUTQ(*PJE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the output queue for spooled files produced by this job to the output queue in the job description specified in the prestart job entry.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGPJ.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<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>CPF1321</b></dt>
|
||
|
|
<dd>Job &1 user &2 job number &3 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1332</b></dt>
|
||
|
|
<dd>End of duplicate job names.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1334</b></dt>
|
||
|
|
<dd>Must be an interactive job for requested change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1336</b></dt>
|
||
|
|
<dd>Errors on CHGJOB command for job &3/&2/&1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1337</b></dt>
|
||
|
|
<dd>&3/&2/&1 not authorized to change parameters.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1340</b></dt>
|
||
|
|
<dd>Job control function not performed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1341</b></dt>
|
||
|
|
<dd>Reader or writer &3/&2/&1 not allowed as job name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1343</b></dt>
|
||
|
|
<dd>Job &3/&2/&1 not valid job type for function.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1344</b></dt>
|
||
|
|
<dd>Not authorized to control job &3/&2/&1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1351</b></dt>
|
||
|
|
<dd>Function check occurred in subsystem for job &3/&2/&1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1352</b></dt>
|
||
|
|
<dd>Function not done. &3/&2/&1 in transition condition.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|