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