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.
 RELOCATION CONSIDERATIONS : 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 V6R2.0. Last updated on 21 Nov 2011 at 11:11:03 EDT.
Copyright IBM Corporation, 1990, 2011