ADABK

Prolog  

Control Block Contents  
   ADABK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  

ADABK Prolog

 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

ADABK DSECT

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

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

ADABK Cross Reference

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