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 V4R2.0. Last updated on 17 Oct 2001 at 15:11:18 EDT.
Copyright IBM Corporation, 1990, 2001