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
                   Flag definitions
    0000    0 Bitstring    1 SZRFLGU (6)    Unused flag bytes
    0006    6 Bitstring    1 SZRFLGEX       Extended Status flags
              .... ...1      SZRBASYN       X'01' Don't wait for I/O
                                            completion
              ...1 ....      SZRBMORE       X'10' More buffers to be
                                            processed
              .1.. ....      SZRBPROT       X'40' Protection violation
              1... ....      SZRBSPLT       X'80' Enable split read/write
    0007    7 Bitstring    1 SZRFLGST       Status flags
              00000000       SZRBWRIT       X'00' Non-read flag
              00000001       SZRBREAD       X'01' Read when I/O occurs
              00000002       SZRBDONE       X'02' I/O complete
              00000004       SZRBERR        X'04' Error detected
              00000008       SZRBBUSY       X'08' 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
              00000001       SZREPERM       1 Operation not permitted
              00000002       SZRENOEN       2 Operation not permitted
              00000005       SZREIO         5 I/O error
              00000006       SZRENXIO       6 No such device or address
              0000000B       SZREAGAI       11 Resource temporarily
                                            unavailable
              0000000C       SZRENOME       12 Not enough space
              0000000D       SZREACCE       13 Permission denied
              0000000E       SZREFAUL       14 Bad address
              00000010       SZREBUSY       16 Resource busy
              00000011       SZREEXIS       17 File exists
              00000013       SZRENODE       19 No such device
              00000016       SZREINVA       22 Invalid argument
              00000022       SZRERANG       34 Result too large
              0000002A       SZREUNAT       42 Protocol driver not attached
              0000002E       SZRENOTR       46 Device not ready
              0000002F       SZREWRPR       47 Write-protected media
              00000030       SZREFORM       48 Unformatted media
              00000031       SZRENOLC       49 No locks available
              00000032       SZRENOCO       50 No connection
              00000034       SZRESTAL       52 No filesystem
              00000037       SZREINPR       55 Operation now in progress
              00000045       SZRENETD       69 Network is down
              00000046       SZRENETU       70 Network is unreachable
              0000004E       SZRETIME       78 Connection timed out
              0000004F       SZRECONN       79 Connection refused
              0000006E       SZREMEDI       110 Media surface error
              0000006F       SZRESOFT       111 I/O completed, but needs
                                            relocation
              00000074       SZREDEAD       116 Dead Link (FAStT)
              00000081       SZREPURG       129 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 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.
                                 Beginning of CP USE ONLY data areas
    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' Indicates target address is
                                            contiguous with previous request.
              .1.. ....      SZRIDA         X'40' Represents an IDA list
              ..1. ....      SZRNATIV       X'20' This block is for a native
                                            SCSI I/O (FBA Emulation not used)
              ...1 ....      SZRDONE        X'10' HCPSZADN called for this
                                            block
              .... 1...      SZRNATER       X'08' Native SCSI I/O error
                                            occurred (FBA Emulation not used)
              .... .1..      SZRNPMUL       X'04' Native SCSI Paging
                                            Multi-R/W (FBA Emulation not
                                            used)
              .... ..1.      SZRADR         X'02' This block contains a ADR
                                            buffer (mutually exclusive with
                                            SZRTBUF)
              .... ...1      SZRTBUF        X'01' 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 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +---------------------------+---------------------------+
    * 158 |         SZRCPEC           |         SZRADRLN          |
    *     +---------------------------+---------------------------+
    * 160 |         SZRNXTRQ          |         SZREDEVA          |
    *     +---------------------------+---------------------------+
    *
    *** SZREQ - SCSI Strategy Call Request Block

    *** 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 00000008
    SZRBCNT        0050
    SZRBCNTH       0050
    SZRBCNTL       0054
    SZRBDONE       0007 00000002
    SZRBERR        0007 00000004
    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 00000001
    SZRBSPLT       0006 80
    SZRBUFRA       0048
    SZRBUFRH       0048
    SZRBUFRL       004C
    SZRBWRIT       0007 00000000
    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 0000000D
    SZREAGAI       006C 0000000B
    SZREBUSY       006C 00000010
    SZRECONN       006C 0000004F
    SZREDEAD       006C 00000074
    SZREDEVA       0164
    SZREEXIS       006C 00000011
    SZREFAUL       006C 0000000E
    SZREFORM       006C 00000030
    SZREINPR       006C 00000037
    SZREINVA       006C 00000016
    SZREIO         006C 00000005
    SZREMEDI       006C 0000006E
    SZRENETD       006C 00000045
    SZRENETU       006C 00000046
    SZRENOCO       006C 00000032
    SZRENODE       006C 00000013
    SZRENOEN       006C 00000002
    SZRENOLC       006C 00000031
    SZRENOME       006C 0000000C
    SZRENOTR       006C 0000002E
    SZRENXIO       006C 00000006
    SZREPERM       006C 00000001
    SZREPURG       006C 00000081
    SZREQEND       0158
    SZRERANG       006C 00000022
    SZRERROR       006C
    SZRESOFT       006C 0000006F
    SZRESTAL       006C 00000034
    SZRETIME       006C 0000004E
    SZREUNAT       006C 0000002A
    SZREWRPR       006C 0000002F
    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 V5R2.0. Last updated on 12 Apr 2006 at 17:32:11 EDT.
Copyright IBM Corporation, 1990, 2005