350 lines
11 KiB
HTML
350 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>Work with Job (WRKJOB)</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="WRKJOB.Top_Of_Page"></a>
|
||
|
|
<h2>Work with Job (WRKJOB)</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="#WRKJOB.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#WRKJOB.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#WRKJOB.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="WRKJOB"></a>
|
||
|
|
<p>The Work with Job (WRKJOB) command allows you to work with or change the following information concerning a user job:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Job status attributes
|
||
|
|
</li>
|
||
|
|
<li>Job definition attributes
|
||
|
|
</li>
|
||
|
|
<li>Job run attributes
|
||
|
|
</li>
|
||
|
|
<li>Spooled file information
|
||
|
|
</li>
|
||
|
|
<li>Job log information
|
||
|
|
</li>
|
||
|
|
<li>Call stack information
|
||
|
|
</li>
|
||
|
|
<li>Job lock information
|
||
|
|
</li>
|
||
|
|
<li>Library list information
|
||
|
|
</li>
|
||
|
|
<li>Open file information
|
||
|
|
</li>
|
||
|
|
<li>File override information
|
||
|
|
</li>
|
||
|
|
<li>Commitment control status
|
||
|
|
</li>
|
||
|
|
<li>Communications status
|
||
|
|
</li>
|
||
|
|
<li>Activation group information
|
||
|
|
</li>
|
||
|
|
<li>Mutex information
|
||
|
|
</li>
|
||
|
|
<li>Thread information
|
||
|
|
</li>
|
||
|
|
<li>Media library attribute information
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>The information for the following options can be shown only when the job is active: job run attributes, call stack information, job lock information, library list information, job log information, open file information, file override information, commitment control status, communications status, activation group information, mutex information, and thread information.
|
||
|
|
</p>
|
||
|
|
<p>The following options can be found regardless of whether the user's job is on the job queue, on an output queue, or active in the system: job status attributes, job definition attributes, and spooled file information. Note, however, that the job is not considered to be in the system until all of its input has been completely read in; only then is an entry placed on the job queue.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>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 worked with, 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>Activation group information for a job cannot be shown if the job is being held when this command is run.
|
||
|
|
</li>
|
||
|
|
<li>This command fails in a job that allows multiple threads if OPTION(*FILOVR) or OPTION(*ALL) is specified.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="WRKJOB.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="#WRKJOB.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="#WRKJOB.OUTPUT"><b>OUTPUT</b></a></td>
|
||
|
|
<td valign="top">Output</td>
|
||
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKJOB.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top"><b><u>*SELECT</u></b>, *STSA, *DFNA, *RUNA, *SPLF, *JOBLOG, *PGMSTK, *JOBLCK, *LIBL, *OPNF, *FILOVR, *CMTCTL, *CMNSTS, *ACTGRP, *MUTEX, *THREAD, *MLBA, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKJOB.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="#WRKJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="WRKJOB.JOB"></a>
|
||
|
|
<h3>Job name (JOB)</h3>
|
||
|
|
<p>Specifies the name of the user job whose information is being worked with.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The job whose information is displayed is the job from which this display command is run.
|
||
|
|
</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 to be displayed. If no job qualifier is given, all of the jobs currently in the system are searched for the simple job name. If duplicates of the specified name are found, a list of messages containing the qualified job names of all duplicates is displayed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: User</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name that identifies the user profile under which the job is run.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 3: Number</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>000000-999999</i></b></dt>
|
||
|
|
<dd>Specify the job number assigned by the system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKJOB.OUTPUT"></a>
|
||
|
|
<h3>Output (OUTPUT)</h3>
|
||
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PRINT</b></dt>
|
||
|
|
<dd>The output is printed with the job's spooled output.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKJOB.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies which information is being worked with.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SELECT</u></b></dt>
|
||
|
|
<dd>The menu is shown and all options and function keys are available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STSA</b></dt>
|
||
|
|
<dd>The identifying characteristics and the status of the job are shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DFNA</b></dt>
|
||
|
|
<dd>The definition attributes in the job description associated with the job are shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RUNA</b></dt>
|
||
|
|
<dd>The run attributes for the job are shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SPLF</b></dt>
|
||
|
|
<dd>The spooled files owned by the job are shown. Only those spooled output files which are on output queues in the library name space of the thread issuing this command will be shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOBLOG</b></dt>
|
||
|
|
<dd>The commands processed by the job and the messages returned from running those commands are shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PGMSTK</b></dt>
|
||
|
|
<dd>All information for all programs in the call stack is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOBLCK</b></dt>
|
||
|
|
<dd>All external object locks held by the job, including held locks and lock that are being waited for, are shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LIBL</b></dt>
|
||
|
|
<dd>The library list for the thread is shown if the job specified for the <b>Job name (JOB)</b> parameter is the job from which the command is run. For other jobs, the library list of the initial thread is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OPNF</b></dt>
|
||
|
|
<dd>Files that are open for the job and the status of system and user files are shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILOVR</b></dt>
|
||
|
|
<dd>File overrides at any active call level for the job are shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CMTCTL</b></dt>
|
||
|
|
<dd>The commitment control status of the job is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CMNSTS</b></dt>
|
||
|
|
<dd>The communications status of the job is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ACTGRP</b></dt>
|
||
|
|
<dd>The activation groups associated with the job are shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MUTEX</b></dt>
|
||
|
|
<dd>The mutex information associated with the initial thread of the job is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*THREAD</b></dt>
|
||
|
|
<dd>Information about the job's threads is displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MLBA</b></dt>
|
||
|
|
<dd>Information about the job's media library attributes is displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All options are shown.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKJOB.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="#WRKJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="WRKJOB.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Printing the Job's Information</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
WRKJOB JOB(SMITH/PAYROLL) OUTPUT(*PRINT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command prints information for the job named PAYROLL submitted by the user named SMITH to the job's output spooling queue.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Working with the Current Job's Spooled Output</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
WRKJOB OPTION(*SPLF)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command allows you to work with the spooled output for the current job.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Working with All of the Current Job's Information</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
WRKJOB OPTION(*ALL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command allows you to work with all of the information for the current job.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="WRKJOB.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF0941</b></dt>
|
||
|
|
<dd>Job &3/&2/&1 no longer in system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1069</b></dt>
|
||
|
|
<dd>End of duplicate names.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1070</b></dt>
|
||
|
|
<dd>Job &3/&2/&1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1071</b></dt>
|
||
|
|
<dd>No authority to job &3/&2/&1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2443</b></dt>
|
||
|
|
<dd>Job log not displayed or listed because job has ended.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3330</b></dt>
|
||
|
|
<dd>Necessary resource not available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3336</b></dt>
|
||
|
|
<dd>Job &5/&4/&3 no longer in the system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9845</b></dt>
|
||
|
|
<dd>Error occurred while opening file &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9846</b></dt>
|
||
|
|
<dd>Error while processing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9847</b></dt>
|
||
|
|
<dd>Error occurred while closing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9850</b></dt>
|
||
|
|
<dd>Override of printer file &1 not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9851</b></dt>
|
||
|
|
<dd>Overflow value for file &1 in &2 too small.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9871</b></dt>
|
||
|
|
<dd>Error occurred while processing.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|