DCE for the HP e3000 (B3821-90002)

Programming with Kernel Threads
Process Management Commands
Chapter 5
60
Process Management Commands
Process management (threads related) features of commands are listed here. For
detailed information about the commands, refer to the MPE/iX Commands Reference
Manual (32650-90006).
SHOPROC • Using the ;PIN= parameter, pin.thread_id can be specified to denote a specific thread of
the task.
• Using the ;FORMAT=SUMMARY option displays one line for each thread of the task.
After the individual threads have been displayed, a composite or summary line is
displayed containing the summation of the CPU time for all threads in the task, and
the QPRI and STATE are blank. (This is done because, each thread in the task can
have different values for the QPRI and STATE fields and there is no single value
that can represent the task as a whole.)
• Using the pinspec parameter displays the process. The pinspec is a Process
Identification Number (PIN). Any user can show processes matching their own user
and account names; they belong to the user. A user with SM or OP capabilities can
show any process (and its threads if any) on the system through its pin (or
pin.thread_id). The System Manager can see system processes by specifying the
SYSTEM option.
If pinspec is 0, then the caller’s pin is used.
To reference a specific thread of a task, pinspec must be of the form pin.thread_id.
Specifying pin.0 results in an error.
NOTREE is the default for pinspec=[#p]pin target processes and can be overridden with
the TREE option.
• Using the SUMMARY format displays a subset of a process’ attributes. Included are
the queue name, process priority, CPU time, execution state, associated JOB or
SESSION number, PIN (indented to show tree structure), program name, threads
related information (if any), and INFO=string (if any) or command step if the process is
CI.PUB.SYS.
SUMMARY is the default format for pinspec=[#p]pin.
• From the SHOWPROC display, the CPUTIME field is displayed in hh:mm:ss or m:ss.mls.
A pair of asterisks (**) is displayed in the hours field if an overflow occurs. This is the
summation of the CPUTIMEs for the individual threads in the task. For the individual
threads, only the CPUTIME consumed by that thread is displayed.
• From the PIN(5) display, the PIN of an unthreaded task or the PIN of a threaded task
is shown.
• From the PIN(9) display, the pin.thread_id of the individual threads in a threaded task
are shown. Where, the pin.thread_id is abcde.fgh (abcde is the task PIN, and fgh is the
thread_id). The SUMMARY format indents the PIN column by two spaces for each child
process. The indentation is used to represent descendants.
• From the QPRI(5) display, a combination of the queue and priority is displayed (Qnnn
[*]). Where, Q is a single character abbreviation of the processes scheduling queue,
nnn is the processes priority, and * indicates a system process. When using the
SUMMARY format the QPRI field is blank on the summary line of a threaded task.