Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
MSMPR
Control Block Contents
MSMPR DSECT
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
Copyright IBM Corporation, 1990, 2011