Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Displays scheduling and process data pertaining to the specified
workgroup(s).
SHOWWG [ [WORKGROUP=] { workgrpspec
(workgrpspec [,workgrpspec]...) } ]
[ [;FORMAT=] {SUMMARY
WGFILE
PROCS
DETAIL }]
[ {;TRUNC
;NOTRUNC} ]
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.
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"
*******************
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"
*******************
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.
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
Commands: NEWWG, ALTWG, PURGEWG, TUNE, SHOWQ, ALTPROC, SHOWPROC
Manuals : MPE/iX Intrinsics Reference Manual (32650-90028)
Using the HP3000 Workload Manager (B3879-90001)
Back to Main Index