XLKBK | Back to Index page

| Prolog Control Block Contents XLKBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

XLKBK Prolog | Top of page

     NAME       : HCPXLKBK
     DESCRIPTION: XDISK Cross-System Lock Structure
     DSECT      : XLKBK
     LOCATED BY : RDEVXDLK
                  SYSXVOLK
     CREATED BY : HCPXLKIN
     DELETED BY : HCPXLKDE
     RELOCATION CONSIDERATIONS : None

XLKBK Control Block Content | Top of page

     XLKBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      XLKBK          XDISK Cross-System Lock Structure
    0000    0 Dbl-Word     8 XLKLKWRD (3)   Distributed Lock Word
    0018   24 Dbl-Word     8 XLKQLKWD (3)   Queue Lock Word
    0030   48 Dbl-Word     8 XLKTIME        TOD of last cross-SSI acquire
    0038   56 Signed       4 XLKTIMEO       Count of XLK locks cleared by
                                            HCPXLKAR watchdog timeout
    003C   60 Signed       4 XLKTHRDS       Mask of systems that have an
                                            outstanding lock grant
    0040   64 Signed       4 XLKCOMSK       Communication mask
    0044   68 Signed       4 XLKABORT       ABORT Communication mask
    0048   72 Signed       4 XLKASSOC       Address of associated data
    004C   76 Signed       4 XLKASSLT       List of 2ndary associates
    0050   80 Signed       4 XLKWTCHD       Watchdog task
    0054   84 Signed       2 XLKQTAIL       Highest priority on queue ds
    0056   86 Bitstring    1 XLKTYPE        Lock Type
              00000000       XLKTMDCH       0 XLKTMDCH Lock Type: RDEV MDISK
                                            Chain
              00000004       XLKTSYSV       4 XLKTSYSV Lock Type: SYSVOL
              00000008       XLKTVAA        8 XLKTVAA Lock Type: HCPARDVA
                                            VAABK
    0057   87 Bitstring    1 XLKFLAG0       Flag byte 0
              1... ....      XLKLOCAL       X'80' XLKLOCAL Lock held
                                            local-only
              .1.. ....      XLKMYSYS       X'40' XLKMYSYS Lock held by local
                                            system
              ..1. ....      XLKREMOT       X'20' XLKREMOT Lock held by
                                            remote system
              ...1 ....      XLKSAFE        X'10' XLKSAFE Lock has not yet
                                            been updated after SAFE mode
    0058   88 Bitstring    1 XLKFLAG1       Flag byte 1 *** Only applicable
                                            to XLKTYPE of XLKTVAA
              00000001       XLKNWT         1 XLKNWT No Work Task received
              00000002       XLKYWT         2 XLKYWT Yes Work Task received
                                            *** Operation Codes arguments to
                                            HCPXLKUU
              00000004       XLKDelt1       04 XLKDelt1 Change XLKFLAG1 state
                                            from XLKNWT to XLKYWT.
    0059   89 Bitstring    1 * (3)          Reserved for IBM use
    005C   92 Signed       2 XLKRARCN       Count of XLKRAs that were
                                            re-driven due to a lost reply
    005E   94 Signed       2 XLKRRRCN       Count of XLKRRs that were
                                            re-driven due to a lost reply
    0060   96 Signed       4 XLKUNQL        The last XLKUNQ value. Serialized
                                            by XLKQLKWD
    0064  100 Signed       4 XLKUNQ         Current uniqueifier value, Zero
                                            if unlocked. Serialized by
                                            XLKQLKWD
          The replication factor for XLKSEQN field for BLOCKMAP is 32
    0068  104 Signed       1 XLKSEQN (32)   1 byte Sequence Numbers 1 byte
                                            per system
    0088  136 Signed       4 XLKXLGET       Count of exclusive acquires that
                                            did not require comm.
    008C  140 Signed       4 XLKXXGET       Count of exclusive acquires that
                                            required cross-SSI comm.
    0090  144 Signed       4 XLKXDFRS       Count of acquires that deferred
                                            before starting SSI negotiation
    0094  148 Signed       4 XLKXAMSG       Count of messages sent in order
                                            to achieve exclusive acquires
    0098  152 Signed       4 XLKXARPL       Count of messages received in
                                            response to exclusive acquires
    009C  156 Signed       4 XLKCLENS       Count of cleanups performed on
                                            this lock
    00A0  160 Dbl-Word     8 XLKXAWTM       TOD time spent deferred waiting
                                            to communicate for excl. acq.
    00A8  168 Dbl-Word     8 XLKXARTM       TOD time spent deferred waiting
                                            for responses to excl. acq.
    00B0  176 Dbl-Word     8 XLKXRWTM       TOD time spent deferred waiting
                                            to communicate for excl. rel.
    00B8  184 Dbl-Word     8 XLKXRRTM       TOD time spent deferred waiting
                                            for responses to excl. rel.
    00C0  192 Dbl-Word     8 XLKXHELD       TOD time spent holding the lock
                                            exclusively across the SSI on
                                            behalf of this system
    00C8  200 Signed       4 XLKMRTRY       Maximum number of retries ever
                                            seen for any acquisition of this
                                            lock.
    00CC  204 Signed       4 XLKTRTRY       Total number of retries for all
                                            acquisitions of this lock
    00D0  208 Signed       2 XLKHGBST       Highest priority boost ever seen
                                            for this lock.
    00D2  210 Signed       2 *              Reserved for IBM use
    00D4  212 Signed       4 XLKGOTAT       Address caller that presently
                                            holds the lock on this system (0
                                            if not held or held for another
                                            member)
    00D8  216 Signed       4 XLKCOUNT       # of instances of this lock
    00DC  220 Signed       4 XLKACTIV       Count of reply threads that are
                                            presently active
    00E0  224 Signed       4 XLKSENT        Mask of systems that received the
                                            last lock request
    00E4  228 Signed       4 XLKGOTSV       Savearea when lock obtained
    00E8  232 Signed       4 * (6)          Reserved for IBM use
              00000020       XLKDSIZE       (*-XLKBK+7)/8 size in double
                                            words
              00000100       XLKBSIZE       (*-XLKBK) size in bytes

