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

SZREQ

Prolog  

Control Block Contents  
   SZREQ DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


SZREQ Prolog

 NAME       : HCPSZREQ
 DESCRIPTION: SCSI Strategy Call Request Block
 DSECT      : SZREQ
 FUNCTION   :
 LOCATED BY :
 CREATED BY :
 DELETED BY :
 SERIALIZED :
 NOTES      :
              This DSECT is a mapping of the blkioReq_iosct structure.
              It must match exactly, including offsets up to SZREQEND.
              CAUTION: The DIGNUS C compiler aligns all LONG
              definitions on 64 bit boundaries.  Care must be
              taken to account for the alignment in this DSECT.
              This is a variable length block.  It may or may not
              contain a 512-byte temp buffer.
              HLA = Host Logical Address
              HAA = Host Absolute Address

 

SZREQ Control Block Content


SZREQ DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SZREQ          SCSI Strategy Call Request Block
0000    0 Bitstring    1 SZRFLGU (6)    Unused flag bytes
0006    6 Bitstring    1 SZRFLGEX       Extended Status flags
          .... ...1      SZRBASYN       X'01' SZRBASYN Don't wait for I/O
                                        completion
          ...1 ....      SZRBMORE       X'10' SZRBMORE More buffers to be
                                        processed
          .1.. ....      SZRBPROT       X'40' SZRBPROT Protection
                                        violation
          1... ....      SZRBSPLT       X'80' SZRBSPLT Enable split
                                        read/write
0007    7 Bitstring    1 SZRFLGST       Status flags
          .... ....      SZRBWRIT       X'00' SZRBWRIT Non-read flag
          .... ...1      SZRBREAD       X'01' SZRBREAD Read when I/O
                                        occurs
          .... ..1.      SZRBDONE       X'02' SZRBDONE I/O complete
          .... .1..      SZRBERR        X'04' SZRBERR Error detected
          .... 1...      SZRBBUSY       X'08' SZRBBUSY I/O in progress
0008    8 Address      8 *              Reserved for SCSI Container use
0010   16 Address      8 *              Reserved for SCSI Container use
0018   24 Address      8 SZRFORW (0)    64-bit HLA(next SZREQ) CP only
                                        uses 31-bit HLA in SZRFORWL
0018   24 Address      4 SZRFORWH       High word of SZRFORW
001C   28 Address      4 SZRFORWL       Low word of SZRFORW
0020   32 Address      8 *              Reserved for SCSI Container use
0028   40 Address      8 *              Reserved for SCSI Container use
0030   48 Address      8 *              Reserved for SCSI Container use
0038   56 Address      8 *              Reserved for SCSI Container use
0040   64 Dbl-Word     8 SZRBLKNO (0)   Block number on device CP only
                                        uses 32-bit block numbers
0040   64 Signed       4 SZRBLKNH       High word of SZRBLKNO
0044   68 Signed       4 SZRBLKNL       Low word of SZRBLKNO
0048   72 Address      8 SZRBUFRA (0)   64-bit HAA(Data buffer)
0048   72 Address      4 SZRBUFRH       High word of SZRBUFRA
004C   76 Address      4 SZRBUFRL       Low word of SZRBUFRA
0050   80 Dbl-Word     8 SZRBCNT (0)    Transfer count in bytes CP only
                                        uses 32-bit byte counts
0050   80 Signed       4 SZRBCNTH       High word of SZRBCNT
0054   84 Signed       4 SZRBCNTL       Low word of SZRBCNT
0058   88 Dbl-Word     8 SZRRESID (0)   Bytes not transfered after error
                                        CP only uses 32-bit byte counts
