|
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, 2007