ADABK | Back to Index page

| Prolog Control Block Contents ADABK 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.

ADABK Prolog | Top of page

     NAME       : HCPADABK
     DESCRIPTION: Address Space Data Array
     DSECT      : ADABK
     FUNCTION   :
                  Defines a fixed-length array containing data about
                  address spaces during a live guest relocation
     LOCATED BY :
                  Source system -
                  Transient area, accessed only within HCPRLLSE
                  Destination system -
                  The RLOADRSP field of the RLOBK
     CREATED BY :
                  Source system -
                  HCPRLLSE during source system eligibility
                  checking.
                  Destination system -
                  HCPRLLDE during initial destination eligibility
                  checking.
     DELETED BY :
                  Source system -
                  HCPRLLSE after completing source eligibility
                  checking.
                  Destination system -
                  HCPRLNCT during destination system STMGT cleanup.
     REFERENCES :
                  None.
     SERIALIZED :
                  An ADABK is created on the source system once during
                  each relocation, and once created is never updated.
                  It is destroyed by HCPRLLSE (Source system storage
                  eligibility checking) at the close of the initial set
                  of eligibility checks.
                  The ADABK is sent to the destination system where it
                  is used by one task at a time, either HCPRLLDE
                  (Destination system storage eligibility checking)
                  or by HCPRLLCS (Create guest address spaces), neither
                  of which update the block.  On the destination, the
                  ADABK is released only by HCPRLNCT (Cleanup routine
                  for LGR Memory Move - Target System).
                  Any relocation-supported changes to the storage
                  configuration will be communicated to the destination
                  system as part of the memory move (for example, a
                  change in the standby storage amount).  Any
                  unsupported storage configuration changes (such as
                  using the DEFINE STORAGE command to change the amount
                  of configured storage) will fail a relocation in
                  progress.
     RELOCATION CONSIDERATIONS : This block is sent from the source to the
                  destination system.
     NOTES      :
                  None.

ADABK Control Block Content | Top of page

     ADABK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      ADABK          Address Space Data Array
                 The following is header information for the array.
    0000    0 Character    8 ADABKNAM       (+00) Indicate start of ADABK.
                                            This is an eyecatcher,
                                            'ADABK=>', and is used to ID
                                            this block. On the destination,
                                            ISFC allocates this block as free
                                            storage, and as such it will lack
                                            a trailer.
    0008    8 Signed       2 ADACOUNT       (+08) Cnt of user-owned address
                                            spaces
    000A   10 Bitstring    2 *              (+0A) Reserved for IBM use
    000C   12 Signed       4 ADATSIZE       (+0C) Total size of non-base
                                            spaces
          EQUates for the ADABK header
              00000010       ADAHDEND       * Mark the end of the header
              00000010       ADAHDSIZ       *-ADABK Size of the ADABK header
              00000002       ADAHDSZD       (ADAHDSIZ+7)/8 Size of the ADA
                                            header in DWORDs
                 Start of the variable data section of the array.

ADABK Storage Layout | Top of page

    *** ADABK - Address Space Data Array
    *
    *     +-------------------------------------------------------+
    *   0 |                       ADABKNAM                        |
    *     +-------------+-------------+---------------------------+
    *   8 |  ADACOUNT   |/////////////|         ADATSIZE          |
    *     +-------------+-------------+---------------------------+
    *  10
    *
    *** ADABK - Address Space Data Array

ADABK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    ADABKNAM       0000
    ADACOUNT       0008
    ADAHDEND       000C 00000010
    ADAHDSIZ       000C 00000010
    ADAHDSZD       000C 00000002
    ADATSIZE       000C

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:26:48 EDT.
Copyright IBM Corporation, 1990, 2020