HP 3000 Manuals

Introducing the Workload Manager New and Modified Macros [ COMMUNICATOR 3000 MPE/iX General Release 5.0 (Core Software Release C.50.00) ] MPE/iX Communicators


COMMUNICATOR 3000 MPE/iX General Release 5.0 (Core Software Release C.50.00)

Introducing the Workload Manager New and Modified Macros 

by Phuong Nguyen 
Commercial Systems Division 

With the implementation of the Workload Manager, changes were made in the
Dispatcher Globals and the Dispatcher Info area of the process's PIB
entry.  Some of the existing macros have been modified to reflect those
changes and a new macro has been implemented to display the workgroup's
information.

This article is intended for Support Engineers and individuals interested
in analyzing workgroup data structures.

New Macro 

pm_disp_workgroup_info 

The new macro, pm_disp_workgroup_info, formats the user-defined and
defaulted workgroup's information.  This macro gives you easy access to
such information as queue priority limits, and the workgroup's quantum
and CPU percentage information.
_____________________________________________________________________________________
|                                                                                   |
|             ==== DISPATCHER WORKGROUP INFORMATION ====                            |
|                                                                                   |
|         -----QUANTUM-----               TIME       CPU %                          |
|      WORKGROUP   BASE LIMIT   MIN     MAX      ACTUAL   BOOST SLICE PROCS MIN  MAX|
|     ----------- ----- ----- ------- --------- --------  ----- ----- ----- ---  ---|
|     Data-entry  $33ff $25ff $15f90   $aba9500 $f20a3    DECAY  $2    $7   $14  $64|
|     Billing     $33ff $25ff $15f90   $aba9500 $30fa89   DECAY  $2    $7   $14  $64|
|     Payroll     $33ff $25ff $15f90   $aba9500 $3f15ce   DECAY  $2    $3   $14  $64|
|     Info        $33ff $25ff $15f90   $aba9500 $d001d5   DECAY  $2    $2   $a   $64|
|     Miscellaneou$33ff $25ff $15f90   $aba9500 $408b008  DECAY  $2    $6   $a   $64|
|     HIPRI       $33ff $33ff $15f90   $aba9500 $112a880  DECAY  $2    $0   $0   $64|
|     AS_Default  $70ff $4e7f $0       $0       $0        DECAY  $a    $f   $0   $64|
|     BS_Default  $4dff $34ff $0       $0       $0        DECAY  $a    $31  $0   $64|
|     CS_Default  $33ff $16ff $15f90   $aba9500 $572bcb   DECAY  $2    $11  $0   $64|
|     DS_Default  $1aff $8ff  $aba9500 $aba9500 $aba9500  DECAY  $2    $0   $0   $64|
|     ES_Default  $7ff  $17f  $aba9500 $aba9500 $aba9500  DECAY  $2    $0   $0   $64|
|                                                                                   |
_____________________________________________________________________________________

            

An optional parameter can be used to determine the level of detail to
print as follows :

0 - 2   Prints only the first eleven characters of each workgroup name.

3 - 5   Prints the complete workgroup name by printing successive
        portions of the name on successive lines.

The default is 1.

Modified Macros 

process_dispatcher 

The process_dispatcher macro was changed to call the new macro,
pm_disp_workgroup_info, to print the user-defined workgroup information
if the number of workgroups is greater than five.  Otherwise, it will
call pm_disp_global to print the information of the standard five default
workgroups.

