NAME       : HCPALCBK
 DESCRIPTION: Access-List Control Block
 DSECT      : ALCBK
 FUNCTION   : This DSECT maps the control block used to manage an
              ESA/370 access list.
 LOCATED BY : ALEALCBK in the second access-list entry of an access
              list built by CP (the one with ALEN=1).
 CREATED BY : HCPALMCR when an access list is created.
 DELETED BY : HCPALMDS when an access list is destroyed.
 RELOCATION CONSIDERATIONS : None
 NOTES      : The contents of this control block, and the access-list
              designation indicated by ALCALD are serialized by the
              access-list-control lock, the lockword for which is
              ASCLOCK.

 ALCBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      ALCBK          Access-List Control Block
                                  block.
0000    0 Address      4 ALCALD         Address of access-list
                                        designation.
0004    4 Address      4 ALCAL          Address of access list
0008    8 Address      4 ALCOWNER       Address of VMDBK which owns the
                                        access list.
000C   12 Signed       4 *              Reserved for IBM use
0010   16 Address      4 ALCSPIBK       Anchor for chain of SPIBKs
                                        defining what address spaces may
                                        be attached to this access list.
                                        This is serialized by the
                                        space-permission-manager lock
                                        (RSASPMLK in HCPRSMCM).
0014   20 Address      4 ALCDEFRQ       Anchor for queue of tasks adding
                                        entries to the CP-use AL which
                                        have been deferred because the
                                        CP-use access list is full.
0018   24 Dbl-Word     8 ALCLOCK (3)    Lockword for access-list-control
                                        lock.
0030   48 Signed       4 ALCALSIZ       Size of access list, in bytes.
0034   52 Signed       4 ALCMAXSZ       Largest permitted size of access
                                        list, in bytes.
0038   56 Signed       4 ALCFREE        Number of ALEs in the invalid
                                        state (not including ALENs 0 and
                                        1). This is the number of ALEs
                                        available for allocation.
003C   60 Signed       4 ALCNXTCP       Next ALE to allocate in the
                                        CP-use access list.
          00000040       ALCLEN         *-ALCBK Length in bytes of ALCBK.
          00000008       ALCSIZE        (ALCLEN+7)/8 Size in doublewords
                                        of an ALCBK

          
*** ALCBK - Access-List Control Block
*
*     +---------------------------+---------------------------+
*   0 |          ALCALD           |          ALCAL            |
*     +---------------------------+---------------------------+
*   8 |         ALCOWNER          |///////////////////////////|
*     +---------------------------+---------------------------+
*  10 |         ALCSPIBK          |         ALCDEFRQ          |
*     +---------------------------+---------------------------+
*  18 |                                                       |
*     =                       ALCLOCK                         =
*     |                                                       |
*     +---------------------------+---------------------------+
*  30 |         ALCALSIZ          |         ALCMAXSZ          |
*     +---------------------------+---------------------------+
*  38 |         ALCFREE           |         ALCNXTCP          |
*     +---------------------------+---------------------------+
*  40
*
*** ALCBK - Access-List Control Block

 
Symbol         Dspl Value
-------------- ---- -----
ALCAL          0004
ALCALD         0000
ALCALSIZ       0030
ALCDEFRQ       0014
ALCFREE        0038
ALCLEN         003C 00000040
ALCLOCK        0018
ALCMAXSZ       0034
ALCNXTCP       003C
ALCOWNER       0008
ALCSIZE        003C 00000008
ALCSPIBK       0010