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