Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### MSMPR

Prolog

Control Block Contents
MSMPR DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### MSMPR Prolog

     NAME       : HCPMSMPR
     DESCRIPTION: HCPMSM ParameteR passing block.
     DSECT      : MSMPR
     FUNCTION   : The MSMPR is used for parameter passing for
                  HCPMSM.
     LOCATED BY : Caller's R1 passed to an entry point.
     CREATED BY : HCPAMD44 - Function code 01 processing
     DELETED BY : HCPAMD44 - Function code 01 processing
     SERIALIZED : None.
     COMMENTS   : None.

#### MSMPR Control Block Content

#### MSMPR DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      MSMPR          HCPMSM ParameteR passing block.
    0000    0 Signed       4 MSMCOUNT       Count of minidisk page or extents
                                            to process.
    0000    0 Signed       4 MSMEXTCT       Count of minidisk extents to
                                            process.
    0000    0 Signed       4 MSMPAGCT       Count of minidisk pages to
                                            process.
    0004    4 Address      4 MSMPRBN        Starting PRBN for a consecutive
                                            operation.
    0004    4 Address      4 MSMPRBNA       Address of the location of the
                                            PRBNS.
    0008    8 Address      3 MSMSPAGE       Address of guest absolute storage
                                            or minidisk extents. Bit 0
                                            ignored. Bits 1-19 are used as an
                                            address. Bit 20-23 ignored
    000B   11 Bitstring    1 MSMPARMS       Bits 24-31 are used as parameters
              .... ....      MSMFETCH       0 MSMFETCH Indicates that the
                                            current contents of the pages are
                                            discarded and the contents of the
                                            associated minidisk blocks are
                                            made available in the mapped
                                            pages. Notes : MSMFETCH is the
                                            absence of both MSMRETAN and
                                            MSMZERO. Do not use this mask to
                                            test for FETCH.
              .... ...1      MSMRETAN       B'00000001' MSMRETAN Indicates
                                            the current contents of the pages
                                            are retained.
              .... ..1.      MSMZERO        B'00000010' MSMZERO Indicates the
                                            current contents of the page are
                                            discarded and the mapped pages
                                            are considered to contain binary
                                            zeroes.
              1... ....      MSMCONSC       B'10000000' MSMCONSC Indicates
                                            conscecutive PRBN processing.
          The following flag is used as a parameter in both the
          field MSMPARMS and in an input register to HCPMSMRS.  If
          set, it indicates that all pages for this user must be
          unmapped.  When used in MSMPARMS, it means that HCPMSMRM is
          to remove the mapping for all pages in this address space,
          skipping those that are already unmapped.  When used as in
          input register to HCPMSMRS, it indicates that HCPMSMRM
          must be called to unmap all pages for this user.  If off,
          then this user's virtual storage has already been cleared,
          so there are no pages to unmap.
              00000040       MSMUNMAP       B'01000000' Remove mapping for
                                            every mapped page in this address
                                            space.
    000C   12 Address      4 MSMASCBK       Address of the ASCBK.
              00000010       MSMLEN         *-MSMPR Get the size in bytes.
              00000002       MSMSIZE        (MSMLEN+7)/8 Get size in
                                            doublewords.
                 This macro invocation is used to indicate when
          this control block becomes larger than 16 bytes.  The
          module HCPAMD maps this control block to it's savework
          area.

#### MSMPR Storage Layout

    *** MSMPR - HCPMSM ParameteR passing block.
    *
    *     +---------------------------+
    *   0 |         MSMCOUNT          | 4
    *     +---------------------------+
    *
    *** MSMPR - HCPMSM ParameteR passing block.

    *** Overlay for MSMCOUNT in MSMPR
    *
    *     +---------------------------+
    *   0 |         MSMEXTCT          | 4
    *     +---------------------------+
    *
    *** Overlay for MSMCOUNT in MSMPR

    *** Overlay for MSMCOUNT in MSMPR
    *
    *     +---------------------------+---------------------------+
    *   0 |         MSMPAGCT          |         MSMPRBN           |
    *     +---------------------------+---------------------------+
    *   8
    *
    *** Overlay for MSMCOUNT in MSMPR

    *** Overlay for MSMPRBN in MSMPR
    *
    *                                 +---------------------------+
    *   0 ...                       4 |         MSMPRBNA          |
    *     +--------------------+------+---------------------------+
    *   8 |     MSMSPAGE       |:PARMS|         MSMASCBK          |
    *     +--------------------+------+---------------------------+
    *  10
    *
    *** Overlay for MSMPRBN in MSMPR

#### MSMPR Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    MSMASCBK       000C
    MSMCONSC       000B 80
    MSMCOUNT       0000
    MSMEXTCT       0000
    MSMFETCH       000B 00
    MSMLEN         000C 00000010
    MSMPAGCT       0000
    MSMPARMS       000B
    MSMPRBN        0004
    MSMPRBNA       0004
    MSMRETAN       000B 01
    MSMSIZE        000C 00000002
    MSMSPAGE       0008
    MSMUNMAP       000B 00000040
    MSMZERO        000B 02

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:51:19 EDT.
Copyright IBM Corporation, 1990, 2008