SHOWWG



SHOWWG

     Displays scheduling and process data pertaining to the specified
     workgroup(s).

SYNTAX


SHOWWG [ [WORKGROUP=] { workgrpspec
( workgrpspec [,workgrpspec]...) } ]

[ [;FORMAT=] {SUMMARY
WGFILE
PROCS
DETAIL }]

[ {;TRUNC
;NOTRUNC} ]

PARAMETERS


workgrpspec The name of the workgroup(s) for which
information is to be displayed. Wildcards are
supported. "@" matches to all workgroups, both
user-defined and system-defined. If no workgroup
is specified, "@" (all workgroups) is assumed.
This is the default.

Note that workgroups are displayed in the order
they fall in the ordered list.

SUMMARY The SUMMARY format displays a one-line summary
of the attributes associated with the specified
workgroup(s). This includes the scheduling
characteristics and whether the workgroup has
a purge pending. SUMMARY is the default format.

WGFILE The WGFILE format displays the membership
criteria and scheduling characteristics for the
specified workgroups. The output generated is
suitable as input to NEWWG. Note that while "@"
matches to all workgroups, the values of the system-
defined workgroups are preceded by comment
characters because they are not suitable input for
NEWWG. To direct the current configuration of
user-defined workgroups into an indirect file use
FORMAT=WGFILE > filename.

PROCS The PROCS format displays the member processes
and certain process attributes.

DETAIL The DETAIL format displays the attributes
associated with the specified workgroup(s). This
includes, the membership criteria, scheduling
characteristics, and member processes.

TRUNC The TRUNC option truncates names that would
exceed $STDLIST for the user. A $ appears as the
last character of the line to signify truncation.
TRUNC is the default option for the SUMMARY, PROCS,
and DETAIL formats. It is ignored with the WGFILE
format.

NOTRUNC This option allows names to appear in their
full form. As a result, command output wraps
around the display. This option is ignored with
the SUMMARY and WGFILE formats.

OPERATION

     Use the SHOWWG command to display attributes of one or more
     workgroups specified in the workgrpspec parameter. SHOWWG displays
     the workgroups in the same order that the system traverses the
     workgroups (for example, when performing workgroup assignment)
     in one of  four output formats: SUMMARY, WGFILE, PROCS, and DETAIL.

     SHOWWG may be issued from a session, job, program, or in
     BREAK. Pressing [[Break]] aborts the execution of the command.
     SHOWWG requires System Supervisor (OP) or System Manager
     (SM) capability. The SUMMARY format displays a one-line
     summary of the attributes associated with the specified
     workgroup(s). This includes the scheduling characteristics
     and whether the workgroup has a purge pending.

     Processes within the workgroup are not constrained to have their
     priorities fall within the specified base and limit values. N/A
     means that the scheduling characteristic is Not Applicable for the
     system-defined workgroup. For example, processes within the
     AS_Default or BS_Default workgroup (usually system processes) do
     not experience decay. Therefore these workgroups do not support the
     concept of a quantum or boost priority.  Similarly, since CPU
     percentages do not apply to the default workgroups, N/A appears
     in those columns.

     The fields displayed with the SUMMARY format are described
     below.  The field's width, in characters, is shown within
     parentheses. A "v" indicates  that the field has a variable size
     width.

WORKGROUP (18):     The workgroup name, truncated to 16 character.
                    Truncation is indicated with a $ residing in the
                    eighteenth (18) character of the workgroup name.
                    The NOTRUNC option is not supported with the
                    SUMMARY format.

BASE (3):           An integer specifying the priority at which
                    processes executing in the specified workgroup
                    begin their Dispatcher transactions.

LIMIT (3):          An integer specifying the lowest priority which
                    processes executing in  the specified workgroup can
                    attain.

MIN (5):            The minimum number of milliseconds that a process
may use the CPU before its priority is reduced.

MAX (5): The maximum number of milliseconds that a process
may use the CPU before its priority is reduced.

ACTUAL (5): The actual quantum value for the workgroup. The
quantum is the average number of milliseconds of
CPU processes within the specified workgroup
required to complete their Dispatcher transactions.
Processes will decay in priority when their CPU
consumption exceeds the workgroup quantum.

BOOST (5): Indicates the priority decay behavior associated
with the workgroup.

TIMESLICE (5): The maximum number of milliseconds a process in
the workgroup can hold a CPU before returning to
the Scheduler to have its priority recalculated.

PROCS (5): The number of member processes currently assigned
to the specified workgroups.

The WGFILE format displays the membership criteria and scheduling
characteristics for the specified workgroup(s). The output generated is
suitable as input to NEWWG.


The PROCS format displays the member processes and certain process
attributes.

:SHOWWG Test_@; format= procs

WORKGROUP : ~Test_WG1
PROCESSES : 3

PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP
------ ------ ----- -------- ------- ------ -------------
101 64 180 D 0:05.020 WAIT S41 :tdp "text myfile"
%124 38 185 D 0:12.990 WAIT J12 (TDP.PUB.SYS) text myfile
*******************
WORKGROUP : ~Test_WG2
PROCESSES : 1

PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP
----- ------ ----- -------- ------- ------ -------------
173 32 240 D 0:08.120 WAIT S71 :tdp "text report1"

*******************

NOTE

The SHOWWG PROCS format is not presented as an atomic action.  That is,
the processes may be changing as they are being listed.  Thus, you may
see a listing where the number of processes at the beginning of the
listing does not match the number of process line items.  It is even
possible for a given process to die, relinquishing its PIN to a new
process.  Thus, the same PIN might appear twice if the process dies
after its first line item is listed.

