SHOWQ

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