HP 3000 Manuals HP 3000 Manuals
SHOWQ
Displays scheduling data for all processes and the scheduling
characteristics of the CS, DS and ES scheduling subqueue(s). (Native
Mode)
SYNTAX
SHOWQ [;ACTIVE][;STATUS]
Parameters
ACTIVE Displays only the processes currently running or those
about to run. This is the right-hand portion of the
display. The STATUS lines are printed last.
STATUS Reduces the output from SHOWQ to the final status lines of
display (base and limit priorities, quantum bounds).
Operation Notes
The process scheduling and subqueue information appears in two major
columns: DORMANT and RUNNING. RUNNING processes are those that currently
require the CPU in order to continue, or that will require it in the
immediate future. CPU time is automatically allocated to the highest
priority process that is ready to run. DORMANT processes are those
waiting on longer-term events.
On occasion, a process appears in more than one column, indicating that
it was changing state when you executed SHOWQ.
As the default, SHOWQ lists dormant and running processes and the
scheduling characteristics of the CS, DS, and ES subqueues. However, the
ACTIVE and STATUS options permit you to filter the SHOWQ output which, on
large systems, may display hundreds of live processes.
Use the ACTIVE option to display running processes and the scheduling
characteristics of the CS, DS, and ES scheduling subqueues. Use the
STATUS option to display just the scheduling characteristics of the CS,
DS, and ES subqueues. (Note that the ACTIVE output appears when both
options are specified, since status information is a subset of the active
information.)
Below is an example of the two-column output produced by the SHOWQ
command. The symbols that may appear in such a listing are explained in
the remainder of the discussion.
DORMANT RUNNING
Q PIN JOBNUM Q PIN JOBNUM
A 1 C M163 #S263
B 2 C U215 #S256
B 3
A 4
D U29 #J30
C M37 #S234
C M55 #S248
Each entry in the three columns displays the following information for a
single process; the meaning is explained below.
{A}
{B}
{C} [M] pin [#Jnnn]
{D} [U] [#Snnn]
{E}
A the queue attribute of the process is AS
B the queue attribute of the process is BS
C the queue attribute of the process is CS
D the queue attribute of the process is DS
E the queue attribute of the process is ES
M this is a job or session main process
U this is a user process
pin process identification number, a decimal
J nnn job number: a process executing in a batch job
S nnn session number: a process executing from a session
The process identification number (pin) may appear with or without an M
or U label. Processes without an M or U label are system processes.
In addition, SHOWQ prints the scheduling characteristics currently in
effect. In the example below, QUEUE is the scheduling subqueue and BASE,
LIMIT, MIN QUANTUM, MAX QUANTUM, BOOST and TIMESLICE are scheduling
values set by the TUNE command. MIN and MAX quantums are bounds for the
quantums and ACTUAL quantum is the current quantum value.
------QUANTUM------
QUEUE BASE LIMIT MIN MAX ACTUAL BOOST TIMESLICE
----- ---- ----- --- --- ------ ----- ---------
CQ 152 200 1 2000 200 DECAY 200
DQ 202 238 2000 2000 2000 OSC 200
EQ 240 253 2000 2000 2000 DECAY 200
You may issue the SHOWQ command from a session, job, program, or in
BREAK. Pressing Break aborts the execution of this command. SHOWQ
requires System Supervisor (OP) capability.
NOTE The MPE/iX Scheduler now supports the workgroup concept. However,
backward compatibility is maintained through five default
workgroups created by the system. The scheduling characteristics
of the CS_Default, DS_Default, and ES_Default workgroups mimic
those of the CS, DS, and ES scheduling subqueues. In fact, the
information displayed for the CS, DS, and ES scheduling subqueues
is the same information as that for the default workgroups.
Please refer to the NEWWG and SHOWWG commands for more detail.
Since SHOWQ displays limited information regarding workgroup
processes, Workload Manager users should use the SHOWWG and
SHOWPROC commands rather than SHOWQ. Non-Workload Manager users may
choose to use these commands if they prefer the format for viewing
the default workgroups.
Example
To display the active processes and the current scheduling subqueue
characteristics, enter:
__________________________________________________________________
| |
| |
| :SHOWQ;ACTIVE |
| |
| DORMANT RUNNING |
| Q PIN JOBNUM Q PIN JOBNUM |
| |
| C M163 #S263 |
| C U215 #S256 |
| |
| |
| ------QUANTUM------ |
| QUEUE BASE LIMIT MIN MAX ACTUAL BOOST TIMESLICE |
| ----- ---- ----- --- --- ------ ----- --------- |
| CQ 152 200 1 2000 200 DECAY 200 |
| DQ 202 238 2000 2000 2000 OSC 200 |
| EQ 240 253 2000 2000 2000 DECAY 200 |
| |
__________________________________________________________________
Related Information
Commands TUNE, ALTPROC, SHOWPROC, NEWWG, ALTWG, PURGEWG, SHOWWG
Manuals MPE/iX Intrinsics Reference Manual (32650-90028)
Performing System Management Tasks (32650-90004)