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 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 - Memory Pass Information Block
*
*     +---------------------------+---------------------------+
*   0 |         MPINEXT           |         MPIPNUM           |
*     +---------------------------+---------------------------+
*   8 |                       MPISTART                        |
*     +-------------------------------------------------------+
*  10 |                       MPIL8EST                        |
*     +-------------------------------------------------------+
*  18 |                        MPIEND                         |
*     +-------------------------------------------------------+
*  20 |                       MPIPAGES                        |
*     +------+--------------------+---------------------------+
*  28 |:PFLAG|////////////////////|          MPIRC            |
*     +------+--------------------+---------------------------+
*
*** MPIBK - Memory Pass Information Block

 
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