0058   88 Signed       4 SZRRSIDH       High word of SZRRESID
005C   92 Signed       4 SZRRSIDL       Low word of SZRRESID
0060   96 Dbl-Word     8 *              Reserved for SCSI Container use
0068  104 Signed       4 *              Reserved for SCSI Container use
006C  108 Bitstring    1 SZRERROR       Error indicator returned after
                                        I/O
          .... ...1      SZREPERM       1 SZREPERM Operation not
                                        permitted
          .... ..1.      SZRENOEN       2 SZRENOEN Operation not
                                        permitted
          .... .1.1      SZREIO         5 SZREIO I/O error
          .... .11.      SZRENXIO       6 SZRENXIO No such device or
                                        address
          .... 1.11      SZREAGAI       11 SZREAGAI Resource temporarily
                                        unavailable
          .... 11..      SZRENOME       12 SZRENOME Not enough space
          .... 11.1      SZREACCE       13 SZREACCE Permission denied
          .... 111.      SZREFAUL       14 SZREFAUL Bad address
          ...1 ....      SZREBUSY       16 SZREBUSY Resource busy
          ...1 ...1      SZREEXIS       17 SZREEXIS File exists
          ...1 ..11      SZRENODE       19 SZRENODE No such device
          ...1 .11.      SZREINVA       22 SZREINVA Invalid argument
          ..1. ..1.      SZRERANG       34 SZRERANG Result too large
          ..1. 1.1.      SZREUNAT       42 SZREUNAT Protocol driver not
                                        attached
          ..1. 111.      SZRENOTR       46 SZRENOTR Device not ready
          ..1. 1111      SZREWRPR       47 SZREWRPR Write-protected media
          ..11 ....      SZREFORM       48 SZREFORM Unformatted media
          ..11 ...1      SZRENOLC       49 SZRENOLC No locks available
          ..11 ..1.      SZRENOCO       50 SZRENOCO No connection
          ..11 .1..      SZRESTAL       52 SZRESTAL No filesystem
          ..11 .111      SZREINPR       55 SZREINPR Operation now in
                                        progress
          .1.. .1.1      SZRENETD       69 SZRENETD Network is down
          .1.. .11.      SZRENETU       70 SZRENETU Network is
                                        unreachable
          .1.. 111.      SZRETIME       78 SZRETIME Connection timed out
          .1.. 1111      SZRECONN       79 SZRECONN Connection refused
          .11. 111.      SZREMEDI       110 SZREMEDI Media surface error
          .11. 1111      SZRESOFT       111 SZRESOFT I/O completed, but
                                        needs relocation
          .111 .1..      SZREDEAD       116 SZREDEAD Dead Link (FAStT)
          1... ...1      SZREPURG       129 SZREPURG I/O purged
006D  109 Bitstring    1 * (3)          Padding to match header compile
0070  112 Bitstring    1 * (20)         Reserved for SCSI Container use
0084  132 Bitstring    1 * (8)          Reserved for SCSI Container use
008C  140 Bitstring    1 * (4)          Padding to match header compile
             **********************************************------
             * struct xmem definition
             *
             * Structure to hold virtual to real mappings
             * for pre-translated cross memory descriptors
             **********************************************------
0090  144 Bitstring   32 SZRXMEM (0)    xmem descriptor for data buffer
0090  144 Signed       4 SZRXASI        Address space identifier
          00FFFF9C       SZRXVMTP       -100 SZRXVMTP VM TYPE (xmem
                                        contains real addrs)
0094  148 Signed       4 SZRXFLG        control flags Start of imbedded
                                        V2R mapping structure (xmem_ct)
0098  152 Signed       4 SZRXTOT        length of RPN array (total
                                        elements)
009C  156 Signed       4 SZRXUSD        number of rpn elements used
00A0  160 Dbl-Word     8 SZRXVPN        virtual page number
00A8  168 Address      8 SZRXRPN (0)    HLA(array of real page numbers)
00A8  168 Address      4 SZRXRPNH       High word of SZRXRPN
00AC  172 Address      4 SZRXRPNL       Low word of SZRXRPN
00B0  176 Bitstring    8 *              Reserved for SCSI Container use
00B8  184 Address      8 SZRBEXT (0)    64-bit HLA(Buffer Extension) CP
                                        only uses 31-bit HLA in SZRBEXTL
00B8  184 Address      4 SZRBEXTH       High word of SZRBEXT
00BC  188 Address      4 SZRBEXTL       Low word of SZRBEXT
00C0  192 Bitstring   40 *              Reserved for SCSI Container use
00E8  232 Bitstring   16 SZRDVREF       IOSC handle for device (devref)
00F8  248 Bitstring   16 SZRPSREF       PERS handle for device
0108  264 Bitstring   16 SZRIODON       Vector for caller's iodone
                                        routine
