Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTLCK
PrologControl Block Contents
Cross Reference
MRSYTLCK Prolog
DSECT NAME - SYTLCK FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSYTLCK DESCRIPTIVE NAME - Monitor Sample Record Domain 0 - System Domain Record 23 - Formal spin lock data DESCRIPTION - Data saved in each formal lock area for the formal spin locks in the system. List of locks with data in this record: Lock ID Lock Description -------- ---------------- SRMSLOCK: scheduler lock HCPTRQLK: TRQBK queue lock SRMALOCK: adjunct list lock HCPPGDPL: page allocation lock HCPPGDSL: SPOOL allocation lock HCPPGDTL: T-disk allocation lock HCPPGDAL: CPVOL list lock RSAAVLLK: <2G available list lock RSACALLK: global cleared available list lock SYSDATLK: SYSDATE/SYSTODMD lock DCTLLOK: directory control lock FSDVMLK: free storage lock NSUIMGLK: IMG SNTBK lock HCPPGDML: exposure MLOADs & system total MLOAD lock NSUNLSLK: NLS SNTBK lock RSANOQLK: no-owned resource queue lock RCCSFQL: save frame queue lock HCPRCCMA: switch master processor lock RSASXQLK: SXSPM queue lock HCPRCCSL: symbolic-lock list lock RSA2GLCK: >2G available list lock HCPTMFLK: HCPTIMER lock BUTDLKEY: lock for HCPBUTDL RSA2GCLK: >2G available contiguous list lock RSAAVCLK: <2G available contiguous list lock SRMATDLK: lock for updating SRMATOD and SRMATOD2 NOTES: -- A single record is generated for the system at each monitor sample interval.
MRSYTLCK Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 32 SYTLCK Start of monitor record 0 0 Character 0 SYTLCK_CALMRHDR Record header. See MRRECHDR for details. 0 0 Character 20 MRHDR 0 0 Unsigned 2 MRHDRLEN 2 2 Unsigned 2 MRHDRZER 4 4 Unsigned 1 MRHDRDM 5 5 Unsigned 1 * 6 6 Unsigned 2 MRHDRRC 8 8 Character 8 MRHDRTOD 16 10 Character 4 * 20 14 Character 0 MRHDR_END 20 14 Unsigned 4 SYTLCK_CALNMLKS Number of spin locks in this record. That is, the number of SYTLCK_CALLKDATA entries included after this header. 24 18 Unsigned 2 SYTLCK_CALENTSZ The size (in bytes) of each SYTLCK_CALLKDATA entry 26 1A Unsigned 2 SYTLCK_CALENTDSP The displacement (in bytes) from the beginning of this record to the first SYTLCK_CALLKDATA entry. The entries are consecutive in storage starting with the first at this displacement. 28 1C Unsigned 4 * Reserved for future use 32 20 Character 0 SYTLCK_CALENTS Table of SYTLCK_CALLKDATA entries, one for each formal spin lock arranged one after the other at the end of this record. The SYTLCK_CALLCKID field in each entry should be used to determine which lock the entry represents. See the list of LOCKIDs above to determine which ID represents which lock.
Lock data for an individual formal spin lock. There is a separate entry for each formal spin lock.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 32 SYTLCK_CALLKDATA Formal spin lock data entry 0 0 Character 8 SYTLCK_CALLCKID IDentifier for this lock 8 8 Unsigned 4 SYTLCK_CALXSCNT Total count of times this lock has gone into the formal spin routine when attempting to get the lock in exclusive mode 12 C Character 8 SYTLCK_CALXTIME Total elapsed spin time on this lock when attempting to get it in exclusive mode, starting at zero and counting up 20 14 Unsigned 4 SYTLCK_CALSSCNT Total count of times this lock has gone into the formal spin routine when attempting to get a share of the lock 24 18 Character 8 SYTLCK_CALSTIME Total elapsed spin time on this lock when attempting to get it in shared mode, starting at zero and counting up
MRSYTLCK Cross Reference
Hex Hex Name Offset Length Value MRHDR 0 20 MRHDR_END 14 0 MRHDRDM 4 1 MRHDRLEN 0 2 MRHDRRC 6 2 MRHDRTOD 8 8 MRHDRZER 2 2 SYTLCK 0 32 SYTLCK_CALENTDSP 1A 2 SYTLCK_CALENTS 20 0 SYTLCK_CALENTSZ 18 2 SYTLCK_CALLCKID 0 8 SYTLCK_CALLKDATA 0 32 SYTLCK_CALMRHDR 0 0 SYTLCK_CALNMLKS 14 4 SYTLCK_CALSSCNT 14 4 SYTLCK_CALSTIME 18 8 SYTLCK_CALXSCNT 8 4 SYTLCK_CALXTIME C 8
This information is based on z/VM V5R4.0.
Last updated on 5 Sep 2008 at 19:32:41.
Copyright IBM Corporation, 1990, 2008