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

#### DXLPL

Prolog

Control Block Contents
DXLPL DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### DXLPL Prolog

     NAME       : HCPDXLPL
     DESCRIPTION: DIAGNOSE X'278' (XLINK) Parameter List
     DSECT      : DXLPL
     FUNCTION   : DXLPL maps the parameter list for DIAGNOSE x'278'
                  requests.
     LOCATED BY : DIAGNOSE-specified user register "Ry"
     CREATED BY : The virtual machine
     DELETED BY : The creating virtual machine

#### DXLPL Control Block Content

#### DXLPL DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      DXLPL          DIAGNOSE X'278' (XLINK) Parameter
                                            List
            The diagnose 278 request bits from user's Rx register.
            Unassigned bits must be 0 in Rx.
              .... ....      DXLSYINR       X'80000000' Request for System
                                            Include list
              .... ....      DXLSYEXR       X'40000000' Request for System
                                            Exclude list
              .... ....      DXLDTABR       X'20000000' Request for Device
                                            Table
              .... ....      DXLVLINR       X'10000000' Request for Volume
                                            Include list
              .... ....      DXLVLEXR       X'08000000' Request for Volume
                                            Exclude list
            Layout for Diagnose X'278'
    0000    0 Dbl-Word     8 DXLHDR (0)     Input fields begin here
    0000    0 Bitstring    2 DXLPLID        Parameter list ID, = x'0278'
    0002    2 Bitstring    2 *              Reserved
    0004    4 Signed       2 DXLBLEN        D-words provided by caller
    0006    6 Signed       2 DXLDLEN        D-words required to hold all data
                                            Length of the data that was (or
                                            would have been) placed into
                                            field DXLDATA. If the guest
                                            condition code is 0, then DXLDATA
                                            contains data. If the guest
                                            condition code is 3, then the
                                            contents of DXLDATA are
                                            unpredictable.
    0008    8 Dbl-Word     8 * (0)          Pad DXLHDR to d-word boundary
              00000008       DXLHDRL        *-DXLHDR Length of DXLPL header
    0008    8 Dbl-Word     8 DXLDATA (0)    Response data starts here
          Control fields for System Include list.
    0008    8 Signed       2 DXLSYINO       Offset from DXLPL to first entry
                                            in double words
    000A   10 Signed       2 DXLSYINC       Count of entries
    000C   12 Signed       2 DXLSYINL       Length of each entry
    000E   14 Signed       2 *              Reserved Each entry: 8 byte
                                            system name Length-8 bytes of
                                            padding
          Control fields for System Exclude list.
    0010   16 Signed       2 DXLSYEXO       Offset from DXLPL to first entry
                                            in double words
    0012   18 Signed       2 DXLSYEXC       Count of entries
    0014   20 Signed       2 DXLSYEXL       Length of each entry
    0016   22 Signed       2 *              Reserved Each entry: 8 byte
                                            system name Length-8 bytes of
                                            padding
          Control fields for Volume Include list.
    0018   24 Signed       2 DXLVLINO       Offset from DXLPL to first entry
                                            in double words
    001A   26 Signed       2 DXLVLINC       Count of entries
    001C   28 Signed       2 DXLVLINL       Length of each entry
    001E   30 Signed       2 *              Reserved Each entry: 6 byte
                                            volume serial pattern 2 byte cyl
                                            number 2 byte trk number 2 byte
                                            rec len 2 byte recs Length-14
                                            bytes of padding
          Control fields for Volume Exclude list.
    0020   32 Signed       2 DXLVLEXO       Offset from DXLPL to first entry
                                            in double words
    0022   34 Signed       2 DXLVLEXC       Count of entries
    0024   36 Signed       2 DXLVLEXL       Length of each entry
    0026   38 Signed       2 *              Reserved Each entry: 6 byte
                                            volume serial pattern Length-6
                                            bytes of padding
          Control fields for Device Table entries.
    0028   40 Signed       2 DXLDTABO       Offset from DXLPL to first entry
                                            in double words
    002A   42 Signed       2 DXLDTABC       Count of entries
    002C   44 Signed       2 DXLDTABL       Length of each entry
    002E   46 Signed       2 *              Reserved Each entry: 1 byte
                                            device type (from HCPDVTYP) 1
                                            byte model/etc. information 2
                                            byte cyl number 2 byte trk number
                                            2 byte rec len 2 byte recs
                                            Length-10 bytes of padding
          End of control pointers.
                 .
                 .                    Anything may be inserted here
                 .                    w/o requiring users of this
                 .                    diagnose to re-assemble, as
                 .                    long as all references to the
                 .                    response details are through
                 .                    the control fields (offset,
                 .                    length, etc.) defined above.
                 .                    References to label DXLDATAV
                 .                    should be avoided.
                 .
    0030   48 Dbl-Word     8 DXLDATAV (0)   Response details start here
              00000006       DXLSIZED       (*-DXLPL+7)/8 Minimum usable size
                                            in d-words

#### DXLPL Storage Layout

    *** DXLPL - DIAGNOSE X'278' (XLINK) Parameter List
    *
    *     +-------------+-------------+-------------+-------------+
    *   0 |  DXLPLID    |/////////////|  DXLBLEN    |  DXLDLEN    |
    *     +-------------+-------------+-------------+-------------+
    *   8 |  DXLSYINO   |  DXLSYINC   |  DXLSYINL   |/////////////|
    *     +-------------+-------------+-------------+-------------+
    *  10 |  DXLSYEXO   |  DXLSYEXC   |  DXLSYEXL   |/////////////|
    *     +-------------+-------------+-------------+-------------+
    *  18 |  DXLVLINO   |  DXLVLINC   |  DXLVLINL   |/////////////|
    *     +-------------+-------------+-------------+-------------+
    *  20 |  DXLVLEXO   |  DXLVLEXC   |  DXLVLEXL   |/////////////|
    *     +-------------+-------------+-------------+-------------+
    *  28 |  DXLDTABO   |  DXLDTABC   |  DXLDTABL   |/////////////|
    *     +-------------+-------------+-------------+-------------+
    *
    *** DXLPL - DIAGNOSE X'278' (XLINK) Parameter List

#### DXLPL Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DXLBLEN        0004
    DXLDATA        0008
    DXLDATAV       0030
    DXLDLEN        0006
    DXLDTABC       002A
    DXLDTABL       002C
    DXLDTABO       0028
    DXLDTABR       0000 00
    DXLHDR         0000
    DXLHDRL        0008 00000008
    DXLPLID        0000
    DXLSIZED       0030 00000006
    DXLSYEXC       0012
    DXLSYEXL       0014
    DXLSYEXO       0010
    DXLSYEXR       0000 00
    DXLSYINC       000A
    DXLSYINL       000C
    DXLSYINO       0008
    DXLSYINR       0000 00
    DXLVLEXC       0022
    DXLVLEXL       0024
    DXLVLEXO       0020
    DXLVLEXR       0000 00
    DXLVLINC       001A
    DXLVLINL       001C
    DXLVLINO       0018
    DXLVLINR       0000 00

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 16:52:32 EDT.
Copyright IBM Corporation, 1990, 2005