Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

VAABK

Prolog  

Control Block Contents  
   VAABK DSECT

Storage Layout  

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

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:29:17 EDT.
Copyright IBM Corporation, 1990, 2011