Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### MPLBK

Prolog

Control Block Contents
MPLBK DSECT

Storage Layout

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

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

    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 V5R2.0. Last updated on 12 Apr 2006 at 17:05:47 EDT.
Copyright IBM Corporation, 1990, 2005