MPLBK Back to Index page
 
Prolog 
Control Block Contents 
   MPLBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  MPLBK Prolog Top of page
 
 NAME       : HCPMPLBK
 DESCRIPTION: Map Parameter List BlocK.
 DSECT      : MPLBK
 FUNCTION   : The MPLBK is used to pass parameters for
              diagnose X'244'.
              Function codes for this diagnose:
              - 00 - Identify-pool
              - 01 - Define mapping
              - 02 - Remove mapping
              - 03 - Save-list
 LOCATED BY : Guest Rx register.
 CREATED BY : Created in the guest virtual machine's storage and
              copied to VMDVOBUF for CP to use.
 DELETED BY : Deleted by the guest virtual machine.
 SERIALIZED : Guest Virtual Machine is responsible.
 RELOCATION CONSIDERATIONS : None
 COMMENTS   : NONE
 
 
  MPLBK Control Block Content Top of page
 

 MPLBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure MPLBK Map Parameter List BlocK. 0000 0 Signed 2 MPLDIAGC Diagnose number. MPLDIAGC MPLDC244 X'0244' MPLDC244 Diagnose code 244. 0002 2 Signed 2 MPLFCODE Diagnose function code. .... .... MPLIPOOL X'0000' MPLIPOOL Identify Pool function code. .... ...1 MPLDFMAP X'0001' MPLDFMAP Define mapping function code. .... ..1. MPLRMMAP X'0002' MPLRMMAP Remove mapping function code. .... ..11 MPLSAVPG X'0003' MPLSAVPG Save-list function code. The following equate should always be the same as the highest diagnose 244 function code. .... ..11 MPLMAXFC X'0003' Highest or maximum function code allowed for this diagnose. 0004 4 Signed 2 MPLDWLEN Y(MPLSIZE) Size of block in doublewords. 0006 6 Signed 2 MPLVERSN Version field. .... ...1 MPLVERCD 1 MPLVERCD The version number of this MPLBK. 0008 8 Dbl-Word 8 MPLASIT For function code 00 and 03 identify pool and save-list functions this field contains zeroes. For function code 01 and 02 define and remove mapping this field contains an Address Space Identification Token associated with the mapping function being processed. 0010 16 Signed 4 * Reserved for IBM use. 0014 20 Address 4 MPLSPAGE For function codes 00 and 03 identify-pool and save-list this field contains zeroes. For function code 01 and 02 define and remove mapping, this field contains a starting absolute address in the address space to be associated with a pool-relative-block number. 0018 24 Signed 4 MPLEXTCT For function code 00 identify pool this field contains the number of minidisk extents to be processed. 00000018 MPLPAGCT MPLEXTCT For function code 01 and 02 define and remove mapping this field contains the number of consecutive address pages to be processed. 00000018 MPLENTCT MPLEXTCT For function code 03 this field contains the total count of entries in the SLDBK. 001C 28 Bitstring 1 MPLTYPFG Type flag. 1... .... MPLCONSC X'80' Indicates that the PRBN mapping is to be consecutive. If this bit is zero the mapping is based on mapping-list definition block (MLDBK) 1... .... MPLBLOCK X'80' For function code 3 this bit is on for the block form of the SLDBK which is in page ranges. If this bit is zero the SLDBK is in the list form which is list of individual pages. 001D 29 Bitstring 1 MPLPAGVW This field contains the page view codes. 00000000 MPLFETCH 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. .... ...1 MPLRETAN X'01' Indicates the current contents of the pages are retained. .... ..1. MPLZERO X'02' Indicates the current contents of the page are discarded and the mapped pages are considered to contain binary zeroes. .... ..1. MPLPAGMX X'02' Maximum pageview code value. 001E 30 Bitstring 1 MPLRSVD0 (2) Reserved for IBM use. 0020 32 Signed 4 MPLXLDAL ALET specifying address space containing XLDBK for function code 00. 00000020 MPLMLDAL MPLXLDAL ALET specifying address space containing XLDBK for function code 01. 00000020 MPLSLDAL MPLXLDAL ALET specifying address space containing SLDBK for function code 03. 0024 36 Signed 4 MPLXLDBA (0) For function code 00 identify- pool, this field contains the guest real address of the XLDBK block. 00000024 MPLMLDBA MPLXLDBA For function code 01 define mapping, this field contains a guest real address of the MLDBK if bit MPLCONSC is zero. The address is on a doubleword boundary. 00000024 MPLSPRBN MPLXLDBA For function code 01 define mapping this field contains a starting pool-relative-block number (PRBN) if bit MPLCONSC is one. Each subsequent page in the range of pages to be mapped is associated with the next larger PRBN. 00000024 MPLSLDBA MPLXLDBA For function code 03 save-list, this field contains a guest real address of the first save-list definition block (SODBK). 0024 36 Bitstring 1 * (3) 0027 39 Bitstring 1 MPLXLDB3 Used to test for doubleword alignment. 00000027 MPLMLDB3 MPLXLDB3 Ditto . 00000027 MPLSLDB3 MPLXLDB3 .Ditto . 00000028 MPLLEN *-MPLBK MPLBK length in bytes. 00000005 MPLSIZE (MPLLEN+7)/8 MPLBK size in doublewords
 
 
  MPLBK Storage Layout Top of page
 
          
*** MPLBK - Map Parameter List BlocK.
*
*     +-------------+-------------+-------------+-------------+
*   0 |  MPLDIAGC   |  MPLFCODE   |  MPLDWLEN   |  MPLVERSN   |
*     +-------------+-------------+-------------+-------------+
*   8 |                       MPLASIT                         |
*     +---------------------------+---------------------------+
*  10 |///////////////////////////|         MPLSPAGE          |
*     +---------------------------+------+------+-------------+
*  18 |         MPLEXTCT          |:TYPFG|:PAGVW|  MPLRSVD0   |
*     +---------------------------+------+------+------+------+
*  20 |         MPLXLDAL          |////////////////////|:XLDB3|
*     +---------------------------+--------------------+------+
*  28
*
*** MPLBK - Map Parameter List BlocK.
 
 
  MPLBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
MPLASIT        0008
MPLBLOCK       001C 80
MPLCONSC       001C 80
MPLDC244       0000 MPLDIAGC
MPLDFMAP       0002 01
MPLDIAGC       0000
MPLDWLEN       0004
MPLENTCT       0018 00000018
MPLEXTCT       0018
MPLFCODE       0002
MPLFETCH       001D 00000000
MPLIPOOL       0002 00
MPLLEN         0027 00000028
MPLMAXFC       0002 03
MPLMLDAL       0020 00000020
MPLMLDBA       0024 00000024
MPLMLDB3       0027 00000027
MPLPAGCT       0018 00000018
MPLPAGMX       001D 02
MPLPAGVW       001D
MPLRETAN       001D 01
MPLRMMAP       0002 02
MPLRSVD0       001E
MPLSAVPG       0002 03
MPLSIZE        0027 00000005
MPLSLDAL       0020 00000020
MPLSLDBA       0024 00000024
MPLSLDB3       0027 00000027
MPLSPAGE       0014
MPLSPRBN       0024 00000024
MPLTYPFG       001C
MPLVERCD       0006 01
MPLVERSN       0006
MPLXLDAL       0020
MPLXLDBA       0024
MPLXLDB3       0027
MPLZERO        001D 02
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:52:52 EDT.
Copyright IBM Corporation, 1990, 2022