SHOWQ


SHOWQ

     Displays scheduling data for all processes and the scheduling
characteristics of the CS, DS and ES scheduling queues.

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 the display (base and limit priorities,
quantum bounds).


OPERATION

     The process scheduling and subqueue information is displayed
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 waiting on longer-term events.

On occasion, a process appears in more than one column to
indicate 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
scheduling queues. The ACTIVE and STATUS options permit you
to filter the SHOWQ output which, on large systems, may
display hundreds of live processes. If you specify both ACTIVE
and STATUS, the ACTIVE output (which includes the STATUS output)
is displayed.

Below is a sample of the output listing 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

L 1 C M163 #S263
L 2 C U215 #S256
L 3
L 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 information is explained below.

{ A }
{ B }
{ C } [ M ] #Jnnn
{ D } [ U ] pin [ ]
{ E } #Snnn

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 the process identification number, a decimal

J nnn the job number: a process executing in a batch job

S nnn the 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 parameters currently in
effect. For example:

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

The SHOWQ command may be issued from a session, job, program,
or in BREAK. Pressing [Break] aborts the execution of this
command. It 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 queues. In fact, the information displayed
for the CS, DS, and ES scheduling queues is the same information as
that for the default workgroups.

Instead of using SHOWQ, Workload Manager users should use SHOWWG
since it displays information about system- and user-defined
workgroups. If you aren't using the Workload Manager, but you prefer
the format for viewing the five default workgroups provided by
SHOWWG, you may choose to use it.


EXAMPLE(S)

     To display the active queues of processes within MPE/iX, 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

ADDITIONAL INFORMATION

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

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