The fields unique to the PROCS format are described below. The field's
width, in characters, is shown within parentheses. A "v" indicates that
the field has a variable size width.

WORKGROUP (v):      The name of the specified workgroup. The
                    workgroup name has a maximum length of 254
                    characters. However, the TRUNC option (default)
                    will limit the name to the size of the user's
                    $STDLIST. Truncation can be overridden with the
                    NOTRUNC option.  The "~" (tilde) as the first
                    character of the workgroup name designates that
                    it is in the purge pending state.

PROCESSES (v):      The number of process within the specified workgroup.

PIN (6):            Process Identification Number for the process. The
                    format is [%]nnnnn, where  the "%" (percent sign)
                    indicates that the process is an artificial member
                    of the  workgroup. Processes are either natural or
                    artificial members of a workgroup. Natural members
                    meet the membership criteria, while  artificial
                    members have  been placed explicitly into the
                    workgroup (via ALTPROC or an AIF).

PARENT (5):         Process Identification Number for the process'
                    parent (decimal). This field appears in the
                    DETAIL and PROCS formats.  These formats display
                    PARENT so that you can determine process
                    relationships. A zero indicates that the process
                    does not have a parent (for example, PROGEN).

PRI (5):            The priority at which the process is currently
                    executing. A lower numeric value indicates a higher
                    priority.   There is also an indication of whether
                    the process is Linear (L) or Decayable (D).

CPUTIME (8):        CPU is consumed in hh:mm:ss or m:ss.mls. A pair
                    of asterisks (**) is displayed in the hours
                    field when hours overflows. The three-character
                    "mls" sub-field holds milliseconds.

STATE (5 or 7):     This indicates the execution state of the process.
                    STATE can be one of the following:

                    o BLKIO blocked for terminal write or control.

                    o WAIT generic process block, usually waiting for a
                      message.

                    o BLKCB blocked for control block.

                    o BLKMM blocked for memory manager.

                    o READY ready to execute (or executing).

JOBNUM (6):        The job or session number for the process.

PROGRAM (v):        The file name of the program the process is
                    executing.

STEP (v):           The current command being executed by the CI
                    process being displayed. This field is not shown
                    for non-CI processes.

The DETAIL format displays the attributes associated with the specified
workgroup(s). Here is a sample output:

:SHOWWG Test_@; format= detail

WORKGROUP : Test_WG1
PROCESSES : 3

MEMBERSHIP CRITERIA
PROGRAM : @.@.TEST1
QUEUE : CS

------QUANTUM------- TIME CPU %
BASE LIMIT MIN MAX ACTUAL BOOST SLICE PROCS MIN MAX
---- ----- ----- ----- ------ ----- ----- ----- --- ---
180 200 1000 1000 1000 OSC 400 3 20 100



PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP
------ ------ ----- -------- ----- ------ -------------
101 54 180 D 0:05.020 WAIT S41 :tdp "text mytext"
%124 38 185 D 0:12.990 WAIT J12 (TDP.PUB.SYS) text myfile
*******************

WORKGROUP : Test_WG2
PROCESSES : 1

MEMBERSHIP CRITERIA
PROGRAM : @.@.TEST2
QUEUE : CS, DS

------QUANTUM------- TIME CPU %
BASE LIMIT MIN MAX ACTUAL BOOST SLICE PROCS MIN MAX
---- ----- ----- ----- ------ ----- ----- ----- --- ---
170 180 2000 2000 2000 DECAY 600 1 30 40

PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP
------ ------ ----- -------- ----- ------ -------------
173 140 240 D 0:08.120 WAIT S71 :tdp "text test"
*******************

An example of a ;NOTRUNC output is as follows:

:SHOWWG Test_@; format= detail;notrunc

WORKGROUP : Test_WG1
PROCESSES : 3

MEMBERSHIP CRITERIA
PROGRAM : @.@.TEST1
QUEUE : CS

------QUANTUM------- TIME CPU %
BASE LIMIT MIN MAX ACTUAL BOOST SLICE PROCS MIN MAX
---- ----- ----- ----- ------ ----- ----- ----- --- ---
180 200 1000 1000 1000 OSC 400 3 20 100




PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP
------ ------ ----- -------- ----- ------ -------------
101 54 180 D 0:05.020 WAIT S41 :tdp "text mytext"
%124 38 185 D 0:12.990 WAIT J12 (TDP.PUB.SYS) text myfile
*******************

WORKGROUP : Test_WG2
PROCESSES : 1


MEMBERSHIP CRITERIA
PROGRAM : @.@.TEST2
QUEUE : CS, DS

------QUANTUM------- TIME CPU %
BASE LIMIT MIN MAX ACTUAL BOOST SLICE PROCS MIN MAX
---- ----- ----- ----- ------ ----- ----- ----- --- ---
170 180 2000 2000 2000 DECAY 600 1 30 40


PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP
------ ------ ----- -------- ----- ------ -------------
173 140 240 D 0:08.120 WAIT S71 :tdp "text test"
*******************

NOTE

For all formats, SHOWWG lists workgroups in the order they are searched
when matching processes for membership.  This order and all other
displayed values are obtained from system tables and not from files.
Thus SHOWWG shows the actual state of the system.


EXAMPLE(S)

     To display the active workgroups on an MPE/iX system, enter:

     SHOWWG @

     To display the member processes of the CS_Default workgroup,
     enter:

     SHOWWG CS_Default; format= procs

     To direct the current configuration of user-defined workgroups
     to a file, enter:

     SHOWWG @; format= wgfile > file

RELATED INFORMATION

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

Manuals :   MPE/iX Intrinsics Reference Manual (32650-90028)
            Using the HP3000 Workload Manager (B3879-90001)