HPlogo Using the HP 3000 Workload Manager: HP 3000 MPE/iX Computer Systems > Chapter 5 Commands Reference

SHOWWG
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

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

SYNTAX

   SHOWWG [ [WORKGROUP=]{ workgrp

                          (workgrp [,workgrp]...)} ]



   [ [;FORMAT=]{ SUMMARY

                 WGFILE

                 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)



SHOWQ
  		 


TUNE  
Feedback to webmaster