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 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' Indicates the current
                                            contents of the pages are
                                            retained.
              .... ..1.      MSMZERO        B'00000010' Indicates the current
                                            contents of the page are
                                            discarded and the mapped pages
                                            are considered to contain binary
                                            zeroes.
              1... ....      MSMCONSC       B'10000000' 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 V4R3.0. Last updated on 1 May 2002 at 09:21:17 EDT.
Copyright IBM Corporation, 1990, 2002