Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRSYTLCK

Prolog
Control 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               record length in bytes
  2   2  Unsigned     2  MRHDRZER               field of zeros
  4   4  Unsigned     1  MRHDRDM                domain identifier
  5   5  Unsigned     1  *
  6   6  Unsigned     2  MRHDRRC                record identifier
  8   8  Character    8  MRHDRTOD               Time at which this record was
                                                built. In time-of-day (TOD)
                                                clock format. See IBM System
                                                370 XA Principle of Operation
                                                for explanation of format.
 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 V5R3.0.
Last updated on 11 Jun 2007 at 16:03:23.
Copyright IBM Corporation, 2007