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.2.0 Last updated on 24 Jun 2020 at 09:29:18 EDT.
Copyright IBM Corporation, 1990, 2020