Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### SZQBK

Prolog

Control Block Contents
SZQBK DSECT
SZQSTATS DSECT
SZQSTATE DSECT
SZQDEVIN DSECT
SZQPTHIN DSECT

Storage Layout

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 SZQVNDR1       Vendor-specific storage byte
    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    2 *              Reserved for future IBM use
    003E   62 Bitstring    1 SZQIEEET       IEEE id type
    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|:VNDR1|:DPTHS|   (006)-    |
    *     +-------------+------+------+------+------+-------------+
    *   8 |               -SZQVENID                 |             |
    *     +-----------------------------------------+             |
    *     |                       SZQPROID                        |
    *     |                                         +-------------+
    *     |                                         | SZQPRORL-   |
    *     +-------------+-------------+-------------+-------------+
    *  20 |   -(01E)    |/////////////|         SZQBLKSZ          |
    *     +-------------+-------------+---------------------------+
    *  28 |                       SZQNUMBK                        |
    *     +-------------------------------------------------------+
    *  30 |                       SZQBLKSL                        |
    *     +------+------+------+------+-------------+------+------+
    *  38 |:FLAG1|:FLAG2|:FLAG3|:FLAG4|/////////////|:IEEET|: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
    SZQIEEET       003E
    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
    SZQVNDR1       0004
    SZQWWPN        0008

    This information is
    based on z/VM V6R1.0.
    Last updated on 18 Feb 2010 at 09:15:21 EDT.

    Copyright IBM Corporation, 1990, 2008