0118  280 Bitstring   16 *              Workarea reserved for IOSC
0128  296 Bitstring   16 *              Workarea reserved for PERS
0138  312 Bitstring   32 *              Reserved for SCSI Container use
      End of blkioReq_iosct structure architected for z/Series
      Portable Stack.
0158  344 Signed       2 SZREQEND (0)   End of architected request block
      End of architected structs for z/Series Portable I/O Stack.
      Remaining data is for CP use only.
0158  344 Bitstring    4 SZRCPEC        Eye-catcher for start of CP area
015C  348 Signed       4 SZRADRLN       DWORD length of SZRADRLT
0160  352 Address      4 SZRNXTRQ       Copy of SZRFORWL for CP use
0164  356 Address      4 SZREDEVA       31-bit HL EDEV address
0168  360 Address      4 SZRADDRS (0)   Address area
      Start of remappable fields
             **********************************************------
             * Mapping for FBA Emulation
             **********************************************------
0168  360 Address      4 SZRCPSRC       31-bit HL source address of data
                                        to be copied from a temp buffer
0170  368 Address      8 SZRCPTGT       64-bit HA target address of data
                                        to be copied from a temp buffer
0178  376 Signed       4 SZRCPLEN       Number of bytes to be copied from
                                        SZRCPSRC to SZRCPTGT
017C  380 Address      4 * (3)          Reserved for IBM use
             **********************************************------
             * Mapping for Native SCSI Paging
             * Only valid when SZRNATIV flag set.
             **********************************************------
0168  360 Address      4 SZRSVRTN       31-bit HLA(SVGBK) to return to
                                        caller
016C  364 Address      4 SZRSVPIR       31-bit HLA(PIRBK) to obtain IRA
0170  368 Address      4 SZREXPA        31-bit HLA(EXPBK) Exposure Block
                                        addr
0174  372 Address      4 SZRCPEA        31-bit HLA(CPEBK) to return
                                        control from the SCSI container
0178  376 Address      4 SZRTIMER       TOD at start of I/O
017C  380 Address      4 SZRINTIM       TOD at time of interrupt
0180  384 Address      4 SZRNMREQ       Count of active SCSI paging
                                        requests
      End of remappable fields
0184  388 Bitstring    1 SZRCPFLG       Status flags
          1... ....      SZRCONTG       X'80' SZRCONTG Indicates target
                                        address is contiguous with
                                        previous request.
          .1.. ....      SZRIDA         X'40' SZRIDA Represents an IDA
                                        list
          ..1. ....      SZRNATIV       X'20' SZRNATIV This block is for
                                        a native SCSI I/O (FBA Emulation
                                        not used)
          ...1 ....      SZRDONE        X'10' SZRDONE HCPSZADN called for
                                        this block
          .... 1...      SZRNATER       X'08' SZRNATER Native SCSI I/O
                                        error occurred (FBA Emulation not
                                        used)
          .... .1..      SZRNPMUL       X'04' SZRNPMUL Native SCSI Paging
                                        Multi-R/W (FBA Emulation not
                                        used)
          .... ..1.      SZRADR         X'02' SZRADR This block contains
                                        a ADR buffer (mutually exclusive
                                        with SZRTBUF)
          .... ...1      SZRTBUF        X'01' SZRTBUF This block contains
                                        a temp buffer (mutually exclusive
                                        with SZRADR)
0185  389 Bitstring    1 * (3)          RESERVED FOR FUTURE IBM USE
0188  392 Address      8 SZRADRLT (0)   List of 64-bit HA addresses
                                        (entry 1) See SZRADRBX note
                                        below.
0188  392 Address      4 SZRADRLH       High word of SZRADRLT
018C  396 Address      4 SZRADRLL       Low word of SZRADRLT
0190  400 Character    1 SZRXTND (0)    Start of extended data
          00000190       SZRBYSZ        *-SZREQ SZREQ byte size
          00000032       SZRDWSZ        (*-SZREQ+7)/8 SZREQ doubleword
                                        size
      SZREQ containing a ADR List with more than 1 entry.
      NOTES      : The ADR List extension MUST immediately follow
            SZRADRLT and can extend to the lesser of the max
            supported by the SCSI container (537 dwords) or the
            max number of dwords that can be allocatd from a
            single page with GETST (see FREMX).
