346 lines
14 KiB
HTML
346 lines
14 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 Active Jobs (WRKACTJOB)</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="WRKACTJOB.Top_Of_Page"></a>
|
||
|
|
<h2>Work with Active Jobs (WRKACTJOB)</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="#WRKACTJOB.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#WRKACTJOB.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#WRKACTJOB.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="WRKACTJOB"></a>
|
||
|
|
<p>The Work with Active Jobs (WRKACTJOB) command allows you to work with performance and status information for the active jobs in the system. The sequence of jobs can be changed with the <b>Sequence (SEQ)</b> parameter or through operations on the display. Other parameters allow the selection of jobs to be shown on the display. The selection parameters can also be changed by operations on the display.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="WRKACTJOB.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="#WRKACTJOB.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 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKACTJOB.RESET"><b>RESET</b></a></td>
|
||
|
|
<td valign="top">Reset status statistics</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKACTJOB.SBS"><b>SBS</b></a></td>
|
||
|
|
<td valign="top">Subsystem</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 25 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKACTJOB.CPUPCTLMT"><b>CPUPCTLMT</b></a></td>
|
||
|
|
<td valign="top">CPU percent limit</td>
|
||
|
|
<td valign="top">0.1-99.9, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKACTJOB.RSPLMT"><b>RSPLMT</b></a></td>
|
||
|
|
<td valign="top">Response time limit</td>
|
||
|
|
<td valign="top">0.1-999.9, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKACTJOB.SEQ"><b>SEQ</b></a></td>
|
||
|
|
<td valign="top">Sequence</td>
|
||
|
|
<td valign="top"><b><u>*SBS</u></b>, *AUXIO, *CPU, *CPUPCT, *CURUSR, *FUNCTION, *INT, *JOB, *NUMBER, *POOL, *PTY, *RSP, *STS, *THREADS, *TYPE, *USER</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="2"><a href="#WRKACTJOB.JOB"><b>JOB</b></a></td>
|
||
|
|
<td valign="top">Job name</td>
|
||
|
|
<td valign="top"><i>Qualifier list</i></td>
|
||
|
|
<td valign="top" rowspan="2">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Job name</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b>, *SYS, *SBS</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#WRKACTJOB.INTERVAL"><b>INTERVAL</b></a></td>
|
||
|
|
<td valign="top">Automatic refresh interval</td>
|
||
|
|
<td valign="top">5-999, <b><u>*PRV</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="WRKACTJOB.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="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKACTJOB.RESET"></a>
|
||
|
|
<h3>Reset status statistics (RESET)</h3>
|
||
|
|
<p>Specifies whether the active job statistics are reset.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The active job statistics are not reset. The measurement time interval is extended if a previous WRKACTJOB command has run in the current job. All active jobs are displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The active job statistics are reset. A measurement time interval of zero is used. All active jobs are displayed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKACTJOB.SBS"></a>
|
||
|
|
<h3>Subsystem (SBS)</h3>
|
||
|
|
<p>Specifies the names of the subsystems (or all subsystems) whose active jobs are displayed.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All active jobs in the system are displayed. System jobs that are not associated with any subsystem are also displayed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 25 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the subsystem to be displayed. All active jobs in this subsystem (including the monitor) are displayed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKACTJOB.CPUPCTLMT"></a>
|
||
|
|
<h3>CPU percent limit (CPUPCTLMT)</h3>
|
||
|
|
<p>Specifies the minimum processing time percent value that a job must have before it is included on the display.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>There is no minimum processing time limit that a job must have to be displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0.1-99.9</i></b></dt>
|
||
|
|
<dd>Specify the minimum processing time percent limit that a job must have to be included on the display.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKACTJOB.RSPLMT"></a>
|
||
|
|
<h3>Response time limit (RSPLMT)</h3>
|
||
|
|
<p>Specifies the minimum response time limit that a job must have before it is included on the display.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>There is no minimum response time limit that a job must have to be displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0.1-999.9</i></b></dt>
|
||
|
|
<dd>Specify the minimum response time limit that a job must have to be included on the display.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKACTJOB.SEQ"></a>
|
||
|
|
<h3>Sequence (SEQ)</h3>
|
||
|
|
<p>Specifies the sequence of the active jobs that are displayed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SBS</u></b></dt>
|
||
|
|
<dd>The jobs are ordered on the basis of the subsystem in which they are running. Jobs that run in a subsystem (auto-start jobs, interactive jobs, batch jobs, readers, and writers) are put in alphabetical order by job name, and are indented under the subsystem with which they are associated. Subsystem monitor jobs (with the jobs in the subsystem grouped under each monitor job) are put in alphabetical order and presented before system jobs. The system jobs are put in alphabetical order by job name, and are presented after the subsystem monitors and jobs in the subsystems.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*AUXIO</b></dt>
|
||
|
|
<dd>Jobs are ordered by the number of auxiliary storage input/output (I/O) operations that have occurred during the measurement time interval. The largest values are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CPU</b></dt>
|
||
|
|
<dd>Jobs are ordered by the amount of processing time they have used since the job started. The largest values are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CPUPCT</b></dt>
|
||
|
|
<dd>Jobs are ordered by the percent of processing unit resource they have used during the measurement interval. The largest values are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURUSR</b></dt>
|
||
|
|
<dd>Jobs are put in alphabetical order by the user profile under which the initial thread is currently running.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FUNCTION</b></dt>
|
||
|
|
<dd>Jobs are put in alphabetical order by the contents of the function field.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INT</b></dt>
|
||
|
|
<dd>Jobs are ordered by the number of operator interactions that have occurred during the measurement interval. The largest values are presented first. Non-interactive jobs are shown last and have a blank interaction field.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOB</b></dt>
|
||
|
|
<dd>Jobs are put in alphabetical order by job name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NUMBER</b></dt>
|
||
|
|
<dd>Jobs are ordered by job number. The largest values are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*POOL</b></dt>
|
||
|
|
<dd>Jobs are ordered by the system pool in which they are running. The lowest values are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PTY</b></dt>
|
||
|
|
<dd>Jobs are ordered by priority of running. The highest priority values (0) are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RSP</b></dt>
|
||
|
|
<dd>Jobs are ordered by the average response time during the measurement interval. The largest values are presented first. Non-interactive jobs are shown last and have a blank interaction field.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STS</b></dt>
|
||
|
|
<dd>Jobs are put in alphabetical order by the contents of the status field.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*THREADS</b></dt>
|
||
|
|
<dd>Jobs are ordered by the number of active threads. The jobs with the largest number of active threads are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TYPE</b></dt>
|
||
|
|
<dd>Jobs are put in alphabetical order by job type and job name within the same type.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USER</b></dt>
|
||
|
|
<dd>Jobs are put in alphabetical order by user name.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKACTJOB.JOB"></a>
|
||
|
|
<h3>Job name (JOB)</h3>
|
||
|
|
<p>Specifies the name of the active jobs to be displayed. Only active jobs within selected subsystems (based on the SBS parameter) are displayed. Subsystem monitor names only appear when *ALL or *SBS is specified. System jobs only appear when *ALL or *SYS is specified.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: Job name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All the active jobs are displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYS</b></dt>
|
||
|
|
<dd>All active system jobs are be displayed. If a value other than the default is specified in the SBS parameter when using this value, an error message is issued.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SBS</b></dt>
|
||
|
|
<dd>All active subsystem monitors are displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify all active jobs, that meet the criteria, that are to be displayed. System jobs and subsystem monitors are not displayed using this parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the active job that is to be displayed. System jobs and subsystem monitors are not displayed using this parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKACTJOB.INTERVAL"></a>
|
||
|
|
<h3>Automatic refresh interval (INTERVAL)</h3>
|
||
|
|
<p>Specifies the interval (in seconds) to wait during the automatic refresh option. The default time is 300 seconds (5 minutes). Valid values range from 5 to 999 seconds. If this value is changed by the user, the value is saved and used as the default value. When automatic refresh is started the screen is refreshed automatically based on the time specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRV</u></b></dt>
|
||
|
|
<dd>The interval of time used in the previous invocation. Until an interval is specified, 300 seconds is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>5-999</i></b></dt>
|
||
|
|
<dd>Specify the delay time (in seconds) for automatic refresh.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="WRKACTJOB.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Resetting Active Job Statistics</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
WRKACTJOB RESET(*YES) CPUPCTLMT(2)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command allows the user to work with a display with no jobs appearing; the active job statistics are reset and no job has used any processing unit time since the reset point. When the display appears, the F5 key may be pressed; this causes a display of all jobs that have exceeded 2 percent of the processing unit utilization since the reset point.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Working With Jobs in a Subsystem</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
WRKACTJOB SBS(QINTER) SEQ(*INT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command allows the user to work with all jobs in the QINTER subsystem. The sequence of the jobs is by the number of operator interactions, with the job with the most interactions appearing first.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="WRKACTJOB.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF1093</b></dt>
|
||
|
|
<dd>Override of file device type not valid.
|
||
|
|
</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="#WRKACTJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|