SHOWQ

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


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)

Back to Main Index