227 lines
8.5 KiB
HTML
227 lines
8.5 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 Accounting Code (CHGACGCDE)</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="CHGACGCDE.Top_Of_Page"></a>
|
|
<h2>Change Accounting Code (CHGACGCDE)</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="#CHGACGCDE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGACGCDE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGACGCDE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGACGCDE"></a>
|
|
<p>The Change Accounting Code (CHGACGCDE) command changes the accounting code of a job. The job can be on a job queue, or it can be active in a subsystem. This command has no effect if the job is on an output queue. If the command is entered when system value QACGLVL indicated that job accounting (*JOB) should be performed when the job entered the system, accounting information is journaled and a new accounting segment is started for the job. If the command is entered when the system value QACGLVL did not indicate job accounting should be performed, the accounting code is changed, but no journal entry is made. More information is in the Work Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The command must be issued from within the job being changed, or the issuer of the command must be running under a user profile which is the same as the job user identity of the job being changed, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority.
|
|
<p>The job user identity is the name of the user profile by which a job is known to other jobs. More information about the job user identity is in the Work Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
</li>
|
|
<li>This command is conditionally thread safe. Access will be denied if the job being changed has secondary threads active. This command may be issued from either the initial thread or a secondary thread of a multi-threaded job if the target job is single threaded.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGACGCDE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGACGCDE.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="#CHGACGCDE.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CHGACGCDE.ACGCDE"><b>ACGCDE</b></a></td>
|
|
<td valign="top">Accounting code</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGACGCDE.DUPJOBOPT"><b>DUPJOBOPT</b></a></td>
|
|
<td valign="top">Duplicate job option</td>
|
|
<td valign="top"><b><u>*SELECT</u></b>, *MSG</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGACGCDE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGACGCDE.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the name of the job whose accounting code is changed.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The job whose accounting code is changed is the job where this command is issued.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Job name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job whose accounting code is changed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: User</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the user name that identifies the user profile under which the job is started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 3: Number</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>000000-999999</i></b></dt>
|
|
<dd>Specify the system-assigned job number.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>If no user name or job number is specified, all jobs currently in the system are searched for the job name. If more than one occurrence of the specified name is found, a qualified job name must be provided either explicitly or through the selection display. Refer to the <b>Duplicate job option (DUPJOBOPT)</b> parameter for more information.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGACGCDE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGACGCDE.ACGCDE"></a>
|
|
<h3>Accounting code (ACGCDE)</h3>
|
|
<p>Specifies the accounting code used for the job.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The accounting code is not changed; accounting information is recorded in a journal and a new accounting segment is started.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>The accounting code is changed to all blanks.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the 15-character accounting code used for the next accounting segment. The accounting code may contain alphabetic or numeric characters. Blanks may also be used if the accounting code is enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGACGCDE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGACGCDE.DUPJOBOPT"></a>
|
|
<h3>Duplicate job option (DUPJOBOPT)</h3>
|
|
<p>Specifies the action taken when duplicate jobs are found by this command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SELECT</u></b></dt>
|
|
<dd>The selection display is shown when duplicate jobs are found during an interactive session. Otherwise, a message is issued.
|
|
</dd>
|
|
<dt><b>*MSG</b></dt>
|
|
<dd>A message is issued when duplicate jobs are found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGACGCDE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGACGCDE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGACGCDE JOB(123581/USER47/WS1) ACGCDE(123456789)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the accounting code for job WS1, with user profile USER47, and job number 123581, to accounting code 123456789 for the next accounting segment. A job resource usage journal entry is written to the system accounting journal QSYS/QACGJRN.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGACGCDE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGACGCDE.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>
|
|
<dt><b>CPF180B</b></dt>
|
|
<dd>Function &1 not allowed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGACGCDE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|