Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
HSABK
Control Block Contents
HSABK DSECT
Cross Reference (Contains links to field and bit definitions)
HSABK Prolog
NAME : HCPHSABK DESCRIPTION: Hardware System Storage Control Block DSECT : HSABK FUNCTION : An internal CP control block used to map discontigious free storage used to simulate the Hardware System Area Storage (HSA) within CP. CREATED BY : Dynamically created by HCPGETST when a cache or list vector is defined via the simulation of a DEFINE VECTOR (DV B268 OPCODE) Instruction. DELETED BY : Deleted by HCPRELST during the simulation of a "Release Vector Function" of a DEFINE VECTOR (DV B268) Instruction or a virtual system reset.
HSABK Control Block Content
HSABK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure HSABK Hardware System Storage Control Block 0000 0 Dbl-Word 8 HSALOCK (3) Vector Bit Lock 0018 24 Address 4 HSAVMDBK VMDBK of the vector owner 001C 28 Signed 4 HSABITS Number of HSA bits mapped by this this block 0020 32 Signed 4 HSATOKEN Word 2 of the token assigned to this vector 0024 36 Signed 4 HSANUMPG Number of page frames allocated and pointed to via the page array anchored off HSAVECA 0028 40 Bitstring 1 HSAFLAG HSABK Processing Flag 1... .... HSAIDAL X'80' HSAVECA points to an array of pages (indirect list of page frames) .1.. .... HSALSUMM X'40' Local Summary Bit for a list notification vector ..1. .... HSALIMIT X'20' CP limited the vector size 0029 41 Bitstring 1 HSATYPE Type of Token 00000000 HSAUNKN X'00' Unknown token type 00000001 HSALCT X'01' Local Cache Token (LCT) 00000002 HSALNT X'02' List Notification Token (LNT) 002A 42 Bitstring 1 * (2) Reserved for future IBM use 002C 44 Address 4 HSAVECA Address of a single vector or an array of vector addresses. HSAFLAG.HSAIDAL determines what this field contains 0030 48 Dbl-Word 8 * Reserved for future IBM use 0038 56 Bitstring 1 HSA$END (0) The end Notes : The following assembler equates are defined and can be used but do not appear in the control block expansion because they are in the PLX section and PRINT OFF, NOGEN are in effect. 00000010 HSAPAGES 16 Maximum number of pages CP will allow to allocated for a single vector 00008000 HSABP 32768 Maximum number of bits per page 0000000F HSAPGSHF 15 Number of bits to shift right to determine the page number of a vector bit 00007F00 HSASMALL (HSABP-256) Maximum number of bits in a small vector 00080000 HSAMBITS (HSAPAGES*HSABP) Maximum number of bits that can be mapped by this control block
HSABK Storage Layout
*** HSABK - Hardware System Storage Control Block * * +-------------------------------------------------------+ * 0 | | * = HSALOCK = * | | * +---------------------------+---------------------------+ * 18 | HSAVMDBK | HSABITS | * +---------------------------+---------------------------+ * 20 | HSATOKEN | HSANUMPG | * +------+------+-------------+---------------------------+ * 28 |:FLAG |:TYPE |/////////////| HSAVECA | * +------+------+-------------+---------------------------+ * 30 |///////////////////////////////////////////////////////| * +-------------------------------------------------------+ * *** HSABK - Hardware System Storage Control Block
HSABK Cross Reference
Symbol Dspl Value -------------- ---- ----- HSA$END 0038 HSABITS 001C HSABP 0038 00008000 HSAFLAG 0028 HSAIDAL 0028 80 HSALCT 0029 00000001 HSALIMIT 0028 20 HSALNT 0029 00000002 HSALOCK 0000 HSALSUMM 0028 40 HSAMBITS 0038 00080000 HSANUMPG 0024 HSAPAGES 0038 00000010 HSAPGSHF 0038 0000000F HSASMALL 0038 00007F00 HSATOKEN 0020 HSATYPE 0029 HSAUNKN 0029 00000000 HSAVECA 002C HSAVMDBK 0018
Copyright IBM Corporation, 1990, 2001