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.3.0 Last updated on 22 Jun 2022 at 15:47:04 EDT.
Copyright IBM Corporation, 1990, 2022