|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
MPLBK
Cross Reference (Contains links to field and bit definitions)
MPLBK Prolog
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.
COMMENTS : NONE
MPLBK Control Block Content
MPLBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure MPLBK Map Parameter List BlocK. 0000 0 Signed 2 MPLDIAGC Diagnose number. 00000244 MPLDC244 X'0244' Diagnose code 244. 0002 2 Signed 2 MPLFCODE Diagnose function code. .... .... MPLIPOOL X'0000' Identify Pool function code. .... ...1 MPLDFMAP X'0001' Define mapping function code. .... ..1. MPLRMMAP X'0002' Remove mapping function code. .... ..11 MPLSAVPG X'0003' 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. ****************------------ 00000001 MPLVERCD 1 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. 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 This will cause an assembly error if this control block gets to large to fit into VMDVOBUF. 0028 40 Address 4 * (0) IEV075 will resu lt if MPLSIZE*8 GT 256 @P3714FM
MPLBK Storage Layout
*** MPLBK - Map Parameter List BlocK. * * +-------------+-------------+-------------+-------------+ * 0 | MPLDIAGC | MPLFCODE | MPLDWLEN | MPLVERSN | * +-------------+-------------+-------------+-------------+ * 8 | MPLASIT | * +---------------------------+---------------------------+ * 10 |///////////////////////////|///////////////////////////| * +---------------------------+------+------+-------------+ * 18 | MPLEXTCT |:TYPFG|:PAGVW| MPLRSVD0 | * +---------------------------+------+------+------+------+ * 20 | MPLXLDAL |////////////////////|:XLDB3| * +---------------------------+--------------------+------+ * 28 * *** MPLBK - Map Parameter List BlocK.
MPLBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----MPLASIT 0008
MPLBLOCK 001C 80
MPLCONSC 001C 80
MPLDC244 0000 00000244
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
MPLSPRBN 0024 00000024
MPLTYPFG 001C
MPLVERCD 0006 00000001
MPLVERSN 0006
MPLXLDAL 0020
MPLXLDBA 0024
MPLXLDB3 0027
MPLZERO 001D 02
Last updated on 3 Aug 1999 at 12:15:09 EDT.
Copyright IBM Corporation, 1990, 1999