Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
VAABK
Control Block Contents
VAABK DSECT
Cross Reference (Contains links to field and bit definitions)
VAABK Prolog
NAME : HCPVAABK DESCRIPTION: ARCHITECTURE ANCHOR BLOCK DSECT : VAABK Virtual Architecture Block FUNCTION : Used to anchor the RDMBK and ARDBK structures reference by a member of the SSI. The VAABK contains a pointer to a table of ARDBKs that represent the maximal architectural characteristics for all members of the SSI. These ARDs are read from the PDR or updated when a dynamic architecture update occurs. The VAABK also contains the member's unique SSI index number and its name. Embedded in the VAABK is a cross-system lock block (XLKBK), which is used to serialize relocation domain operations across the SSI. The VAASEQ sequence number is used to synchronize joining/ re-joining members of the SSI cluster. Every joined member, once synchronized, will have the same value of VAASEQ. LOCATED BY : HCPARDVA -- The VAABK block is hardcoded into HCPARD at this externalized label. Use an EXTRN and an adcon to get its address. For example: L R1,=A(HCPARDVA) SERIALIZED : VAAXLK which is a cross-system global lock that is maintained by HCPXLK. CREATED BY : HCPARDIN when the member IPLs DELETED BY : Never RELOCATION CONSIDERATIONS : This structure is not relocated. It is instantiated per member of the SSI.
VAABK Control Block Content
VAABK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure VAABK ARCHITECTURE ANCHOR BLOCK 0000 0 Character 8 VAANAME Member Name 0008 8 Bitstring 2 * Reserved for alignment 000A 10 Signed 2 VAAINDX SSI Member Index 000C 12 Bitstring 4 VAASCKID Relocation domain synchronization socket ID Note that the next three fields are all pointers to relocation domain blocks (RDMBKs). The second and third pointers are anchors for chains of RDMBKs. VAASSIP points to one RDMBK. 0010 16 Address 4 VAASSIP Pointer to SSI RDMBK 0014 20 Address 4 VAASRDP Pointer to chain of singleton RDMBKs. The forward pointer for this chain is the RDMSRDP field. 0018 24 Address 4 VAARDMP Pointer to chain of all RDMBKs. The forward pointer for this chain is the RDMNEXT field. 001C 28 Signed 4 VAASEQ VAA global operations sequence number. Updated for domain definition changes. 0020 32 Signed 4 VAASEQN VAASEQ will be updated from this value when the global operation completes. During a global op, VAASEQ and VAASEQN are compared; if equal then VAASEQN is updated and HCPXLKUU called (opcode 4 = Work request received). 0024 36 Signed 4 VAASCPQ Pending queue of RDMBKs defined by RELOCATION_DOMAIN statements in SYSTEM CONFIG. These are integrated or discarded during join processing. RDMNEXT is used as the forward chaining field for this queue. This is the same field used for the VAARDMP queue so an RDMBK can't be on both queues at the same time. 0028 40 Bitstring 4 VAAGDATA Field reserved for global operations. Available to any holder of the VAAXLK. Currently for communication between HCPRDMRU and HCPRDMFA. 002C 44 Bitstring 4 VAAGDAT2 Field reserved for global operations. Available to any holder of the VAAXLK. Currently for communication between HCPRDMRU and HCPRDMFA. 0030 48 Dbl-Word 8 VAAXLK (28) Space for embedded XLKBK 0110 272 Signed 4 VAAFRTOK Token for virt arch trace tables 0114 276 Signed 4 * Reserved for future IBM use 00000023 VAADWSZ (*-VAABK+7)/8 Double-word size of the VAABK
VAABK Storage Layout
*** VAABK - ARCHITECTURE ANCHOR BLOCK * * +-------------------------------------------------------+ * 0 | VAANAME | * +-------------+-------------+---------------------------+ * 8 |/////////////| VAAINDX | VAASCKID | * +-------------+-------------+---------------------------+ * 10 | VAASSIP | VAASRDP | * +---------------------------+---------------------------+ * 18 | VAARDMP | VAASEQ | * +---------------------------+---------------------------+ * 20 | VAASEQN | VAASCPQ | * +---------------------------+---------------------------+ * 28 | VAAGDATA | VAAGDAT2 | * +---------------------------+---------------------------+ * 30 | | * = VAAXLK = * | | * +---------------------------+---------------------------+ * 110 | VAAFRTOK |///////////////////////////| * +---------------------------+---------------------------+ * 118 * *** VAABK - ARCHITECTURE ANCHOR BLOCK
VAABK Cross Reference
Symbol Dspl Value -------------- ---- ----- VAADWSZ 0114 00000023 VAAFRTOK 0110 VAAGDATA 0028 VAAGDAT2 002C VAAINDX 000A VAANAME 0000 VAARDMP 0018 VAASCKID 000C VAASCPQ 0024 VAASEQ 001C VAASEQN 0020 VAASRDP 0014 VAASSIP 0010 VAAXLK 0030
Copyright IBM Corporation, 1990, 2011