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 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 - 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.

 
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