0190  400 Address      8 SZRADRBX (0)   Entries 2 through n follow...
          000001CC       SZRADRMX       (FREMX-SZRDWSZ)+1 Max elements in
                                        ADR List for non-full page GETST
      SZREQ containing a 512 byte buffer.
0190  400 Bitstring    1 SZRTBUFR (512) Buffer for a single 512 byte FBA
                                        block space 1
          00000390       SZRBFBSZ       *-SZREQ SZREQ byte size with temp
                                        buffer
          00000072       SZRBFDSZ       (*-SZREQ+7)/8 SZREQ dword size w/
                                        temp buffer

 

SZREQ Storage Layout

          
*** SZREQ - SCSI Strategy Call Request Block
*
*     +-----------------------------------------+------+------+
*   0 |                SZRFLGU                  |:FLGEX|:FLGST|
*     +-----------------------------------------+------+------+
*   8 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  10 |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
*  18 |         SZRFORWH          |         SZRFORWL          |
*     +---------------------------+---------------------------+
*  20 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  28 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  30 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  38 |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
*  40 |         SZRBLKNH          |         SZRBLKNL          |
*     +---------------------------+---------------------------+
*  48 |         SZRBUFRH          |         SZRBUFRL          |
*     +---------------------------+---------------------------+
*  50 |         SZRBCNTH          |         SZRBCNTL          |
*     +---------------------------+---------------------------+
*  58 |         SZRRSIDH          |         SZRRSIDL          |
*     +---------------------------+---------------------------+
*  60 |///////////////////////////////////////////////////////|
*     +---------------------------+------+--------------------+
*  68 |///////////////////////////|:ERROR|////////////////////|
*     +---------------------------+------+--------------------+
*  70 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////+---------------------------+
*     |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  88 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  90 |         SZRXASI           |         SZRXFLG           |
*     +---------------------------+---------------------------+
*  98 |         SZRXTOT           |         SZRXUSD           |
*     +---------------------------+---------------------------+
*  A0 |                       SZRXVPN                         |
*     +---------------------------+---------------------------+
*  A8 |         SZRXRPNH          |         SZRXRPNL          |
*     +---------------------------+---------------------------+
*  B0 |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
*  B8 |         SZRBEXTH          |         SZRBEXTL          |
*     +---------------------------+---------------------------+
*  C0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  E8 |                       SZRDVREF                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  F8 |                       SZRPSREF                        |
*     |                                                       |
*     +-------------------------------------------------------+
* 108 |                       SZRIODON                        |
*     |                                                       |
*     +-------------------------------------------------------+
* 118 |///////////////////////////////////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 128 |///////////////////////////////////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 138 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*
*** SZREQ - SCSI Strategy Call Request Block
          
*** Overlay for SZREQEND in SZREQ
*
*     +---------------------------+---------------------------+
* 158 |         SZRCPEC           |         SZRADRLN          |
*     +---------------------------+---------------------------+
* 160 |         SZRNXTRQ          |         SZREDEVA          |
*     +---------------------------+---------------------------+
*
*** Overlay for SZREQEND in SZREQ
          
*** Overlay for SZRADDRS in SZREQ
*
*     +---------------------------+---------------------------+
* 168 |         SZRCPSRC          |///////////////////////////|
*     +---------------------------+---------------------------+
* 170 |                       SZRCPTGT                        |
*     +---------------------------+---------------------------+
* 178 |         SZRCPLEN          |///////////////////////////|
*     +---------------------------+///////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 188
*
*** Overlay for SZRADDRS in SZREQ
          
*** Overlay for SZRADDRS in SZREQ
*
*     +---------------------------+---------------------------+
* 168 |         SZRSVRTN          |         SZRSVPIR          |
*     +---------------------------+---------------------------+
* 170 |         SZREXPA           |         SZRCPEA           |
*     +---------------------------+---------------------------+
* 178 |         SZRTIMER          |         SZRINTIM          |
*     +---------------------------+------+--------------------+
* 180 |         SZRNMREQ          |:CPFLG|////////////////////|
*     +---------------------------+------+--------------------+
* 188 |         SZRADRLH          |         SZRADRLL          |
*     +---------------------------+---------------------------+
*
*** Overlay for SZRADDRS in SZREQ
          
