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 V4R1.0.
Last updated on 6 Jun 2001 at 11:12:14 EDT.
Copyright IBM Corporation, 1990, 2001