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 V6R1.0. Last updated on 18 Feb 2010 at 09:15:45 EDT.
Copyright IBM Corporation, 1990, 2008