Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Displays information about the specified process(es).
SHOWPROC [[PIN=] {pinspec }] {(pinspec [,pinspec ]...)} [ [;JOB=] {jobspec }] {(jobspec [,jobspec]...)} [ [;FORMAT=] {SUMMARY DETAIL}] [ {;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. DETAIL The DETAIL 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 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. The SUMMARY format will indent the PIN column by two spaces for each child process to clearly show descendants. The DETAIL 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 DETAIL 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 DETAIL 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=detail; 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=detail
Commands: ALTPROC, TUNE, SHOWQ, NEWWG, ALTWG, PURGEWG, SHOWWG Manuals : Using the HP3000 Workload Manager (B3879-90001) Back to Main Index