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

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
      Disk statistics
0002    2 Bitstring    1 SZQDSTAT       Disk status
          1... ....      SZQBUSY        X'80' Busy
          .1.. ....      SZQNBUSY       X'40' Not busy
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
      Path statistics
0024   36 Bitstring   32 SZQPSTTI (8)   Up to 8 path statistics
          00000124       SZQSIZEB       (*-SZQBK) Length of SZQBK in
                                        bytes
          00000025       SZQSIZE        (*-SZQBK+7)/8 Length of SZQBK in
                                        double words
0002    2 Bitstring    1 SZQDEVST       Device State
          00000001       SZQDNLD        1 Device not loaded
          00000002       SZQDLD         2 Device loaded
          00000003       SZQDACT        3 Device active
          00000004       SZQDSTP        4 Device stopped
          00000005       SZQDERR        5 Device in error
0003    3 Bitstring    1 SZQPTHCT
0004    4 Bitstring   16 SZQPATHS       Path state information
       The SZQSTATS 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 The
                                        SZQSTATE 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 Path is Active
          00000002       SZQDPSTP       2 Path is stopped
          00000003       SZQDPIER       3 Path could not be initially
                                        established
          00000004       SZQDPERR       4 Path established, but since
                                        broken
          00000002       SZQSTASZ       *-SZQSTATE Size of path state
                                        information in bytes

 

SZQBK Storage Layout

          
*** SZQBK - IOSC_queryDevice Information Block
*
*     +-------------+------+------+---------------------------+
*   0 |  SZQQUERY   |:DSTAT|//////|         SZQDTIME          |
*     +-------------+------+------+---------------------------+
*   8 |         SZQDRATE          |         SZQDBLKS          |
*     +---------------------------+---------------------------+
*  10 |         SZQDXFER          |         SZQDBLKR          |
*     +---------------------------+---------------------------+
*  18 |         SZQDBLKW          |         SZQDSEEK          |
*     +---------------------------+---------------------------+
*  20 |         SZQDQDPT          |                           |
*     +---------------------------+                           |
*  28 |                                                       |
*     =                       SZQPSTTI                        =
*     |                           +---------------------------+
*     |                           | 124
*     +---------------------------+
*
*** 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

 

SZQBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
SZQBUSY        0002 80
SZQDACT        0002 00000003
SZQDBLKR       0014
SZQDBLKS       000C
SZQDBLKW       0018
SZQDERR        0002 00000005
SZQDEVST       0002
SZQDLD         0002 00000002
SZQDNLD        0002 00000001
SZQDPACT       0001 00000001
SZQDPERR       0001 00000004
SZQDPIER       0001 00000003
SZQDPSTP       0001 00000002
SZQDQDPT       0020
SZQDRATE       0008
SZQDSEEK       001C
SZQDSTAT       0002
SZQDSTP        0002 00000004
SZQDTIME       0004
SZQDXFER       0010
SZQNBUSY       0002 40
SZQPATHS       0004
SZQPBLKR       0010
SZQPBLKW       0014
SZQPIDNM       0000
SZQPQDPT       001C
SZQPRATE       0008
SZQPSEEK       0018
SZQPSTAT       0002
SZQPSTTI       0024
SZQPTHCT       0003
SZQPTHID       0000
SZQPTHST       0001
SZQPTIME       0004
SZQPXFER       000C
SZQQUERY       0000
SZQSIZE        0024 00000025
SZQSIZEB       0024 00000124
SZQSTASZ       0001 00000002
SZQSTSSZ       001C 00000020

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:31:53 EDT.
Copyright IBM Corporation, 1990, 2005