XLKBK Storage Layout | Top of page

    *** XLKBK - XDISK Cross-System Lock Structure
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       XLKLKWRD                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  18 |                                                       |
    *     =                       XLKQLKWD                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  30 |                       XLKTIME                         |
    *     +---------------------------+---------------------------+
    *  38 |         XLKTIMEO          |         XLKTHRDS          |
    *     +---------------------------+---------------------------+
    *  40 |         XLKCOMSK          |         XLKABORT          |
    *     +---------------------------+---------------------------+
    *  48 |         XLKASSOC          |         XLKASSLT          |
    *     +---------------------------+-------------+------+------+
    *  50 |         XLKWTCHD          |  XLKQTAIL   |:TYPE |:FLAG0|
    *     +------+--------------------+-------------+------+------+
    *  58 |:FLAG1|////////////////////|  XLKRARCN   |  XLKRRRCN   |
    *     +------+--------------------+-------------+-------------+
    *  60 |         XLKUNQL           |          XLKUNQ           |
    *     +---------------------------+---------------------------+
    *  68 |                                                       |
    *     =                       XLKSEQN                         =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  88 |         XLKXLGET          |         XLKXXGET          |
    *     +---------------------------+---------------------------+
    *  90 |         XLKXDFRS          |         XLKXAMSG          |
    *     +---------------------------+---------------------------+
    *  98 |         XLKXARPL          |         XLKCLENS          |
    *     +---------------------------+---------------------------+
    *  A0 |                       XLKXAWTM                        |
    *     +-------------------------------------------------------+
    *  A8 |                       XLKXARTM                        |
    *     +-------------------------------------------------------+
    *  B0 |                       XLKXRWTM                        |
    *     +-------------------------------------------------------+
    *  B8 |                       XLKXRRTM                        |
    *     +-------------------------------------------------------+
    *  C0 |                       XLKXHELD                        |
    *     +---------------------------+---------------------------+
    *  C8 |         XLKMRTRY          |         XLKTRTRY          |
    *     +-------------+-------------+---------------------------+
    *  D0 |  XLKHGBST   |/////////////|         XLKGOTAT          |
    *     +-------------+-------------+---------------------------+
    *  D8 |         XLKCOUNT          |         XLKACTIV          |
    *     +---------------------------+---------------------------+
    *  E0 |         XLKSENT           |         XLKGOTSV          |
    *     +---------------------------+---------------------------+
    *  E8 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    * 100
    *
    *** XLKBK - XDISK Cross-System Lock Structure

XLKBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    XLKABORT       0044
    XLKACTIV       00DC
    XLKASSLT       004C
    XLKASSOC       0048
    XLKBSIZE       00E8 00000100
    XLKCLENS       009C
    XLKCOMSK       0040
    XLKCOUNT       00D8
    XLKDelt1       0058 00000004
    XLKDSIZE       00E8 00000020
    XLKFLAG0       0057
    XLKFLAG1       0058
    XLKGOTAT       00D4
    XLKGOTSV       00E4
    XLKHGBST       00D0
    XLKLKWRD       0000
    XLKLOCAL       0057 80
    XLKMRTRY       00C8
    XLKMYSYS       0057 40
    XLKNWT         0058 00000001
    XLKQLKWD       0018
    XLKQTAIL       0054
    XLKRARCN       005C
    XLKREMOT       0057 20
    XLKRRRCN       005E
    XLKSAFE        0057 10
    XLKSENT        00E0
    XLKSEQN        0068
    XLKTHRDS       003C
    XLKTIME        0030
    XLKTIMEO       0038
    XLKTMDCH       0056 00000000
    XLKTRTRY       00CC
    XLKTSYSV       0056 00000004
    XLKTVAA        0056 00000008
    XLKTYPE        0056
    XLKUNQ         0064
    XLKUNQL        0060
    XLKWTCHD       0050
    XLKXAMSG       0094
    XLKXARPL       0098
    XLKXARTM       00A8
    XLKXAWTM       00A0
    XLKXDFRS       0090
    XLKXHELD       00C0
    XLKXLGET       0088
    XLKXRRTM       00B8
    XLKXRWTM       00B0
    XLKXXGET       008C
    XLKYWT         0058 00000002

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:31:54 EDT.
Copyright IBM Corporation, 1990, 2020