 |
» |
|
|
|
Displays information about the specified process(es). (Native
Mode) Syntax | |
SHOWPROC[ [ PIN=]{pinspec | (pinspec [ ,pinspec ] ...)}] |
[[;JOB=]{jobspec | (jobspec [ ,jobspec] ...)}] |
[[;FORMAT=]{SUMMARY | DETAIL}] |
Parameters | |
- pinspec
The process that you want to see. The pinspec, expressed [#p ]pin,
is a Process Identification Number (PIN). Specifying pinspec
is optional and has no default; see jobspec. An ordinary user may show processes matching their own user
and account names (those which "belong to" the user) by specifying
0 as the pinspec. A user with SM or OP
capabilities may show any process on the system. A user with SM
capability (the system manager) may see system processes by specifying
the SYSTEM option. NOTREE
is the default for all pinspec target
processes, and can be overridden with the TREE
option. The USER
and ANYUSER options
do not apply to pinspec. - jobspec
The name of the job or session whose processes you
want to display. A jobspec can be any
of the following: jobnumber, username, @S, @J, or @. A jobspec
is optional and defaults to the user's current job ID, for example,
#!HPJOBTYPE!HPJOBNUM. The jobnumber must be in the form #Jnnn
or #Snnn. SM or OP capability is required
to specify another user's job or session number. The username must
be in the form user[.account].
SM or OP capability is required to specify another user's username.
If there is more than one job or session under the same username,
all are displayed. You can use wildcards; they have the following meanings: @ - all sessions and jobs
An ordinary user can only see their own processes, even when
jobspec is wildcarded. For example, if
the user name is JEFF.MFG and you enter the command as shown below,
then only processes for jobs logged on as JEFF.MFG are displayed. On the other hand, if the user STEVE.UI (who has OP or SM
capability) enters the command shown below, then all processes for
all jobs on the system are displayed. If the user STEVE.UI only wants to see his own job processes,
he must enter: The USER
option, and its counterpart option, ANYUSER,
are described below. The SYSTEM
option is ignored for all jobspec target
processes. TREE is
the default for all jobspec target processes,
and can be overridden with the NOTREE
option. - SUMMARY
This format displays a subset of a process' attributes.
These include the subqueue name, process priority, CPU time, execution
state, associated JOB
or SESSION number,
PIN (indented
to show tree structure), program name, and INFO=string,
if any (or command step if the process is CI.PUB.SYS). The INFO=string
and command step information is only visible to the system manager
and to processes that belong to the user. SUMMARY
is the default format. - DETAIL
This format displays a more comprehensive set of
the attributes associated with a process. - TREE
This option displays each process specified, as
well as all of its descendents. TREE is the default for all jobspec
target processes. - NOTREE
This option displays only the process specified.
No information appears for the process's descendants. NOTREE
is the default for all pinspec target
processes. - SYSTEM
The SYSTEM
option is required if the target process from pinspec
is a system process. It displays system processes as well as descendant
user processes. SM capability is required. SYSTEM
is ignored for all jobspec processes. - USER
The USER
option filters output when jobspec is
wildcarded by displaying only processes matching the user's name.
USER is the default
for users without OP and SM capability. - ANYUSER
This option defeats the filtering of the wildcarded
jobspec and displays all matching processes.
SM or OP capability is necessary to specify ANYUSER,
and users with these capabilities get ANYUSER
by default. OP or SM users may reduce the SHOWPROC
output to just their own processes by using the USER
option. - TRUNC
The TRUNC
option truncates output records that would exceed the record width
of $STDLIST for the user. A $
replaces the last character of the line to signify truncation. TRUNC
is the default option. - NOTRUNC
This option displays output records in their full
form. As a result, output from the command may wrap around the display.
Operation Notes | |
The SHOWPROC
command displays information about processes except lockwords, which
are never displayed. By default, the processes shown are the root
CI and its descendents (TREE
option). Any user may issue this command. Users with OP or SM capability
may see information for processes belonging to other users. SM users
may also see system processes via the SYSTEM
option. Any user may issue the SHOWPROC
command and see information about all processes that belong to them.
A process "belongs" to a user if one or more of the following conditions
exists: the process is within the user's logon job/session the process' user and account names match the user's
user and account names and the system's JOBSECURITY
is set to LOW the user has OP or SM capability.
If rule 1 or 2 applies or the user has SM capability then
all information (except lockwords) is visible. Otherwise, only the
Command Interperter (CI) command and/or program names are shown.
That is, the parameters of a CI command and the INFO= string passed
to a program are not visible. When SHOWPROC
is executed in a job, regardless of capabilities and process ownership,
only the CI command name and program are displayed. If you specify both the ;PIN=
and ;JOB= parameters,
information for the list of pins will precede the information for
the list of jobs. Duplicate specifications are not detected. SHOWPROC
may be issued from a Session, Job, Program, or in BREAK. Pressing
Break aborts the execution of
this command. The fields displayed are described below. The field's width,
in characters, is shown within parentheses. A "v" indicates that
the field has a variable size width. - CPUTIME
(8):
CPUTIME
is consumed in hh:mm:ss or m:ss.mls. A pair of asterisks (**) appears
in the hours field when hours overflows. The three-character "mls"
sub-field holds milliseconds. - JOBNUM
(6):
The job or session number for the process. - LOGON
(v):
The job/session, user, and account name associated
with this process. - PARENT
(5):
Process Identification Number for the process' parent
(decimal). This field is unique to the DETAIL
format. The DETAIL
format displays PARENT
so that process relationships can be determined. A zero indicates
that the process does not have a parent (for example, PROGEN). - PIN
(5):
Process Identification Number for the process (decimal).
The SUMMARY format
indents the PIN column by two spaces for each child process so that
you can clearly see a process' descendants. The DETAIL
format precedes the pin with a percent sign (%)
to indicate that the process is an artificial member of its workgroup,
and does not indent the display. - PRI
(5)
The priority at which the process is currently executing.
A lower numeric value indicates a higher priority. It also indicates
whether the process is linear, runs with fixed priority (L),
or is decayable (D).
This field is unique to the DETAIL
format. - PROGRAM
(v):
The file name of the program the process is executing. - QUEUE
(v):
The scheduling queue attribute associated with this
process. The QUEUE
field is unique to the DETAIL
format. - QPRI
(5):
A combination of SUBQUEUE
and PRIORITY
which appears as Qnnn[*]. Q is a single character abbreviation of
the process' scheduling queue attribute. The nnn is the process'
priority, and * indicates that this process is a system process.
The QPRI field
is unique to the SUMMARY
format. - STATE
(5):
The execution state of the process, which can be
one of the following: BLKIO blocked for
terminal write or control. WAIT generic process block, usually waiting for
a message. BLKCB blocked for control block. BLKMM blocked for memory manager. READY ready to execute (or executing).
- STEP
(v):
The command that the displayed CI process is currently
executing. This field is not shown for non-CI processes. - WORKGROUP
(v):
The workgroup of which the process is a member.
WORKGROUP appears
as [%]name, where %
indicates that the process is an artificial member of the workgroup,
and name is the
workgroup name. A process becomes an artificial member when it is
explicitly placed into the workgroup via ALTPROC
or AIFPROCPUT
instead of naturally meeting the membership criteria of the workgroup.
On the next page is a sample output of the DETAIL
format. In this example, pin 2 is a system mode process, running
linearly at priority 142. Pin 99 is a user mode process running
linearly at priority 160. Pin 121 is a user mode process that is
an artificial member of the "Payroll_Online" workgroup :SHOWPROC pin=(2,99,121,188);format=detail;system
PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP
- - -
2 1 142 L 7:23.687 WAIT (LOAD.PUB.SYS)
LOGON :
PROGRAM : LOAD.PUB.SYS
QUEUE : BS
WORKGROUP : BS_Default
***********************
PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP
- - -
99 68 160 L 0:05.020 BLKIO S45 (QEDIT.PUB.SYS)
LOGON : NMTEST,SLC.MYTEST
PROGRAM : QEDIT.PUB.SYS
QUEUE : BS
WORKGROUP : Program_Development
***********************
PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP
- - -
121 97 158 D 0:12.045 READY J51 :tdp "text report"
LOGON : JREPORT,GREG.MYTEST
PROGRAM : TDP.PUB.SYS
QUEUE : DS
WORKGROUP : %Payroll_Online
************************
PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP
- - -
188 101 100 D 0:04.200 WAIT S56 (TDP.PUB.SYS) text test1
LOGON : CMTEST,DOUG.MYTEST
PROGRAM : TDP.PUB.SYS
QUEUE : BS
WORKGROUP : BS_Default |
Below is a sample output of the default SUMMARY
format. The information in the (PROGRAM) STEP
column is visible only when the user issuing the command has SM
capability, or when the process specified on the command line (in
this case, #P54)
belongs to the user. :SHOWPROC #P54; tree; trunc
QPRI CPU STATE JOBNUM PIN (PROGRAM) STEP
C152 0:12.999 WAIT S12 54 :tdp "text myfile"
C152 0:02.000 WAIT S12 38 (TDP.PUB.SYS) text myfile
C152 0:01.030 READY S12 67 (FCOPY.PUB.SYS)from=foo.pub.sys;to=b$
:SHOWPROC #P54; tree; notrunc
QPRI CPU STATE JOBNUM PIN (PROGRAM) STEP
C152 0:12.999 WAIT S12 54 :tdp "text myfile"
C152 0:02.000 WAIT S12 38 (TDP.PUB.SYS) text myfile
C152 0:01.030 READY S12 67 (FCOPY.PUB.SYS)from=foo.pub.sys;to=ba
r;new |
Example | |
To display a summary of information for all non-system processes
in the current job/session, enter: To display a summary of information for PIN 42, enter: To display a summary of information for PIN 42 and all of
its descendants, enter: To display the detail information for PIN 42, enter: :SHOWPROC #p42; format= detail |
To display a summary of information for all processes (requires
SM capability), enter: :SHOWPROC 1 ;system ;tree |
To display a summary of information for all non-system processes
that are jobs (requires SM or OP capability), enter: :SHOWPROC job=@j; anyuser |
To display a summary of information for PINs 150, 247, and
211, enter: :SHOWPROC (150,#p247,211) |
To display a summary of information for all non-system processes
logged on as MGR.PAYROLL (requires SM or OP capability), enter: :SHOWPROC job=mgr.payroll |
To display a summary of information for all non-system processes
belonging to Job 2 or logged on as ME.AP (requires SM or OP capability),
enter: :SHOWPROC job=(#j2,me.ap) |
To display the detail information for all non-system processes
in the current job/session, enter: To display the detail information for all non-system processes
on the system (requires SM or OP capability), enter: :SHOWPROC job=@; format= detail |
Related Information | |
- Commands
TUNE,
ALTPROC, SHOWQ,
NEWWG, ALTWG,
PURGEWG, SHOWWG - Manuals
MPE/iX Intrinsics Reference Manual
|
