MPIBK Back to Index page
 
Prolog 
Control Block Contents 
   MPIBK 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.


  MPIBK Prolog Top of page
 
 NAME       : HCPMPIBK
 DESCRIPTION: Memory Pass Information Block
 DSECT      : MPIBK
 FUNCTION   : Contains information about one pass of a
              relocating guest's address space(s).
 LOCATED BY : RLOMPIBK in RLOBK
              MPINEXT in MPIBK
 CREATED BY : HCPRLSCM - VMRELOCATE Memory Move
              HCPRLBRC - Memory Move Receive Routine (Destination)
 DELETED BY : HCPRLN   - VMRELOCATE cancel/cleanup
              HCPRLHRR - Remove RLOBK from system RLOBK list
 SERIALIZED : Local task serialization
 RELOCATION CONSIDERATIONS : None
 COMMENTS   : Keeps information and statistics about a pass
              during relocation.  Data can be used for actual
              run-time purposes or can be good for debugging.
              The MPIBK chain is a stack (newest block at the top).
              By default, the MPIBK stack is preserved along with
              the RLOBK only for failed relocations.  This
              behavior may be changed through the externally-
              accessible fullword field at HCPRLNT1 (see the field
              definition in HCPRLN for details).
 
 
  MPIBK Control Block Content Top of page
 

 MPIBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure MPIBK Memory Pass Information Block 0000 0 Signed 4 MPINEXT Source: pointer to next MPIBK in chain (zero indicates end of chain) Destination: same as source 0004 4 Signed 4 MPIPNUM Source: pass number Destination: same as source 0008 8 Dbl-Word 8 MPISTART Source: timestamp taken at start of pass Destination: same as source 0010 16 Dbl-Word 8 MPIL8EST Source: Not valid Destination: Time that we rec'vd the latest memory move message for this pass. 0018 24 Dbl-Word 8 MPIEND Source: timestamp taken at end of pass Destination: timestamp taken when either (a) the first message was received for the next pass, or (b) when the "memory move complete" message was received after the last pass 0020 32 Dbl-Word 8 MPIPAGES Source: number of pages with content sent this pass Destination: number of pages with content received this pass (updated after each VPABK proc'd) 0028 40 Bitstring 1 MPIPFLAG Source: pass flag (from RLOSTATS) Destination: same as source 00000001 RLOCONNEC X'01' RLOCONNEC Connecting to destination system. 00000002 RLOELGCHK X'02' RLOELGCHK Doing eligibility checks 00000003 RLOCREATE X'03' RLOCREATE Creating skeleton guest on destination system 00000004 RLOMEMCPY X'04' RLOMEMCPY Copying guest's memory to destination system 00000005 RLOQUISRC X'05' RLOQUISRC Quiescing source guest 00000006 RLOMVSTAT X'06' RLOMVSTAT Moving guest's state to destination system. During this state we also relocate I/O configuration, perform a memory transfer pass, and do VSIM related eligibility checking in parallel. 00000007 RLOLASTMC X'07' RLOLASTMC Last pass memory copy 00000008 RLOLASTIO X'08' RLOLASTIO Last pass I/O checks 00000009 RLOSTARTD X'09' RLOSTARTD Start guest on destination system. 0000000A RLOCLEAN X'0A' RLOCLEAN Clean up - logging guest off source system and closing the connection to the destination system 0000000B RLOSCANCL X'0B' RLOSCANCL MOVE in process of being canceled 0029 41 Bitstring 1 * (3) Reserved for IBM use 002C 44 Signed 4 MPIRC Source: HCPRLSCM's expected RC so far as seen at the end of the pass (anything non-zero should make this the last pass). Destination: not valid End of MPIBK 0030 48 Signed 4 MPI$END (0) End of MPIBK control block 00000030 MPILEN *-MPIBK Length of MPIBK in bytes 00000006 MPISIZE (MPILEN+7)/8 Size of MPIBK in doublewords
 
 
  MPIBK Storage Layout Top of page
 
          
*** MPIBK - Memory Pass Information Block
*
*     +---------------------------+---------------------------+
*   0 |         MPINEXT           |         MPIPNUM           |
*     +---------------------------+---------------------------+
*   8 |                       MPISTART                        |
*     +-------------------------------------------------------+
*  10 |                       MPIL8EST                        |
*     +-------------------------------------------------------+
*  18 |                        MPIEND                         |
*     +-------------------------------------------------------+
*  20 |                       MPIPAGES                        |
*     +------+--------------------+---------------------------+
*  28 |:PFLAG|////////////////////|          MPIRC            |
*     +------+--------------------+---------------------------+
*
*** MPIBK - Memory Pass Information Block
 
 
  MPIBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
MPI$END        0030
MPIEND         0018
MPILEN         0030 00000030
MPIL8EST       0010
MPINEXT        0000
MPIPAGES       0020
MPIPFLAG       0028
MPIPNUM        0004
MPIRC          002C
MPISIZE        0030 00000006
MPISTART       0008
RLOCLEAN       0028 0000000A
RLOCONNEC      0028 00000001
RLOCREATE      0028 00000003
RLOELGCHK      0028 00000002
RLOLASTIO      0028 00000008
RLOLASTMC      0028 00000007
RLOMEMCPY      0028 00000004
RLOMVSTAT      0028 00000006
RLOQUISRC      0028 00000005
RLOSCANCL      0028 0000000B
RLOSTARTD      0028 00000009
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:52:50 EDT.
Copyright IBM Corporation, 1990, 2022