|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SZQBK
Control Block Contents
SZQBK DSECT
SZQSTATS DSECT
SZQSTATE DSECT
SZQDEVIN DSECT
SZQPTHIN DSECT
Cross Reference (Contains links to field and bit definitions)
SZQBK Prolog
NAME : HCPSZQBK
DESCRIPTION: IOSC_queryDevice Information Block
DSECT : SZQBK
FUNCTION : The data returned by IOSC_queryDevice is placed in
HCPSZQBK so CP can access the data.
LOCATED BY :
CREATED BY : HCPMNO when device statistics are gathered.
HCPSZP when path state is queried.
DELETED BY : HCPMNO when device statistics are gathered.
HCPSZP when path state is queried.
NOTES :
SZQBK Control Block Content
SZQBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure SZQBK IOSC_queryDevice Information
Block
0000 0 Signed 2 SZQQUERY Query type
.... ...1 SZQDDEVS 1 SZQDDEVS Query device state
.... ..1. SZQDDEVP 2 SZQDDEVP Qry device and path
state
.... ..11 SZQDDSKS 3 SZQDDSKS Qry device statistics
.... .1.. SZQDDKPT 4 SZQDDKPT Qry device and path
statistics
.... .111 SZQDINFO 7 SZQDINFO Get additional device
info Disk statistics
0002 2 Bitstring 1 SZQDSTAT Disk status
0003 3 Bitstring 1 * Reserved for future IBM use
0004 4 Signed 4 SZQDTIME Amount of time disk is active
0008 8 Signed 4 SZQDRATE Kbytes/sec transfer rate
000C 12 Signed 4 SZQDBLKS Number of bytes in a block
(blocksize)
0010 16 Signed 4 SZQDXFER Number of transfers to/from disk
0014 20 Signed 4 SZQDBLKR Number of blocks read from disk
0018 24 Signed 4 SZQDBLKW Number of blocks written to disk
001C 28 Signed 4 SZQDSEEK Number of seek operations for
disk
0020 32 Signed 4 SZQDQDPT Queue depth
0024 36 Bitstring 80 * Space for new query info
Path statistics
0074 116 Bitstring 32 SZQPSTTI (8) Up to 8 path statistics
00000174 SZQSIZEB (*-SZQBK) Length of SZQBK in
bytes
0000002F SZQSIZE (*-SZQBK+7)/8 Length of SZQBK in
double words
0002 2 Bitstring 1 SZQDEVST Device State
00000001 SZQDNLD 1 SZQDNLD Device not loaded
00000002 SZQDLD 2 SZQDLD Device loaded
00000003 SZQDACT 3 SZQDACT Device active
00000004 SZQDSTP 4 SZQDSTP Device stopped
00000005 SZQDERR 5 SZQDERR Device in error
0003 3 Bitstring 1 SZQPTHCT
0004 4 Bitstring 16 SZQPATHS Path state information
This dsect maps SZQPSTTI
SZQSTATS DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure SZQSTATS IOSC_queryDevice Information
Block
0000 0 Signed 2 SZQPIDNM Pathid number
0002 2 Bitstring 1 SZQPSTAT Path status - see SZQDSTAT for
bit definitions
0003 3 Bitstring 1 * Reserved for future IBM use
0004 4 Signed 4 SZQPTIME Amount of time path is active
0008 8 Signed 4 SZQPRATE Kbytes/sec transfer rate
000C 12 Signed 4 SZQPXFER Number of transfers to/from disk
0010 16 Signed 4 SZQPBLKR Number of blocks read from disk
0014 20 Signed 4 SZQPBLKW Number of blocks written to disk
0018 24 Signed 4 SZQPSEEK Number of seek operations for
disk
001C 28 Signed 4 SZQPQDPT Queue depth
00000020 SZQSTSSZ *-SZQSTATS Size of path
statistics info in bytes This
dsect map SZQPATHS
SZQSTATE DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure SZQSTATE IOSC_queryDevice Information
Block
0000 0 Bitstring 1 SZQPTHID Path id
0001 1 Bitstring 1 SZQPTHST Path state
00000001 SZQDPACT 1 SZQDPACT Path is Active
00000002 SZQDPSTP 2 SZQDPSTP Path is stopped
00000003 SZQDPIER 3 SZQDPIER Path could not be
initially established
00000004 SZQDPERR 4 SZQDPERR Path established, but
since broken
00000002 SZQSTASZ *-SZQSTATE Size of path state
information in bytes
This dsect is for IOSC_QT_DEVICE_INFO returned device data.
(query device information IOSC_QOK_DISK_INFO)
This dsect overlays the SZQBK from the top up to but not
including SZQPSTTI.
This dsect may need to change when deviceInfo_iocs H struct
is updated. Make sure there is enough space in the SZQBK
for these overlay fields
SZQDEVIN DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure SZQDEVIN IOSC_queryDevice Information
Block
0000 0 Signed 2 SZQQTYPE Query type; use SZQQUERY equates
0002 2 Bitstring 1 SZQLUNST LUN state; Use SZQDSTAT equates
0003 3 Bitstring 1 SZQDEVTY Peripheral device type from SCSI
standard inquiry
0004 4 Bitstring 1 * Reserved for future IBM use
0005 5 Bitstring 1 SZQDPTHS Total paths for this device
0006 6 Bitstring 8 SZQVENID EBCDIC vendor ID for device
000E 14 Bitstring 16 SZQPROID EBCDIC product ID for device
001E 30 Bitstring 4 SZQPRORL EBCDIC product revision level
0022 34 Bitstring 2 * Reserved for future IBM use
0024 36 Signed 4 SZQBLKSZ Blocksize of device
0028 40 Dbl-Word 8 SZQNUMBK Number of blocks for this device
0030 48 Dbl-Word 8 SZQBLKSL Num of blocks at load time
0038 56 Signed 4 SZQFLAGS (0) Device specific cache flags
0038 56 Bitstring 1 SZQFLAG1 Device specific cache flags
.... .1.. SZQFCWOB X'04' SZQFCWOB FAStT-cache
without batteries
.... ..1. SZQFFWT X'02' SZQFFWT FAStT-force write
thru on two minute warning from
ups
.... ...1 SZQFCME X'01' SZQFCME FAStT-cache mirror
enable
0039 57 Bitstring 1 SZQFLAG2 Device specific cache flags
1... .... SZQFABPR X'80' SZQFABPR FAStT-alt ctrl
batteries present
.1.. .... SZQFBPR X'40' SZQFBPR FAStT-batteries
present
..1. .... SZQFACMA X'20' SZQFACMA FAStT-alt ctrl
cache mirror activ
...1 .... SZQFCMA X'10' SZQFCMA FAStT-ctrl cache
mirror active
.... 1... SZQFABOK X'08' SZQFABOK FAStT-alt ctrl
batteries ok
.... .1.. SZQFBOK X'04' SZQFBOK FAStT-ctrl
batteries ok
.... ..1. SZQFRCA X'02' SZQFRCA FAStT-read cache
active
.... ...1 SZQFWCA X'01' SZQFWCA FAStT-write cache
active
003A 58 Bitstring 1 SZQFLAG3 Device specific cache flags
003B 59 Bitstring 1 SZQFLAG4 Device specific cache flags
003C 60 Bitstring 3 * Reserved for future IBM use
003F 63 Bitstring 1 SZQIEEEL IEEE id length
0040 64 Bitstring 32 SZQIEEE EBCDIC IEEE id
0060 96 Bitstring 20 * Reserved for future IBM use
00000074 SZQDEVSZ *-SZQDEVIN Size of device
information
This dsect is for IOSC_QT_DEVICE_INFO returned path data.
(query device information IOSC_QOK_PATH_INFO)
Overlays SZQPSTTI but is formatted to use only 8 24 byte
areas
This dsect must be updated when pathInfo_iocs H structure
is updated.
SZQPTHIN DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure SZQPTHIN IOSC_queryDevice Information
Block
0000 0 Bitstring 2 * Reserved for future IBM use
0002 2 Bitstring 1 SZQCONTY Connection type
.... ...1 SZQSWTCH 1 SZQSWTCH Switched connection
.... ..1. SZQPTPT 2 SZQPTPT Point to point
connection
0003 3 Bitstring 1 SZQPREFP Preferred path if 1750
.... ...1 SZQPREF 1 SZQPREF Preferred path for 1750
0004 4 Signed 4 SZQPATHI Path id for this path
0008 8 Dbl-Word 8 SZQWWPN World Wide Port Name
0010 16 Dbl-Word 8 SZQSCID SCSI id
00000018 SZQPTHSZ *-SZQPTHIN Size of path
information
SZQBK Storage Layout
*** SZQBK - IOSC_queryDevice Information Block
*
* +-------------+------+------+---------------------------+
* 0 | SZQQUERY |:DSTAT|//////| SZQDTIME |
* +-------------+------+------+---------------------------+
* 8 | SZQDRATE | SZQDBLKS |
* +---------------------------+---------------------------+
* 10 | SZQDXFER | SZQDBLKR |
* +---------------------------+---------------------------+
* 18 | SZQDBLKW | SZQDSEEK |
* +---------------------------+---------------------------+
* 20 | SZQDQDPT |///////////////////////////|
* +---------------------------+///////////////////////////|
* 28 |///////////////////////////////////////////////////////|
* =///////////////////////////////////////////////////////=
* |///////////////////////////+---------------------------+
* |///////////////////////////| |
* +---------------------------+ |
* 78 | |
* = SZQPSTTI =
* | +---------------------------+
* | | 174
* +---------------------------+
*
*** SZQBK - IOSC_queryDevice Information Block
*** Overlay for SZQDSTAT in SZQBK
*
* +------+------+---------------------------+
* 0 ... 2 |:DEVST|:PTHCT| |
* +-------------+------+------+ |
* | SZQPATHS |
* | +---------------------------+
* | | 14
* +---------------------------+
*
*** Overlay for SZQDSTAT in SZQBK
*** SZQSTATS - IOSC_queryDevice Information Block
*
* +-------------+------+------+---------------------------+
* 0 | SZQPIDNM |:PSTAT|//////| SZQPTIME |
* +-------------+------+------+---------------------------+
* 8 | SZQPRATE | SZQPXFER |
* +---------------------------+---------------------------+
* 10 | SZQPBLKR | SZQPBLKW |
* +---------------------------+---------------------------+
* 18 | SZQPSEEK | SZQPQDPT |
* +---------------------------+---------------------------+
* 20
*
*** SZQSTATS - IOSC_queryDevice Information Block
*** SZQSTATE - IOSC_queryDevice Information Block
*
* +------+------+
* 0 |:PTHID|:PTHST| 2
* +------+------+
*
*** SZQSTATE - IOSC_queryDevice Information Block
*** SZQDEVIN - IOSC_queryDevice Information Block
*
* +-------------+------+------+------+------+-------------+
* 0 | SZQQTYPE |:LUNST|:DEVTY|//////|:DPTHS| (006)- |
* +-------------+------+------+------+------+-------------+
* 8 | -SZQVENID | |
* +-----------------------------------------+ |
* | SZQPROID |
* | +-------------+
* | | SZQPRORL- |
* +-------------+-------------+-------------+-------------+
* 20 | -(01E) |/////////////| SZQBLKSZ |
* +-------------+-------------+---------------------------+
* 28 | SZQNUMBK |
* +-------------------------------------------------------+
* 30 | SZQBLKSL |
* +------+------+------+------+--------------------+------+
* 38 |:FLAG1|:FLAG2|:FLAG3|:FLAG4|////////////////////|:IEEEL|
* +------+------+------+------+--------------------+------+
* 40 | |
* = SZQIEEE =
* | |
* +-------------------------------------------------------+
* 60 |///////////////////////////////////////////////////////|
* =///////////////////////////////////////////////////////=
* |///////////////////////////+---------------------------+
* |///////////////////////////| 74
* +---------------------------+
*
*** SZQDEVIN - IOSC_queryDevice Information Block
*** SZQPTHIN - IOSC_queryDevice Information Block
*
* +-------------+------+------+---------------------------+
* 0 |/////////////|:CONTY|:PREFP| SZQPATHI |
* +-------------+------+------+---------------------------+
* 8 | SZQWWPN |
* +-------------------------------------------------------+
* 10 | SZQSCID |
* +-------------------------------------------------------+
* 18
*
*** SZQPTHIN - IOSC_queryDevice Information Block
SZQBK Cross Reference
Symbol Dspl Value
-------------- ---- -----
SZQBLKSL 0030
SZQBLKSZ 0024
SZQCONTY 0002
SZQDACT 0002 00000003
SZQDBLKR 0014
SZQDBLKS 000C
SZQDBLKW 0018
SZQDDEVP 0000 02
SZQDDEVS 0000 01
SZQDDKPT 0000 04
SZQDDSKS 0000 03
SZQDERR 0002 00000005
SZQDEVST 0002
SZQDEVSZ 0060 00000074
SZQDEVTY 0003
SZQDINFO 0000 07
SZQDLD 0002 00000002
SZQDNLD 0002 00000001
SZQDPACT 0001 00000001
SZQDPERR 0001 00000004
SZQDPIER 0001 00000003
SZQDPSTP 0001 00000002
SZQDPTHS 0005
SZQDQDPT 0020
SZQDRATE 0008
SZQDSEEK 001C
SZQDSTAT 0002
SZQDSTP 0002 00000004
SZQDTIME 0004
SZQDXFER 0010
SZQFABOK 0039 08
SZQFABPR 0039 80
SZQFACMA 0039 20
SZQFBOK 0039 04
SZQFBPR 0039 40
SZQFCMA 0039 10
SZQFCME 0038 01
SZQFCWOB 0038 04
SZQFFWT 0038 02
SZQFLAGS 0038
SZQFLAG1 0038
SZQFLAG2 0039
SZQFLAG3 003A
SZQFLAG4 003B
SZQFRCA 0039 02
SZQFWCA 0039 01
SZQIEEE 0040
SZQIEEEL 003F
SZQLUNST 0002
SZQNUMBK 0028
SZQPATHI 0004
SZQPATHS 0004
SZQPBLKR 0010
SZQPBLKW 0014
SZQPIDNM 0000
SZQPQDPT 001C
SZQPRATE 0008
SZQPREF 0003 01
SZQPREFP 0003
SZQPROID 000E
SZQPRORL 001E
SZQPSEEK 0018
SZQPSTAT 0002
SZQPSTTI 0074
SZQPTHCT 0003
SZQPTHID 0000
SZQPTHST 0001
SZQPTHSZ 0010 00000018
SZQPTIME 0004
SZQPTPT 0002 02
SZQPXFER 000C
SZQQTYPE 0000
SZQQUERY 0000
SZQSCID 0010
SZQSIZE 0074 0000002F
SZQSIZEB 0074 00000174
SZQSTASZ 0001 00000002
SZQSTSSZ 001C 00000020
SZQSWTCH 0002 01
SZQVENID 0006
SZQWWPN 0008
This information is
based on z/VM V5R3.0.
Last updated on 25 Jun 2007 at 17:41:40 EDT.
Copyright IBM Corporation, 1990, 2007