260 lines
7.3 KiB
HTML
260 lines
7.3 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<META name="generator" content="IBM WebSphere Studio Homepage Builder V6.0.0 Trial for Windows">
|
||
|
|
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<META http-equiv="Content-Style-Type" content="text/css">
|
||
|
|
<title>ps - Display process status</title>
|
||
|
|
<LINK rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</HEAD>
|
||
|
|
<body bgcolor="#FFFFFF">
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
||
|
|
|
||
|
|
|
||
|
|
<h2>ps - Display process status</h2>
|
||
|
|
|
||
|
|
<strong>Synopsis</strong>
|
||
|
|
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<strong>ps [-Aaefjlt] [ -o</strong> <em>format</em> <strong>]
|
||
|
|
[ -p</strong> <em>pidlist</em> <strong>] [ -s</strong> <em>sbslist</em> <strong>]
|
||
|
|
[ -u</strong> <em>userlist</em> <strong>]</strong>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p><strong>Description</strong></p>
|
||
|
|
|
||
|
|
<p>The <strong>ps</strong> utility displays information about processes. The
|
||
|
|
output from <strong>ps</strong> can include the following fields:
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt><em>CGROUP</em></dt>
|
||
|
|
|
||
|
|
<dd>The current primary group profile of the process.
|
||
|
|
<p></dd>
|
||
|
|
|
||
|
|
<dt><em>CMD</em></dt>
|
||
|
|
|
||
|
|
<dd>Program, menu, or command most recently run by the process.
|
||
|
|
<p></dd>
|
||
|
|
|
||
|
|
<dt><em>CUSER</em></dt>
|
||
|
|
|
||
|
|
<dd>The current user profile of the process.
|
||
|
|
<p></dd>
|
||
|
|
|
||
|
|
<dt><em>DEVICE</em></dt>
|
||
|
|
|
||
|
|
<dd>Name of the device description object that is associated with the process.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>ETIME</em></dt>
|
||
|
|
|
||
|
|
<dd>The elapsed time since the process started. The time is displayed in the format
|
||
|
|
[[<em>dd</em>-]<em>hh</em>:]<em>mm</em>:<em>ss</em> where <em>dd</em> is the number of days,
|
||
|
|
<em>hh</em> is the number of hours, <em>mm</em> is the number of minutes, and
|
||
|
|
<em>ss</em> is the number of seconds.
|
||
|
|
<p></dd>
|
||
|
|
|
||
|
|
<dt><em>FUNCTION</em></dt>
|
||
|
|
|
||
|
|
<dd>Program, menu, or command most recently run by the process.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>JOBID</em></dt>
|
||
|
|
|
||
|
|
<dd>Qualified job name of the process. The qualified job name is a string in
|
||
|
|
the form <em>number</em>/<em>user</em>/<em>name</em>. The <em>number</em> is a
|
||
|
|
six-digit decimal number, <em>user</em> is the user profile under which
|
||
|
|
the job was started, and <em>name</em> is the name of job.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>JOBNAME</em></dt>
|
||
|
|
|
||
|
|
<dd>Job name component of the qualified job name.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>JOBNUM</em></dt>
|
||
|
|
|
||
|
|
<dd>Job number component of the qualified job name.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>NTHREADS</em></dt>
|
||
|
|
|
||
|
|
<dd>The number of threads currently running in the process as a decimal number.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>PCPU</em></dt>
|
||
|
|
|
||
|
|
<dd>The ratio of CPU time used recently to CPU time available,
|
||
|
|
expressed as a percentage.
|
||
|
|
<p></dd>
|
||
|
|
|
||
|
|
<dt><em>PGID</em></dt>
|
||
|
|
|
||
|
|
<dd>Process group ID number as a decimal number.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>PID</em></dt>
|
||
|
|
|
||
|
|
<dd>Process ID number as a decimal number.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>PPID</em></dt>
|
||
|
|
|
||
|
|
<dd>Parent process ID number as a decimal number.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>PRI</em></dt>
|
||
|
|
|
||
|
|
<dd>Current priority of the process as a decimal number. Lower numbers mean a higher
|
||
|
|
priority.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>SBS</em></dt>
|
||
|
|
|
||
|
|
<dd>Subsytem in which the process is running.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>STATUS</em></dt>
|
||
|
|
|
||
|
|
<dd>Current status of the process.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>STIME</em></dt>
|
||
|
|
|
||
|
|
<dd>Date and time the process was started. By default, the date and time is displayed
|
||
|
|
in the format <em>mm</em>-<em>dd</em>-<em>yyyy</em> <em>hh</em>:<em>nn</em>:<em>ss</em>
|
||
|
|
where <em>mm</em> is the month, <em>dd</em> is the day, <em>yyyy</em> is the year,
|
||
|
|
<em>hh</em> is the hour, <em>nn</em> is the minute, and <em>ss</em> is the second.
|
||
|
|
|
||
|
|
If the LC_TIME environment variable is set, the date and time is displayed with
|
||
|
|
the format specified by the d_t_fmt keyword in the LC_TIME category of the specified
|
||
|
|
locale.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>THCOUNT</em></dt>
|
||
|
|
|
||
|
|
<dd>The number of threads currently running in the process as a decimal number.
|
||
|
|
<p></dd>
|
||
|
|
|
||
|
|
<dt><em>TIME</em></dt>
|
||
|
|
|
||
|
|
<dd>CPU time used by the process in seconds. The time is displayed in the format
|
||
|
|
[[<em>dd</em>-]<em>hh</em>:]<em>mm</em>:<em>ss</em> where <em>dd</em> is the number of days,
|
||
|
|
<em>hh</em> is the number of hours, <em>mm</em> is the number of minutes, and
|
||
|
|
<em>ss</em> is the number of seconds.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>TMPSZ</em></dt>
|
||
|
|
|
||
|
|
<dd>The amount of temporary storage used by the process in megabytes as a decimal number.
|
||
|
|
<p></dd>
|
||
|
|
|
||
|
|
<dt><em>TYPE</em></dt>
|
||
|
|
|
||
|
|
<dd>The type of the process.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>USER</em></dt>
|
||
|
|
|
||
|
|
<dd>User profile component of the qualified job name.<p></dd>
|
||
|
|
|
||
|
|
<dt><em>UID</em></dt>
|
||
|
|
|
||
|
|
<dd>User id number corresponding to the user profile component of the qualified
|
||
|
|
job name.<p></dd>
|
||
|
|
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<p>By default, <strong>ps</strong> displays the PID, DEVICE, TIME, FUNCTION, STATUS,
|
||
|
|
and JOBID fields about processes owned by the current user. Use the <strong>-o</strong>
|
||
|
|
option to select the fields displayed by <strong>ps</strong>.
|
||
|
|
|
||
|
|
<p>To display information about other processes, you must have *JOBCTL special authority.</p>
|
||
|
|
|
||
|
|
<p><strong>Options</strong></p>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt><strong>-a</strong></dt>
|
||
|
|
|
||
|
|
<dd>Display information for all processes associated with a 5250 terminal.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-A</strong></dt>
|
||
|
|
|
||
|
|
<dd>Display information for all processes. This includes processes that are active, on a job queue, or on an output queue.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-e</strong></dt>
|
||
|
|
|
||
|
|
<dd>Include active processes in the output.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-f</strong></dt>
|
||
|
|
|
||
|
|
<dd>Display a full listing. The output includes the USER, PID, PPID, STIME, DEVICE, TIME and
|
||
|
|
FUNCTION fields.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-j</strong></dt>
|
||
|
|
|
||
|
|
<dd>Include processes on a job queue in the output.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-l</strong></dt>
|
||
|
|
|
||
|
|
<dd>Display a long listing. The output includes the USER, PID, PPID, PRI, STATUS, JOBID, STIME,
|
||
|
|
DEVICE, TIME and FUNCTION fields.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-o</strong> <em>format</em></dt>
|
||
|
|
|
||
|
|
<dd>Display information according to the format specification given in <em>format</em>.
|
||
|
|
Multiple <strong>-o</strong> options can be specified.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-p</strong> <em>pidlist</em></dt>
|
||
|
|
|
||
|
|
<dd>Write information for processes whose process ID numbers are specified in
|
||
|
|
<em>pidlist</em>. The <em>pidlist</em> must be a
|
||
|
|
single argument in the form of a blank- or comma-separated list.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-s</strong> <em>sbslist</em></dt>
|
||
|
|
|
||
|
|
<dd>Write information for processes running in the subsystems specified in
|
||
|
|
<em>sbslist</em>. The <em>sbslist</em> must be a
|
||
|
|
single argument in the form of a blank- or comma-separated list.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-t</strong></dt>
|
||
|
|
|
||
|
|
<dd>Include processes on an out queue in the output.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-u</strong> <em>userlist</em></dt>
|
||
|
|
|
||
|
|
<dd>Write information for processes whose user ID numbers or user names are specified in
|
||
|
|
<em>userlist</em>. The <em>userlist</em> must be a
|
||
|
|
single argument in the form of a blank- or comma-separated list.</dd>
|
||
|
|
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<p><strong>Environment Variables</strong></p>
|
||
|
|
|
||
|
|
<p><strong>ps</strong> is affected by the following environment
|
||
|
|
variables:</p>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt><strong>LANG</strong></dt>
|
||
|
|
|
||
|
|
<dd>Provides a default value for locale categories that are not specifically
|
||
|
|
set with a variable starting with LC_.</dd>
|
||
|
|
|
||
|
|
<dt><strong>LC_TIME</strong></dt>
|
||
|
|
|
||
|
|
<dd>Defines the output format for date and time attributes.</dd>
|
||
|
|
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<p><strong>Exit Status</strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>0 when successful</li>
|
||
|
|
|
||
|
|
<li>>0 when unsuccessful</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Related information</strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><a href="getjobid.htm">getjobid - Display job information </a></li>
|
||
|
|
|
||
|
|
<li><a href="jobs.htm">jobs - Display status of jobs in current session </a></li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<!-- end ibmbody========================================================= -->
|
||
|
|
</body>
|
||
|
|
</html>
|