|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
BLEBK
Control Block Contents
BLEBK DSECT
BLEHD DSECT
BLEFM DSECT
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.
RELOCATION CONSIDERATIONS : None
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
Copyright IBM Corporation, 1990, 2011