HP 3000 Manuals HP 3000 Manuals
SHOWWG
Displays scheduling and process data pertaining to the specified
workgroup(s). (Native Mode)
SYNTAX
[ {SUMMARY}]
SHOWWG [[WORKGROUP=] {workgrp }] [[;FORMAT=] {WGFILE }]
[ {(workgrp [,workgrp]...)}] [ {PROCS }]
[ {DETAIL }]
[{;TRUNC }]
[{;NOTRUNC}]
PARAMETERS
workgrp 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 and purge-pending workgroups are preceeded
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 Truncates lines 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. This option is ignored with the
WGFILE format.
NOTRUNC Allows names to appear in their full form. As a result,
output from the command will wrap around the display. This
option is ignored with the WGFILE format. For the SUMMARY
format, NOTRUNC applies to the line length. That is, if
the length of the SUMMARY line displayed exceeds the line
length of the user's $STDLIST device, characters wrap to
the next line.
OPERATION
Use the SHOWWG command to display attributes of the specified
workgroup(s) in one of four output formats, SUMMARY, WGFILE, PROCS, and
DETAIL.
The workgrp parameter allows for wildcarding. SHOWWG displays the
workgroups in the same order that the system traverses the workgroups
(for example, when performing workgroup assignment).
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. Below is
a sample output:
_________________________________________________________________________________________
| |
| |
| :SHOWWG @; FORMAT=SUMMARY |
| |
| -----QUANTUM----- TIME CPU % |
| WORKGROUP BASE LIMIT MIN MAX ACTUAL BOOST SLICE PROCS MIN MAX |
| ------------------- ---- ----- ----- ---- ------ ----- ------ ----- --- --- |
| ~Program_Developm$ 160 170 1000 1000 1000 DECAY 300 63 10 15 |
| Payroll_Online 152 200 1000 1000 1000 OSC 300 433 30 40 |
| Payroll_Batch 180 230 1000 1000 1000 DECAY 300 210 20 100 |
| AS_Default 13 99 N/A N/A N/A N/A 1000 45 N/A N/A |
| BS_Default 100 150 N/A N/A N/A N/A 1000 73 N/A N/A |
| CS_Default 152 200 1 2000 576 DECAY 200 320 N/A N/A |
| DS_Default 202 238 2000 2000 2000 DECAY 200 217 N/A N/A |
| ES_Default 240 253 2000 2000 2000 DECAY 200 81 N/A N/A |
| |
_________________________________________________________________________________________
NOTE Processes within the workgroup need not have their priorities fall
within the specified base and limit values. N/A refers to the fact
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, you will see an
N/A displayed 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 (19): The workgroup name, which is always truncated to 18
characters. A $ is appended to the workgroup name (as
the nineteenth character) to indicate truncation.
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.
CPU MIN (3): The minimum CPU percentage currently established for
the workgroup.
CPU MAX (3): The maximum CPU percentage currently established for
the workgroup.
The WGFILE format displays the membership criteria and scheduling
characteristics for the specified workgroup(s). The output generated is
suitable as input to NEWWG and is therefore never truncated. Below is an
example of the WGFILE format.
:SHOWWG @; format=wgfile
Workgroup = Program_Development
;Memb_Logon = @.TEST,"NM@,@.MYTEST"
;Memb_Program = EDITOR.PUB.SYS, QEDIT.@.@, HPEDIT.@.@
;Base = 160
;Limit = 170
;MinQuant = 1000
;MaxQuant = 1000
;Boost = DECAY
;Timeslice = 300
;Mincpupct = 10
;Maxcpupct = 15
***********************
COMMENT
COMMENT The following workgroup is purge-pending.
COMMENT
COMMENT WORKGROUP = ~Test_DB
COMMENT ;Memb_Logon = @.TEST,"NM@,@.MYTEST"
COMMENT ;Base = 170
COMMENT ;Limit = 180
COMMENT ;MinQuant = 1000
COMMENT ;MaxQuant = 1000
COMMENT ;Boost = OSCILLATE
COMMENT ;Timeslice = 200
COMMENT ;Mincpupct = 0
COMMENT ;Maxcpupct = 15
*************************
Workgroup = Payroll_Online
;Memb_Program = PAYROLL.@.PRAPP
;Memb_Queue = CS
;Base = 152
;Limit = 200
;MinQuant = 1000
;MaxQuant = 1000
;Boost = OSCILLATE
;Timeslice = 300
;Mincpupct = 30
;Maxcpupct = 40
*************************
Workgroup = Payroll_Batch
;Memb_Program = PAYROLL.@.PRAPP
;Memb_Queue = DS, ES
;Base = 182
;Limit = 230
;MinQuant = 1000
;MaxQuant = 1000
;Boost = DECAY
;Timeslice = 300
;Mincpupct = 20
;Maxcpupct = 100
*************************
COMMENT
COMMENT The following workgroup is purge-pending.
COMMENT
COMMENT WORKGROUP = ~Payroll_Online
COMMENT ;Memb_Program = PAYROLL.@.PRAPP
COMMENT ;Memb_Queue = CS
COMMENT ;Base = 152
COMMENT ;Limit = 200
COMMENT ;MinQuant = 1000
COMMENT ;MaxAuant = 1000
COMMENT ;Boost = OSCILLATE
COMMENT ;Timeslice = 300
COMMENT ;Mincpupct = 30
COMMENT ;Maxcpupct = 40
**************************
COMMENT The following are system-defined (default) workgroups.
COMMENT
COMMENT
COMMENT Workgroup = AS_Default
COMMENT ;Memb_Queue = AS
COMMENT ;Base = 13
COMMENT ;Limit = 99
COMMENT ;MinQuant = N/A
COMMENT ;MaxQuant = N/A
COMMENT ;Boost = N/A
COMMENT ;Timeslice = 1000
COMMENT ;Mincpupct = N/A
COMMENT ;Maxcpupct = N/A
**************************
COMMENT
COMMENT Workgroup = BS_Default
COMMENT ;Memb_Queue = BS
COMMENT ;Base = 100
COMMENT ;Limit = 150
COMMENT ;MinQuant = N/A
COMMENT ;MaxQuant = N/A
COMMENT ;Boost = N/A
COMMENT ;Timeslice = 1000
COMMENT ;Mincpupct = N/A
COMMENT ;Maxcpupct = N/A
**************************
COMMENT
COMMENT Workgroup = CS_Default
COMMENT ;Memb_Queue = CS
COMMENT ;Base = 152
COMMENT ;Limit = 200
COMMENT ;MinQuant = 200
COMMENT ;MaxQuant = 2000
COMMENT ;Boost = DECAY
COMMENT ;Timeslice = 200
COMMENT ;Mincpupct = N/A
COMMENT ;Maxcpupct = N/A
**************************
COMMENT
COMMENT Workgroup = DS_Default
COMMENT ;Memb_Queue = DS
COMMENT ;Base = 202
COMMENT ;Limit = 238
COMMENT ;MinQuant = 2000
COMMENT ;MaxQuant = 2000
COMMENT ;Boost = DECAY
COMMENT ;Timeslice = 2000
COMMENT ;Mincpupct = N/A
COMMENT ;Maxcpupct = N/A
**************************
COMMENT
COMMENT Workgroup = ES_Default
COMMENT ;Memb_Queue = ES
COMMENT ;Base = 240
COMMENT ;Limit = 253
COMMENT ;MinQuant = 2000
COMMENT ;MaxQuant = 2000
COMMENT ;Boost = DECAY
COMMENT ;Timeslice = 2000
COMMENT ;Mincpupct = N/A
COMMENT ;Maxcpupct = N/A
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 54 180 D 0:05.020 WAIT S41 :tdp "text myfile" |
| %124 38 185 D 0:12.990 WAIT J12 (TDP.PUB.SYS) text myfile |
| 189 67 183 D 0:01.030 READY S57 (FCOPY.PUB.SYS)from=foo.pub.sys |
| ;to=b$ |
| ******************* |
| |
| 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 processes 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 call).
PARENT (5): Process Identification Number for the process' parent
(decimal). This field appears in the DETAIL and PROCS
formats. These formats display PARENT to help you
determine process relationships. Nothing is displayed
when a 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). Linear
processes run at fixed priority, whereas decayable
processes experience priority decay.
CPUTIME (8): CPU is consumed in hh:mm:ss or m:ss.mls. A pair of
asterisks (**) appears in the hours field when hours
overflows. The three-character "mls" sub-field holds
milliseconds.
STATE (5):
This indicates the execution state of the process.
STATE can be one of the following:
* BLKIO blocked for terminal write or control.
* WAIT generic process block, usually waiting for
a message.
* BLKCB blocked for control block.
* BLKMM blocked for memory manager.
* 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). Below is a sample output created using the NOTRUNC option:
_____________________________________________________________________________________________
| |
| |
| :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 |
| 189 67 183 D 0:01.030 READY S57 (FCOPY.PUB.SYS)from=foo.pub.sys;to=ba |
| r;new |
| ******************* |
| |
| 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 Regardless of format, SHOWWG lists workgroups as they appear in the
ordered list, which is identical to the search order used to
determine workgroup membership. SHOWWG gets this order and all
other displayed values from system tables and not from files, thus
showing the actual state of the system.
EXAMPLE
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
temporary file, and then save that file in the permanent file domain,
enter:
:SHOWWG @; format= wgfile > file
:SAVE file
Related Information
Commands NEWWG, ALTWG, PURGEWG, TUNE, SHOWQ, ALTPROC, SHOWPROC
Manuals MPE XL Intrinsics Reference Manual (32650-90028)