VAABK | Back to Index page

| Prolog Control Block Contents VAABK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

VAABK Prolog | Top of page

     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 | Top of page

     VAABK DSECT
    Top of page

    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 (32)    Space for embedded XLKBK
    0130  304 Signed       4 VAAFRTOK       Token for virt arch trace tables
    0134  308 Signed       4 *              Reserved for future IBM use
              00000027       VAADWSZ        (*-VAABK+7)/8 Double-word size of
                                            the VAABK

VAABK Storage Layout | Top of page

    *** VAABK - ARCHITECTURE ANCHOR BLOCK
    *
    *     +-------------------------------------------------------+
    *   0 |                       VAANAME                         |
    *     +-------------+-------------+---------------------------+
    *   8 |/////////////|  VAAINDX    |         VAASCKID          |
    *     +-------------+-------------+---------------------------+
    *  10 |         VAASSIP           |         VAASRDP           |
    *     +---------------------------+---------------------------+
    *  18 |         VAARDMP           |          VAASEQ           |
    *     +---------------------------+---------------------------+
    *  20 |         VAASEQN           |         VAASCPQ           |
    *     +---------------------------+---------------------------+
    *  28 |         VAAGDATA          |         VAAGDAT2          |
    *     +---------------------------+---------------------------+
    *  30 |                                                       |
    *     =                        VAAXLK                         =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    * 130 |         VAAFRTOK          |///////////////////////////|
    *     +---------------------------+---------------------------+
    * 138
    *
    *** VAABK - ARCHITECTURE ANCHOR BLOCK

VAABK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    VAADWSZ        0134 00000027
    VAAFRTOK       0130
    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 7.2.0 Last updated on 24 Jun 2020 at 09:31:32 EDT.
Copyright IBM Corporation, 1990, 2020