NAME       : HCPLOCBK
 DESCRIPTION: C System Services Lock block
 DSECT      : LOCBK
 FUNCTION   : C System Services Lock block used to describe the
              spin lock used by platform specific C Services
 LOCATED BY : Passed as argument on lock, unlock, testLock
              and eventWait services
 CREATED BY : allocateLock service
 DELETED BY : deallocateLock service
 SERIALIZED : CP lock routines
 RELOCATION CONSIDERATIONS : None
 NOTES      : This COPY file was modeled after HCPSYNBK so the
              existing CP spin lock routines could be utilized.

 LOCBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      LOCBK          C System Services Lock block
0000    0 Signed       8 LOCSLOCK (6)   Spin lock
0030   48 Address      8 LOCTHRED       Pointer to thread which holds
                                        lock
          00000038       LOCBSIZE       *-LOCBK size in bytes
          00000007       LOCSIZE        (*-LOCBK+7)/8 size in double
                                        words
0000    0 Signed       8 LOCLOCK        First doubleword of the lock area
0000    0 Bitstring    1 LOCSTATE       Lock word (0 = not held, else CPU
                                        id)
0001    1 Bitstring    1 *              Reserved for future IBM use
0002    2 Signed       2 LOCSHCNT       Shared hold count
0004    4 Signed       2 LOCSEQ         Lock sequence number
0006    6 Signed       2 LOCHCPAD       CPU addr of lock holder
0038   56 Signed       2 LOCSWCNT       Shared wait count
003A   58 Signed       2 LOCXWCNT       Exclusive wait count
003C   60 Signed       4 LOCSSCNT       Shared spin count
0040   64 Signed       8 LOCSTIME       Total elapsed shared spin time
0048   72 Signed       4 LOCHOLDR       Address of holder of this lock
004C   76 Signed       4 LOCXSCNT       Exclusive spin count
0050   80 Signed       8 LOCXTIME       Total elapsed exclusive spin time
0058   88 Signed       2 LOCPLSDS       Displacement of shared lock
                                        holder field into the PLSBK
005A   90 Signed       2 *              Reserved for future IBM use
005C   92 Signed       4 *              Reserved for future IBM use

 
*** LOCBK - C System Services Lock block
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       LOCSLOCK                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  30 |                       LOCTHRED                        |
*     +-------------+-------------+---------------------------+
*  38 |  LOCSWCNT   |  LOCXWCNT   |         LOCSSCNT          |
*     +-------------+-------------+---------------------------+
*  40 |                       LOCSTIME                        |
*     +---------------------------+---------------------------+
*  48 |         LOCHOLDR          |         LOCXSCNT          |
*     +---------------------------+---------------------------+
*  50 |                       LOCXTIME                        |
*     +-------------+-------------+---------------------------+
*  58 |  LOCPLSDS   |/////////////|///////////////////////////|
*     +-------------+-------------+---------------------------+
*  60
*
*** LOCBK - C System Services Lock block
 
*** Overlay for LOCSLOCK in LOCBK
*
*     +-------------------------------------------------------+
*   0 |                       LOCLOCK                         |
*     +-------------------------------------------------------+
*   8
*
*** Overlay for LOCSLOCK in LOCBK
 
*** Overlay for LOCSLOCK in LOCBK
*
*     +------+------+-------------+-------------+-------------+
*   0 |:STATE|//////|  LOCSHCNT   |   LOCSEQ    |  LOCHCPAD   |
*     +------+------+-------------+-------------+-------------+
*   8
*
*** Overlay for LOCSLOCK in LOCBK

 
Symbol         Dspl Value
-------------- ---- -----
LOCBSIZE       0030 00000038
LOCHCPAD       0006
LOCHOLDR       0048
LOCLOCK        0000
LOCPLSDS       0058
LOCSEQ         0004
LOCSHCNT       0002
LOCSIZE        0030 00000007
LOCSLOCK       0000
LOCSSCNT       003C
LOCSTATE       0000
LOCSTIME       0040
LOCSWCNT       0038
LOCTHRED       0030
LOCXSCNT       004C
LOCXTIME       0050
LOCXWCNT       003A