Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

LCKLF

Prolog  

Control Block Contents  
   LCKLF DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


LCKLF Prolog

 NAME       : HCPLCKLF
 DESCRIPTION: CFLF LOCK TABLE (LCK)
 DSECT      : LCKLF
 COPYRIGHT -
 THIS MODULE  S "RESTRICTED MATERIALS OF IBM"
 5654-A17 (C) COPYRIGHT IBM CORP. - 1992, 2001
 LICENSED MAT RIALS - PROPERTY OF IBM
 FUNCTION   : DESCRIBES A CFLF LOCK TABLE ENTRY USED BY HCPLFP
              WHEN PROCESSING CFLF ORDERS.
              THERE IS ONE LOCK TABLE PER CFLF CONFIGURATION.
 LOCATED BY : None
              CFGLKTBL IN HCPCFGLF
 CREATED BY : HCPLFP
 DELETED BY : HCPLFCST, HCPLFCRL, HCPLFPSF
 SERIALIZED : CFLF CONFIGURATION LOCK

 

LCKLF Control Block Content


LCKLF DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      LCKLF          CFLF LOCK TABLE (LCK)
0000    0 Bitstring    2 LCKLSSID       SUBSYSTEM ID
0002    2 Bitstring    1 LCKLPRT        PARTITION NUMBER
0003    3 Character    8 LCKLCKN        CFLF LOCK NAME
000B   11 Bitstring    1 *              RESERVED FOR IBM USE
000C   12 Bitstring    1 LCKLGLS        GLOBAL LOCK STATE
000D   13 Bitstring    1 LCKLFLG        FLAGS
          1... ....      LCKLFCS        X'80' CONTENTION SCAN COMPLETE
000E   14 Bitstring    2 *              RESERVED FOR IBM USE
0010   16 Address      4 LCKLFWT        ADDRESS OF FIRST QUEUED WAITER
0014   20 Address      4 LCKLLWT        ADDRESS OF LAST QUEUED WAITER
0018   24 Bitstring    8 LCKLHLD        LOCK HOLDER ENTRY
          00000001       LCKLHLD8       (L'LCKLHLD+7)/8
     THERE IS ONE HOLDER ENTRY IN THE LOCK TABLE ENTRY ITSELF. MORE HOLDERS
     MAY BE CHAINED IN FREE STORAGE BLOCKS USING THE SAME FIELD FORMAT.
0018   24 Bitstring    1 LCKLHID        ID OF HOLDER
0019   25 Bitstring    1 LCKLHFG        HOLDER FLAGS
          1... ....      LCKLHC         X'80' CONTENTION OPTION REQUESTED
001A   26 Bitstring    1 *              RESERVED FOR IBM USE
001B   27 Bitstring    1 LCKLHLS        HOLDER LOCK STATE
001C   28 Address      4 LCKLHPT        NEXT HOLDER POINTER
0020   32 Bitstring    8 LCKLWTR        LOCK WAITER ENTRY
          00000001       LCKLWTR8       (L'LCKLWTR+7)/8
     THERE IS ONE WAITER ENTRY IN THE LOCK TABLE ENTRY ITSELF. MORE WAITERS
     MAY BE CHAINED IN FREE STORAGE BLOCKS USING THE SAME FIELD FORMAT.
0020   32 Bitstring    1 LCKLWID        ID OF WAITER
0021   33 Bitstring    1 LCKLWFG        WAITER FLAGS
0022   34 Bitstring    1 LCKLMSK        LOCK MASK
0023   35 Bitstring    1 LCKLRLS        REQUESTED LOCK STATE
0024   36 Address      4 LCKLWPT        NEXT WAITER POINTER
          00000028       LCKLSIZ        *-LCKLF SIZE IN BYTES
          00000005       LCKSIZ8        (*-LCKLF+7)/8 SIZE IN DOUBLEWORDS
     LOCK FRAME CONTROL INFORMATION FOLLOWS...
          00000064       LCKPFRM        (*-LCKLF)/LCKLSIZ MAXIMUM LOCKS
                                        PER FRAME
0FB8 4024 Address      4 LCKFPTR        POINTER TO NEXT LOCK FRAME
0FBC 4028 Address      4 LCKBPTR        POINTER TO PREVIOUS LOCK FRAME
0FC0 4032 Signed       4 LCKWRKSV (16)  SAVEAREA FOR LOCK PROCESSING
          00000048       LCKSUFIX       *-LCKFPTR SIZE OF LOCK TABLE
                                        SUFFIX

 

LCKLF Storage Layout

          
*** LCKLF - CFLF LOCK TABLE (LCK)
*
*     +-------------+------+----------------------------------+
*   0 |  LCKLSSID   |:LPRT |            LCKLCKN-              |
*     +-------------+------+------+------+------+-------------+
*   8 |      -(003)        |//////|:LGLS |:LFLG |/////////////|
*     +--------------------+------+------+------+-------------+
*  10 |         LCKLFWT           |         LCKLLWT           |
*     +---------------------------+---------------------------+
*  18 |                       LCKLHLD                         |
*     +-------------------------------------------------------+
*  20 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
* FB8 |         LCKFPTR           |         LCKBPTR           |
*     +---------------------------+---------------------------+
* FC0 |                                                       |
*     =                       LCKWRKSV                        =
*     |                                                       |
*     +-------------------------------------------------------+
*1000
*
*** LCKLF - CFLF LOCK TABLE (LCK)
          
*** Overlay for LCKLHLD in LCKLF
*
*     +------+------+------+------+---------------------------+
*  18 |:LHID |:LHFG |//////|:LHLS |         LCKLHPT           |
*     +------+------+------+------+---------------------------+
*  20 |                       LCKLWTR                         |
*     +-------------------------------------------------------+
*  28
*
*** Overlay for LCKLHLD in LCKLF
          
*** Overlay for LCKLWTR in LCKLF
*
*     +------+------+------+------+---------------------------+
*  20 |:LWID |:LWFG |:LMSK |:LRLS |         LCKLWPT           |
*     +------+------+------+------+---------------------------+
*  28
*
*** Overlay for LCKLWTR in LCKLF

 

LCKLF Cross Reference

Symbol         Dspl Value
-------------- ---- -----
LCKBPTR        0FBC
LCKFPTR        0FB8
LCKLCKN        0003
LCKLFCS        000D 80
LCKLFLG        000D
LCKLFWT        0010
LCKLGLS        000C
LCKLHC         0019 80
LCKLHFG        0019
LCKLHID        0018
LCKLHLD        0018
LCKLHLD8       0018 00000001
LCKLHLS        001B
LCKLHPT        001C
LCKLLWT        0014
LCKLMSK        0022
LCKLPRT        0002
LCKLRLS        0023
LCKLSIZ        0024 00000028
LCKLSSID       0000
LCKLWFG        0021
LCKLWID        0020
LCKLWPT        0024
LCKLWTR        0020
LCKLWTR8       0020 00000001
LCKPFRM        0024 00000064
LCKSIZ8        0024 00000005
LCKSUFIX       0FC0 00000048
LCKWRKSV       0FC0

This information is based on z/VM V4R3.0. Last updated on 30 Apr 2002 at 16:42:39 EDT.
Copyright IBM Corporation, 1990, 2002