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