|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
HALBK
Cross Reference (Contains links to field and bit definitions)
HALBK Prolog
NAME : HCPHALBK
DESCRIPTION: Host-ART lookaside block
DSECT : HALBK
FUNCTION : The HALBK maps ALETs to I-ASITs for
host-access-register translation.
SERIALIZED : Each task is responsible for its own
serialization
COMMENTS : This block is meant to be used with the
HCPHALM macro. The user must:
- acquire HALBK storage
- have an active HCPUSING on the block
- fill in the header.
Then HCPHALM may be used to search and
manipulate entries in this block.
The count of the number of entries in the HALBK
must fit in a fullword; that's the only
restriction on HALBK size. If, however, the
total size of the HALBK (header + (entry length
* number of entries)) could be greater than
509 doublewords, the PAGES=DECIDE option should
be used on the HCPGETST and HCPRELST macros.
HALBK Control Block Content
HALBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure HALBK Host-ART lookaside block 0000 0 Character 16 HALHDR HALBK header 0010 16 Character 16 HALENTRY HALBK entry (there can be more than one of these). Mapping of the HALBK header 0000 0 Signed 4 HALMXENT Maximum number of HALBK .entries 0004 4 Address 4 HALVMDBK Address of the base VMDBK .associated with the access .list to which the ALETs .belong. 0008 8 Character 8 * Reserved for IBM use. Mapping of HALBK entries 0010 16 Bitstring 1 HALSTATE State flag for the entry 00000000 HALINVAL X'00' The entry is invalid (does .not contain an ALET/i-ASIT .pair). 00000001 HALVALID X'01' The entry is valid (does .contain an ALET/i-ASIT .pair). 0011 17 Bitstring 3 * Reserved for IBM use 0014 20 Signed 4 HALALET ALET 0018 24 Character 8 HALIASIT I-ASIT associated with .HALALET 0020 32 Signed 4 HALNEXT (0) Next entry in the list Length equate 00000004 HALSIZE (*-HALBK+7)/8 Length of HALBK in DWs
HALBK Storage Layout
*** HALBK - Host-ART lookaside block * * +-------------------------------------------------------+ * 0 | HALHDR | * | | * +-------------------------------------------------------+ * 10 | HALENTRY | * | | * +-------------------------------------------------------+ * 20 * *** HALBK - Host-ART lookaside block *** Overlay for HALHDR in HALBK * * +---------------------------+---------------------------+ * 0 | HALMXENT | HALVMDBK | * +---------------------------+---------------------------+ * 8 |///////////////////////////////////////////////////////| * +-------------------------------------------------------+ * 10 * *** Overlay for HALHDR in HALBK *** Overlay for HALENTRY in HALBK * * +------+--------------------+---------------------------+ * 10 |:STATE|////////////////////| HALALET | * +------+--------------------+---------------------------+ * 18 | HALIASIT | * +-------------------------------------------------------+ * 20 | | * = HALNEXT = * | | * +-------------------------------------------------------+ * *** Overlay for HALENTRY in HALBK
HALBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----HALALET 0014
HALENTRY 0010
HALHDR 0000
HALIASIT 0018
HALINVAL 0010 00000000
HALMXENT 0000
HALNEXT 0020
HALSIZE 0020 00000004
HALSTATE 0010
HALVALID 0010 00000001
HALVMDBK 0004
Last updated on 3 Aug 1999 at 12:04:16 EDT.
Copyright IBM Corporation, 1990, 1999