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.

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   |/////////////|
*     +-------------+-------------+-------------+-------------+
*  30 |                                                       |
*     =                       DXLDATAV                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** DXLPL - DIAGNOSE X'278' (XLINK) Parameter List

 

DXLPL Cross Reference

(contains links to field and bit definitions)
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 VM/ESA 2.4.0.
Last updated on 3 Aug 1999 at 11:54:01 EDT.
Copyright IBM Corporation, 1990, 1999