SHOWPROC



SHOWPROC

     Displays information about the specified process(es).

SYNTAX


SHOWPROC [[PIN=] {pinspec }]
{(pinspec [,pinspec ]...)}

[ [;JOB=] {jobspec }]
{(jobspec [,jobspec]...)}

[ [;FORMAT=] {SUMMARY
WG }]

[ {;TREE } ]
{;NOTREE}

[ {;USER } ]
{;ANYUSER}

[ {;SYSTEM } ]

[ {;TRUNC
{;NOTRUNC} ]

PARAMETERS


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.

OPERATION

     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.)


EXAMPLE(S)

     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

ADDITIONAL INFORMATION

Commands:   ALTPROC, TUNE, SHOWQ, NEWWG, ALTWG, PURGEWG, SHOWWG

Manuals :   Using the HP3000 Workload Manager (B3879-90001)