Generated from C.70.00 /SYS/PUB/CICAT last modified on Mon Feb 16 17:55:04 2004
Displays information about the specified process(es).
SHOWPROC [[PIN=] {pinspec }]
{(pinspec [,pinspec ]...)}
[ [;JOB=] {jobspec }]
{(jobspec [,jobspec]...)}
[ [;FORMAT=] {SUMMARY
WG }]
[ {;TREE } ]
{;NOTREE}
[ {;USER } ]
{;ANYUSER}
[ {;SYSTEM } ]
[ {;TRUNC
{;NOTRUNC} ]
pinspec The process that you want to see.
The pinspec, expressed [#p]pin, is a process
identification number. Specifying pinspec is
optional and has no default; see jobspec.
An ordinary user may show processes matching their
own user and account names (i.e. those that "belong"
to the user). A user with SM or OP capabilities
may show any process on the system via its
PIN. The system manager (SM capability) may
see system processes by specifying the SYSTEM
option. If PINSPEC is 0, then the caller's pin is
used.
The USER and ANYUSER options do not apply to
PINSPEC.
NOTREE is the default for all PINSPEC target
processes, and can be overridden with the
TREE option.
jobspec The name of the job or session whose processes
are to be displayed. JOBSPEC can be any of
the following: jobnumber, username, @S, @J,
or @.
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, they will all be
displayed.
You can use wildcards, which have the following
meanings:
@S all sessions
@J all jobs
@ 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
the command is SHOWPROC job=@J, only
processes for jobs logged on as JEFF.MFG will
be displayed. On the other hand, if the user
is STEVE.UI (who has OP or SM capability),
the command SHOWPROC job=@j will show all
processes for all jobs on the system. If the
user STEVE.UI only wants to see his own job
processes, he must enter SHOWPROC
job=@j;user. 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.
JOBSPEC is optional and defaults the user's
current job ID, for example,
#!hpjobtype!hpjobnum.
SUMMARY The SUMMARY format displays a subset of a
process' attributes. These include the
queue name, process priority, CPU time,
execution state, associated JOB or SESSION
number, PIN (indented to show the tree
structure) and program name. If you "own" the
process, or if you have System Manager (SM)
capability, you also see INFO=string, if any,
or command step if the process is CI.PUB.SYS.
SUMMARY is the default format.
WG The WG format displays workgroup specific details
associated with the process.
TREE This option will cause each process specified,
as well as all its descendents, to be shown.
TREE is the default for all jobspec target
processes.
NOTREE This option will cause only the process specified
to be shown. No information will be shown
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.
System processes, as well as descendant user
processes, will be displayed. SM capability
is required. SYSTEM is ignored for all
jobspec processes.
USER The USER option filters output when JOBSPEC
is wildcarded by causing only processes
matching the user's name to be displayed.
User is the default for ordinary users, for
example, users without OP and SM capability.
ANYUSER The ANYUSER defeats the filtering of the wildcarded
JOBSPEC such that all matching processes are
shown. 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 names that would
exceed $STDLIST for the user. A $ is placed
in the last character of the line to signify
truncation. TRUNC is the default option.
NOTRUNC The NOTRUNC option will allow names to appear
in their full form. As a result, output from
the command may wrap around the display.
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 (the TREE option).
Users with SM or OP 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 this 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:
1) the process is within the user's logon job/session
2) the process' user and account names match the user's user
and account names AND the system's JOBSECURITY is set to LOW
3) 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, only the CI command name and
program are displayed, regardless of capabilities and process
ownership.
If both the ;PIN= and ;JOB= parameters are specified then
the information for the list of pins precedes the information
for the list of jobs. Duplicate specifications are not detected.
This command may be issued from a Session, Job, Program, or in
BREAK. Pressing [Break] aborts the execution of this command.
The following is an alphabetized list of the fields used in the
various SHOWPROC formats. The field's width, in characters, is
shown in parentheses. A "v" indicates that the field has a
variable size width.
CPUTIME (8): CPU is consumed in hh:mm:ss or m:ss.mls.
A pair of asterisks (**) is displayed in the
hours filed 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
WG format. The WG 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.
The SUMMARY format will indent the PIN column by
two spaces for each child process to clearly show
descendants. The WG format precedes the pin
with a percent sign (%) to indicate that the
process is an artificial member of its workgroup.
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
WG format.
PROGRAM (v): 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
WG format.
QPRI (5): A combination of QUEUE 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 the process is a system process. The QPRI
field is unique to the SUMMARY format.
STATE (5 or 7): Execution state of the process, which can be one
of the following:
o BLKIO blocked for terminal write or control.
o WAIT generic process block, usually waiting for
a message.
o BLKCB blocked for control block.
o BLKMM blocked for memory manager.
o READY ready to execute (or executing).
STEP (v): The current command being executed by the CI
process being displayed. This field is not
shown for non-CI processes.
WORKGROUP (v): The workgroup of which the process will be a
member. WORKGROUP will be of the format
[%]name, where % indicates that the process is
an artificial member of the workgroup.
(Artificial members are those processes explicitly
placed in the workgroup via ALTPROC or
AIFPROCPUT.)
To display a summary of information for all non-system
processes in current job/session, enter:
SHOWPROC
To display a summary of information for PIN 42, enter:
SHOWPROC #p42
To display workgroup and summary information for PIN 42 and all
of its descendants, enter:
SHOWPROC #p42; format=wg; TREE
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 workgroup information for all non-system processes in
the current job/session, enter:
SHOWPROC ;format=wg
Commands: ALTPROC, TUNE, SHOWQ, NEWWG, ALTWG, PURGEWG, SHOWWG Manuals : Using the HP3000 Workload Manager (B3879-90001)