CP obtains device information from three control blocks: virtual device information
from the virtual device block (VDEVBLOK), and real device information from the
real device block (RDEVBLOK) and from NICBLOK. The following diagrams
identify specific information returned by CP and show how to locate this informa­
tion in the Rx, Ry, and Ry+ 1 registers. The symbolic names used in these dia­
grams are the symbolic names used with VDEVBLOK, RDEVBLOK, and NICBLOK in VM / SP Data Areas and Control B lock Logic, Volume 1.
Note: For a DIAGNOSE X'24' to an SNA device though VCNA, the model
(RDEVMDL) information is correct, however, the RDEVTYPE may not be reli­
able.
Rx Register
Byte 0 RDEVTMCD
- or - NICTMCD Symbolic Name
RDEVTMCD
- or-
NICTMCD
RyRegister
Byte 0 VDEVTYPC
Symbolic Name
VDEVTYPC
VDEVTYPE
VDEVSTAT
VDEVFLAG
Byte 1 Byte 2 I Byte 3
virtual
device address Terminal code bits defining the type of console and the translate
table the console is using. RDEVTMCD is for a local virtual
console; NICTMCD for a remote 3270 virtual console.
Byte 1 Byte 2 Byte 3
VDEVTYPE VDEVSTAT VDEVFLAG
Meaning
Virtual device type class
Virtual device type
Virtual device status
Virtual device flags
DIAGNOSE Instruction in a Virtual Machine 237
Ry+ 1 Register
Byte 0 RDEVTYPC
Symbolic Name
RDEVTYPC
RDEVTYPE
RDEVMDL
RDEVFTR
RDEVLLEN
NICDTYPE
NICMDL
NICLLEN
Byte 1 Byte 2 Byte 3
RDEVTYPE RDEVMDL RDEVFTR
- or- - or- - or-
NICDTYPE NICMDL RDEVLLEN
- or-
NICLLEN
Meaning
Real device type class
Real device type
Real device model number. To determine if the speed matching
buffer for the 3380 or 3375 is' present, check if bits 0 and 1 are
set on.
Real device feature code for a device other than a virtual con­
sole
Current device line length for a local virtual console
Real device type for a remote 3270 virtual console
Real device model number for a remote 3270 virtual console
Current device line length for a remote virtual console
Condition Codes: The following chart lists the condition codes CP can return for DIAGNOSE Code X'24', the meaning of each condition code, and the registers
where data is returned.
This register contains information
If the condition
code equals RXI Ry Ry+12 Comments 0 X X X Normal completion
1 Undefined
2 X X The virtual device
exists but is not
associated with a
real device
3 Invalid device
address or the virtual device
does not exist IThe Rx register contains information only when DIAGNOSE Code X'24' specifies a virtual console whose address is unknown.
2If Ry is register 15, CP returns only virtual device infor-
mation; no information i 5 returned in register Ry+l.
238 VM/SP System Programmer's Guide
Previous Page Next Page