262 lines
10 KiB
HTML
262 lines
10 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 System Activity (WRKSYSACT)</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="WRKSYSACT.Top_Of_Page"></a>
|
||
|
|
<h2>Work with System Activity (WRKSYSACT)</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="#WRKSYSACT.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#WRKSYSACT.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#WRKSYSACT.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="WRKSYSACT"></a>
|
||
|
|
<p>The Work With System Activity (WRKSYSACT) command allows you to interactively work with the jobs and tasks currently running in the system. Besides having the capacity to view this data on the display station, the user may also direct the data to be stored in a database file for future use.
|
||
|
|
</p>
|
||
|
|
<p><b>Restriction:</b> You must have *JOBCTL special authority to use this command.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="WRKSYSACT.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="#WRKSYSACT.OUTPUT"><b>OUTPUT</b></a></td>
|
||
|
|
<td valign="top">Output</td>
|
||
|
|
<td valign="top"><b><u>*</u></b>, *FILE, *BOTH</td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKSYSACT.INTERVAL"><b>INTERVAL</b></a></td>
|
||
|
|
<td valign="top">Interval length</td>
|
||
|
|
<td valign="top">1-900, <b><u>5</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKSYSACT.SEQ"><b>SEQ</b></a></td>
|
||
|
|
<td valign="top">Sequence</td>
|
||
|
|
<td valign="top"><b><u>*CPU</u></b>, *DBCPU, *IO, *STGALC, *STGDLC, *STGNET</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKSYSACT.INFTYPE"><b>INFTYPE</b></a></td>
|
||
|
|
<td valign="top">Type of information</td>
|
||
|
|
<td valign="top"><b><u>*ALL</u></b>, *JOBS, *TASKS</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKSYSACT.NBRITV"><b>NBRITV</b></a></td>
|
||
|
|
<td valign="top">Number of intervals</td>
|
||
|
|
<td valign="top"><i>Integer</i>, <b><u>60</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKSYSACT.MBR"><b>MBR</b></a></td>
|
||
|
|
<td valign="top">Member</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QAITMON</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKSYSACT.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QPFRDATA</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="WRKSYSACT.OUTPUT"></a>
|
||
|
|
<h3>Output (OUTPUT)</h3>
|
||
|
|
<p>Specifies whether the output from the command is shown on the display station that entered the command, written to a physical database file, or both.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The output is shown on the display station.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILE</b></dt>
|
||
|
|
<dd>The output is written to the database file QAITMON using the member specified for the MBR parameter and the library specified for the LIB parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BOTH</b></dt>
|
||
|
|
<dd>The output is shown on the display station and written to the database file. The statistics are put in the QAITMON file each time the display is refreshed. This does not include the data presented on the initial display of the Work with System Activity display.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKSYSACT.INTERVAL"></a>
|
||
|
|
<h3>Interval length (INTERVAL)</h3>
|
||
|
|
<p>Specifies the number of seconds between the times when the data is refreshed in automatic refresh mode and/or written to the database file. Valid values range from 1 through 900 seconds.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>5</u></b></dt>
|
||
|
|
<dd>The data is refreshed every 5 seconds.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>interval-length</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds (1-900) between refreshes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKSYSACT.SEQ"></a>
|
||
|
|
<h3>Sequence (SEQ)</h3>
|
||
|
|
<p>Specifies the sequence of the jobs and tasks being displayed or written to the database file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CPU</u></b></dt>
|
||
|
|
<dd>Jobs and tasks are ordered by the amount of processing time they have used during the interval. Those using the greatest amounts of processing time are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DBCPU</b></dt>
|
||
|
|
<dd>Jobs and tasks are ordered by the amount of processing time that they have used to perform database processing. Those using the greatest amounts of database CPU are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IO</b></dt>
|
||
|
|
<dd>Jobs and tasks are ordered by the number of I/O operations performed during the interval. Those performing the most I/O operations are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STGALC</b></dt>
|
||
|
|
<dd>Tasks or threads are ordered by the amount of allocated storage. Allocated storage is the amount of storage (in pages) assigned to perform this task or thread. Those tasks or threads that are allocating the highest amount of storage are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STGDLC</b></dt>
|
||
|
|
<dd>Tasks or threads are ordered by the amount of deallocated storage. Deallocated storage is the amount of storage (in pages) that has been released from performing this task or thread. Those tasks or threads that are deallocating the highest amount of storage are presented first.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STGNET</b></dt>
|
||
|
|
<dd>Tasks or threads are ordered by the amount of net storage. Net storage is the difference between the allocated storage and the deallocated storage. Those tasks or threads that are deallocating the greatest difference between the allocated storage and the deallocated storage are presented first.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKSYSACT.INFTYPE"></a>
|
||
|
|
<h3>Type of information (INFTYPE)</h3>
|
||
|
|
<p>Specifies the type of information that is shown or written to the database file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Both jobs and tasks are shown or written to the database file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOBS</b></dt>
|
||
|
|
<dd>Only jobs are shown or written to the database file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TASKS</b></dt>
|
||
|
|
<dd>Only tasks are shown or written to the database file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKSYSACT.NBRITV"></a>
|
||
|
|
<h3>Number of intervals (NBRITV)</h3>
|
||
|
|
<p>Specifies the number of times the data is collected and written to the database file. This parameter is valid only when *FILE is specified for the OUTPUT parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>60</u></b></dt>
|
||
|
|
<dd>The data is collected and written to the database file 60 times.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>number-of-intervals</i></b></dt>
|
||
|
|
<dd>Specify the number of times to collect the performance data and write to the database file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKSYSACT.MBR"></a>
|
||
|
|
<h3>Member (MBR)</h3>
|
||
|
|
<p>Specifies the database file member where the output for the collected data is stored. If the member does not exist, it is automatically created and added to the database file. This parameter is valid only when *FILE or *BOTH is specified for the OUTPUT parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QAITMON</u></b></dt>
|
||
|
|
<dd>The standard member name, QAITMON, is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>member-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the member in which to store the collected data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKSYSACT.LIB"></a>
|
||
|
|
<h3>Library (LIB)</h3>
|
||
|
|
<p>Specifies the library where the database file QAITMON is located. The file QAITMON is automatically created if it does not exist in the specified library. This parameter is valid only when *FILE or *BOTH is specified for the OUTPUT parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QPFRDATA</u></b></dt>
|
||
|
|
<dd>The IBM-supplied performance data library, QPFRDATA, is used to locate the database file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the database file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="WRKSYSACT.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Working with Jobs and Tasks</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
WRKSYSACT
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command displays the Work with System Activity panel, showing both jobs and tasks in descending order of processing time used.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Working with Jobs Only</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
WRKSYSACT OUTPUT(*BOTH) INFTYPE(*JOBS) MBR(JOBACT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command displays the Work with System Activity panel, showing jobs only and writes this information to member JOBACT of database file QAITMON located in default library QPFRDATA.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="WRKSYSACT.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>PFR7018</b></dt>
|
||
|
|
<dd>Work with System Activity already active by user &4.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKSYSACT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|