Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
DXLPL
Control Block Contents
DXLPL DSECT
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
Copyright IBM Corporation, 1990, 2001