process_dispatcher formats the Dispatcher Queues, Dispatcher Workgroup
information and selected System Globals.
_____________________________________________________________________________________
|                                                                                   |
|      ===== DISPATCHER INFORMATION FOR A PROCESS =====                             |
|     S                                                                             |
|     y                                                                             |
|     s                                                                             |
|     p                                                                             |
|     r                                                                             |
|     o                                                                             |
|     c PIN #  State          Wait Event     Pri   Class  Blocked Reason            |
|     - -----  -----          ----------     ---   -----  --------------            |
|       $53    READY          Not Waiting    $2fff  DS    NOT_BLOCKED               |
|       $87    READY          Not Waiting    $25ff  BS    QUANTUM_EXPIRATION        |
|       $84    EXECUTING(0)   Not Waiting    $25ff  DS    QUANTUM_EXPIRATION        |
|       $6a    READY          Not Waiting    $25ff  DS    QUANTUM_EXPIRATION        |
|       $5f    READY          Not Waiting    $25ff  DS    QUANTUM_EXPIRATION        |
|       $78    READY          Not Waiting    $25ff  DS    QUANTUM_EXPIRATION        |
|       $56    READY          Not Waiting    $1aff  DS    NOT_BLOCKED               |
|     Total of #7 processes on the Dispatch Queue                                   |
|                                                                                   |
|      ==== DISPATCHER WORKGROUP INFORMATION ====                                   |
|                                                                                   |
|         -----QUANTUM-----               TIME       CPU %                          |
|      WORKGROUP   BASE LIMIT   MIN     MAX      ACTUAL   BOOST SLICE PROCS MIN  MAX|
|     ----------- ----- ----- ------- --------- --------  ----- ----- ----- ---  ---|
|     Data-entry  $33ff $25ff $15f90   $aba9500 $f20a3    DECAY  $2    $7   $14  $64|
|     Billing     $33ff $25ff $15f90   $aba9500 $30fa89   DECAY  $2    $7   $14  $64|
|     Payroll     $33ff $25ff $15f90   $aba9500 $3f15ce   DECAY  $2    $3   $14  $64|
|     Info        $33ff $25ff $15f90   $aba9500 $d001d5   DECAY  $2    $2   $a   $64|
|     Miscelleanou$33ff $25ff $15f90   $aba9500 $408b008  DECAY  $2    $6   $a   $64|
|     HIPRI       $33ff $33ff $15f90   $aba9500 $112a880  DECAY  $2    $0   $0   $64|
|     AS_Default  $70ff $4e7f $0       $0       $0        DECAY  $a    $f   $0   $64|
|     BS_Default  $4dff $34ff $0       $0       $0        DECAY  $a    $31  $0   $64|
|     CS_Default  $33ff $16ff $15f90   $aba9500 $572bcb   DECAY  $2    $11  $0   $64|
|     DS_Default  $1aff $8ff  $aba9500 $aba9500 $aba9500  DECAY  $2    $0   $0   $64|
|     ES_Default  $7ff  $17f  $aba9500 $aba9500 $aba9500  DECAY  $2    $0   $0   $64|
|                                                                                   |
|                                                                                   |
|                            ==== SYSTEM GLOBALS ====                               |
|                                                                                   |
|     Disable Dispatcher Count = $0                                                 |
|     Dispatcher Requested = $0                                                     |
|     Dispatcher Running = $1                                                       |
|                                                                                   |
_____________________________________________________________________________________

            

An optional parameter can be used to determine the level of detail to
print as follows:

0       Suppress printing.

1       Print only Dispatcher scheduling information.

2       Print Dispatcher scheduling information and certain
        ICS/Dispatcher relevant information.

3       Print all information plus the Dispatcher queue.

4 - 5   Print all information plus the Dispatcher workgroup information.

The default is 5.

pm_disp_global 

The pm_disp_global macro was modified to print the workgroup-related
information in the Dispatcher Globals area.
_____________________________________________________________________________________
|                                                                                   |
|            ==== DISPATCHER GLOBALS ====                                           |
|     AS  BASEPRI=  $70ff LIMPRI=  $4e7f                                            |
|     BS  BASEPRI=  $4dff LIMPRI=  $34ff                                            |
|     CS  BASEPRI=  $33ff LIMPRI=  $16ff MINQUANTUM= $15f90     MAXQUANTUM= $aba9500|
|     DS  BASEPRI=  $1aff LIMPRI=   $8ff                                            |
|     ES  BASEPRI=   $7ff LIMPRI=   $17f                                            |
|                                                                                   |
|     DGL_PSD_INFO_ARRAY[$0]                                                        |
|                                                                                   |
|     RECORD                                                                        |
|        DGL_PSD_DISP_EVENT_SET      : [ ]                                          |
|        DGL_PSD_PROCESSOR_STATUS    : DISPATCHER_RUNNING                           |
|        DGL_PSD_SWAPIN_FAILED       : FALSE                                        |
|        DGL_PSD_ADD_A_TOKEN         : FALSE                                        |
|        DGL_PSD_ACTIVE_PIB          : 829090c0                                     |
|        DGL_PSD_RPSD_PTR            : 0.3e04280                                    |
|        DGL_PSD_DISP_DISABLE_CNT    : 0                                            |
|        DGL_PSD_DELAY_ID            : 90006                                        |
|        DGL_PSD_MAX_CPU_ID          : a0007                                        |
|        DGL_PSD_CPU_MEAS_STATE      : DISPATCHER_ACTIVE                            |
|        DGL_PSD_CPU_MEAS_STATE_TIME : f9106150d63d20                               |
|        DGL_CARROUSEL_INDEX         : 3                                            |
|        DGL_PSD_FILLER              :                                              |
|           [ 1 ]: 0                                                                |
|           [ 2 ]: 0                                                                |
|           [ 3 ]: 0                                                                |
|           [ 4 ]: 0                                                                |
|     END                                                                           |
|                                                                                   |
_____________________________________________________________________________________

            

An optional parameter can be used to determine the level of detail to
print as follows:

0       Suppress printing.

1       Causes an FV of disp_globals_type.

2 - 5   Prints a useful subset.

The default is 5.



MPE/iX Communicators