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

#### BLEBK

Prolog

Control Block Contents
BLEBK DSECT
BLEHD DSECT
BLEFM DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### BLEBK Prolog

     NAME       : HCPBLEBK
     DESCRIPTION: CP application interface table ctl block
     DSECT      : BLEBK
     FUNCTION   : Maintain a table of shared control blocks, and service
                  handles.
     LOCATED BY : Dependent on the function using this
                  generic control block.
     CREATED BY : Dependent on the function using this
                  generic control block.
     DELETED BY : Dependent on the function using this
                  generic control block.
     SERIALIZED : BLELKWRD lock. This lock would only be
                  destroyed if ISFC is not active.
                  Serialization handled by the functions
                  that manipulate the table.
     NOTES      :
                  The BLEHD table header can be allocated or pre-defined.
                  If allocated, it must have been allocated prior to invoking
                  any of the utilities that manipulate the BLEBK tables.
                  The BLEFM and BLEBK tables are dynamically allocated by
                  the BLEBK utilities.
                  This is a general 2-step table for any type of
                  control block.
        BLEHD
       +---------------+
       | BLELKWRD      |
       |---------------|
       | BLETPTR       |
       | BLEFM table ----+
       |---------------| |
       | BLEHI         | |
       |---------------| |
       |               | |
       +---------------+ |
                         |     +---------+
                         |     |         |
                         V     |         V
           +---------------+   |        +----------+
           | BLEFM         |   |        | BLEBK  ------> control
           | BLEBK table ------+        |----------|     block @
           |---------------|            | BLEBK  ----+
           | BLEFM         |            |----------| |
           | BLEBK table ------+        |  .       | +-> control
           +---------------+   |        |  .       |     block @
                               |        |  .       |
                               |        +----------+
                               +---------+
                                         V
                                        +----------+
                                        | BLEBK  ------> control
                                        |----------|     block @
                                        | BLEBK  ----+
                                        |----------| |
                                        |  .       | +-> control
                                        |  .       |     block @
                                        |  .       |
                                        +----------+

#### BLEBK Control Block Content

#### BLEBK DSECT

####

####

####

####

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      BLEBK          CP application interface table
                                            ctl block
          BLEBK Table entry
    0000    0 Signed       4 BLETOK         Token value
    0004    4 Address      4 BLEPTR         Target block address
              00000001       BLESIZE        (*-BLEBK+7)/8 Size, in
                                            doublewords, of BLEBK
              00000008       BLEHNDTL       8 Number of bits in a handle used
                                            to hold the instance
          BLEHD table header

    BLEHD DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      BLEHD          CP application interface table
                                            ctl block
          Interface table lock controls.
    0000    0 Dbl-Word     8 BLELKWRD (3)   Table lock
    0018   24 Bitstring    8 BLELKTRC       Table lock trace values
          Table pointers
    0020   32 Address      4 BLETPTR        Table address
    0024   36 Address      4 BLETEND        Points past the end of the table
    0028   40 Signed       4 BLEHI          Highest valid token
          Binary tree controls
    002C   44 Address      4 BLETREE        BLEBK tree root
    0030   48 Signed       2 BLECMP (3)     Compare instruction used to
                                            locate a control block in binary
                                            tree
    0036   54 Signed       2 BLEDTOFF       Child pointer offset
    0038   56 Signed       2 BLETKOFF       Token offset (for REGBK type)
          Control block type.
    003A   58 Signed       2 BLETYPE        Type of control block in table
              00000008       BLEHSIZE       (*-BLEHD+7)/8 Size, in
                                            doublewords, of BLEHD
          BLEFM frame descriptor format

    BLEFM DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      BLEFM          CP application interface table
                                            ctl block
          BLEFM Table entry
    0000    0 Address      4 BLEEPTR        Table start address
    0004    4 Address      4 BLEFRE         Table free chain
    0008    8 Address      4 BLEUNA         First unassigned table address
    000C   12 Address      4 BLETOP         One byte past top of table
              00000002       BLEFSIZE       (*-BLEFM+7)/8 Size, in
                                            doublewords, of BLEFM
              0000000C       BLEFRMEL       12 Number of bits in a handle
                                            used to find the BLEFM

    BLEBK Storage Layout

    *** BLEBK - CP application interface table ctl block
    *
    *     +---------------------------+---------------------------+
    *   0 |          BLETOK           |          BLEPTR           |
    *     +---------------------------+---------------------------+
    *   8
    *
    *** BLEBK - CP application interface table ctl block

    *** BLEHD - CP application interface table ctl block
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       BLELKWRD                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  18 |                       BLELKTRC                        |
    *     +---------------------------+---------------------------+
    *  20 |         BLETPTR           |         BLETEND           |
    *     +---------------------------+---------------------------+
    *  28 |          BLEHI            |         BLETREE           |
    *     +---------------------------+-------------+-------------+
    *  30 |                 BLECMP                  |  BLEDTOFF   |
    *     +-------------+-------------+-------------+-------------+
    *  38 |  BLETKOFF   |  BLETYPE    | 3C
    *     +-------------+-------------+
    *
    *** BLEHD - CP application interface table ctl block

    *** BLEFM - CP application interface table ctl block
    *
    *     +---------------------------+---------------------------+
    *   0 |         BLEEPTR           |          BLEFRE           |
    *     +---------------------------+---------------------------+
    *   8 |          BLEUNA           |          BLETOP           |
    *     +---------------------------+---------------------------+
    *  10
    *
    *** BLEFM - CP application interface table ctl block

    BLEBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    BLECMP         0030
    BLEDTOFF       0036
    BLEEPTR        0000
    BLEFRE         0004
    BLEFRMEL       000C 0000000C
    BLEFSIZE       000C 00000002
    BLEHI          0028
    BLEHNDTL       0004 00000008
    BLEHSIZE       003A 00000008
    BLELKTRC       0018
    BLELKWRD       0000
    BLEPTR         0004
    BLESIZE        0004 00000001
    BLETEND        0024
    BLETKOFF       0038
    BLETOK         0000
    BLETOP         000C
    BLETPTR        0020
    BLETREE        002C
    BLETYPE        003A
    BLEUNA         0008

    This information is
    based on z/VM V5R2.0.
    Last updated on 12 Apr 2006 at 16:42:48 EDT.

    Copyright IBM Corporation, 1990, 2005