*** Overlay for SZRXTND in SZREQ
*
*
*** Overlay for SZRXTND in SZREQ
          
*** Overlay for SZRXTND in SZREQ
*
*     +-------------------------------------------------------+
* 190 |                                                       |
*     =                       SZRTBUFR                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 390
*
*** Overlay for SZRXTND in SZREQ

 

SZREQ Cross Reference

Symbol         Dspl Value
-------------- ---- -----
SZRADDRS       0168
SZRADR         0184 02
SZRADRBX       0190
SZRADRLH       0188
SZRADRLL       018C
SZRADRLN       015C
SZRADRLT       0188
SZRADRMX       0190 000001CC
SZRBASYN       0006 01
SZRBBUSY       0007 08
SZRBCNT        0050
SZRBCNTH       0050
SZRBCNTL       0054
SZRBDONE       0007 02
SZRBERR        0007 04
SZRBEXT        00B8
SZRBEXTH       00B8
SZRBEXTL       00BC
SZRBFBSZ       0190 00000390
SZRBFDSZ       0190 00000072
SZRBLKNH       0040
SZRBLKNL       0044
SZRBLKNO       0040
SZRBMORE       0006 10
SZRBPROT       0006 40
SZRBREAD       0007 01
SZRBSPLT       0006 80
SZRBUFRA       0048
SZRBUFRH       0048
SZRBUFRL       004C
SZRBWRIT       0007 00
SZRBYSZ        0190 00000190
SZRCONTG       0184 80
SZRCPEA        0174
SZRCPEC        0158
SZRCPFLG       0184
SZRCPLEN       0178
SZRCPSRC       0168
SZRCPTGT       0170
SZRDONE        0184 10
SZRDVREF       00E8
SZRDWSZ        0190 00000032
SZREACCE       006C 0D
SZREAGAI       006C 0B
SZREBUSY       006C 10
SZRECONN       006C 4F
SZREDEAD       006C 74
SZREDEVA       0164
SZREEXIS       006C 11
SZREFAUL       006C 0E
SZREFORM       006C 30
SZREINPR       006C 37
SZREINVA       006C 16
SZREIO         006C 05
SZREMEDI       006C 6E
SZRENETD       006C 45
SZRENETU       006C 46
SZRENOCO       006C 32
SZRENODE       006C 13
SZRENOEN       006C 02
SZRENOLC       006C 31
SZRENOME       006C 0C
SZRENOTR       006C 2E
SZRENXIO       006C 06
SZREPERM       006C 01
SZREPURG       006C 81
SZREQEND       0158
SZRERANG       006C 22
SZRERROR       006C
SZRESOFT       006C 6F
SZRESTAL       006C 34
SZRETIME       006C 4E
SZREUNAT       006C 2A
SZREWRPR       006C 2F
SZREXPA        0170
SZRFLGEX       0006
SZRFLGST       0007
SZRFLGU        0000
SZRFORW        0018
SZRFORWH       0018
SZRFORWL       001C
SZRIDA         0184 40
SZRINTIM       017C
SZRIODON       0108
SZRNATER       0184 08
SZRNATIV       0184 20
SZRNMREQ       0180
SZRNPMUL       0184 04
SZRNXTRQ       0160
SZRPSREF       00F8
SZRRESID       0058
SZRRSIDH       0058
SZRRSIDL       005C
SZRSVPIR       016C
SZRSVRTN       0168
SZRTBUF        0184 01
SZRTBUFR       0190
SZRTIMER       0178
SZRXASI        0090
SZRXFLG        0094
SZRXMEM        0090
SZRXRPN        00A8
SZRXRPNH       00A8
SZRXRPNL       00AC
SZRXTND        0190
SZRXTOT        0098
SZRXUSD        009C
SZRXVMTP       0090 00FFFF9C
SZRXVPN        00A0

This information is based on z/VM V5R4.0. Last updated on 18 Feb 2010 at 04:17:16 EDT.
Copyright IBM Corporation, 1990, 2009