SHOWQ

OPERATION

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

     C     U ] pin [ #Jnnn

     D               #Snnn ]

     E }

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