SZREQ | Back to Index page

| Prolog Control Block Contents SZREQ DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

SZREQ Prolog | Top of page

     NAME       : HCPSZREQ
     DESCRIPTION: SCSI Strategy Call Request Block
     DSECT      : SZREQ
     FUNCTION   :
     LOCATED BY :
     CREATED BY :
     DELETED BY :
     SERIALIZED :
     RELOCATION CONSIDERATIONS : None
     NOTES      :
                  This DSECT is a mapping of the blkioReq_iosct structure.
                  It must match exactly, including offsets up to SZREQEND.
                  CAUTION: The XLC 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 | Top of page

     SZREQ DSECT
    Top of page

    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 * (32)         Reserved for SCSI Container use
    0090  144 Bitstring    1 * (8)          Reserved for SCSI Container use
    0098  152 Bitstring    1 * (4)          Reserved for SCSI Container use
    009C  156 Bitstring    1 * (4)          Padding to match header compile
                 **********************************************------
                 * struct xmem definition
                 *
                 * Structure to hold virtual to real mappings
                 * for pre-translated cross memory descriptors
                 **********************************************------
    00A0  160 Bitstring   32 SZRXMEM (0)    xmem descriptor for data buffer
    00A0  160 Signed       4 SZRXASI        Address space identifier
              00FFFF9C       SZRXVMTP       -100 SZRXVMTP VM TYPE (xmem
                                            contains real addrs)
    00A4  164 Signed       4 SZRXFLG        control flags Start of imbedded
                                            V2R mapping structure (xmem_ct)
    00A8  168 Signed       4 SZRXTOT        length of RPN array (total
                                            elements)
    00AC  172 Signed       4 SZRXUSD        number of rpn elements used
    00B0  176 Dbl-Word     8 SZRXVPN        virtual page number
    00B8  184 Address      8 SZRXRPN (0)    HLA(array of real page numbers)
    00B8  184 Address      4 SZRXRPNH       High word of SZRXRPN
    00BC  188 Address      4 SZRXRPNL       Low word of SZRXRPN
    00C0  192 Bitstring    8 *              Reserved for SCSI Container use
    00C8  200 Address      8 SZRBEXT (0)    64-bit HLA(Buffer Extension) CP
                                            only uses 31-bit HLA in SZRBEXTL
    00C8  200 Address      4 SZRBEXTH       High word of SZRBEXT
    00CC  204 Address      4 SZRBEXTL       Low word of SZRBEXT
    00D0  208 Bitstring   40 *              Reserved for SCSI Container use
    00F8  248 Bitstring   16 SZRDVREF       IOSC handle for device (devref)
    0108  264 Bitstring   16 SZRPSREF       PERS handle for device
    0118  280 Bitstring   16 SZRIODON       Vector for caller's iodone
                                            routine
    0128  296 Bitstring   16 *              Workarea reserved for IOSC
    0138  312 Bitstring   16 *              Workarea reserved for PERS
    0148  328 Dbl-Word     8 SZRTODS        Container: TOD Start
    0150  336 Dbl-Word     8 SZRTODE        Container: TOD End
    0158  344 Bitstring   16 *              Reserved for SCSI Container use
          End of blkioReq_iosct structure architected for z/Series
          Portable Stack.
    0168  360 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.
    0168  360 Bitstring    4 SZRCPEC        Eye-catcher for start of CP area
    016C  364 Signed       4 SZRADRLN       DWORD length of SZRADRLT
    0170  368 Address      4 SZRNXTRQ       Copy of SZRFORWL for CP use
    0174  372 Address      4 SZREDEVA       31-bit HL EDEV address
    0178  376 Address      4 SZRADDRS (0)   Address area
          Start of remappable fields
                 **********************************************------
                 * Mapping for FBA Emulation
                 **********************************************------
    0178  376 Address      4 SZRCPSRC       31-bit HL source address of data
                                            to be copied from a temp buffer
    0180  384 Address      8 SZRCPTGT       64-bit HA target address of data
                                            to be copied from a temp buffer
    0188  392 Signed       4 SZRCPLEN       Number of bytes to be copied from
                                            SZRCPSRC to SZRCPTGT
    018C  396 Address      4 * (3)          Reserved for IBM use
                 **********************************************------
                 * Mapping for Native SCSI Paging
                 * Only valid when SZRNATIV flag set.
                 **********************************************------
    0178  376 Address      4 SZRSVRTN       31-bit HLA(SVGBK) to return to
                                            caller
    017C  380 Address      4 SZRSVPIR       31-bit HLA(PIRBK) to obtain IRA
    0180  384 Address      4 SZREXPA        31-bit HLA(EXPBK) Exposure Block
                                            addr
    0184  388 Address      4 SZRCPEA        31-bit HLA(CPEBK) to return
                                            control from the SCSI container
    0188  392 Address      4 SZRTIMER       TOD at start of I/O
    018C  396 Address      4 SZRINTIM       TOD at time of interrupt
    0190  400 Address      4 SZRNMREQ       Count of active SCSI paging
                                            requests
          End of remappable fields
    0194  404 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)
    0195  405 Bitstring    1 * (3)          RESERVED FOR FUTURE IBM USE
    0198  408 Address      8 SZRADRLT (0)   List of 64-bit HA addresses
                                            (entry 1) See SZRADRBX note
                                            below.
    0198  408 Address      4 SZRADRLH       High word of SZRADRLT
    019C  412 Address      4 SZRADRLL       Low word of SZRADRLT
    01A0  416 Character    1 SZRXTND (0)    Start of extended data
              000001A0       SZRBYSZ        *-SZREQ SZREQ byte size
              00000034       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).
    01A0  416 Address      8 SZRADRBX (0)   Entries 2 through n follow...
              000001CA       SZRADRMX       (FREMX-SZRDWSZ)+1 Max elements in
                                            ADR List for non-full page GETST
          SZREQ containing a 512 byte buffer.
    01A0  416 Bitstring    1 SZRTBUFR (512) Buffer for a single 512 byte FBA
                                            block space 1
              000003A0       SZRBFBSZ       *-SZREQ SZREQ byte size with temp
                                            buffer
              00000074       SZRBFDSZ       (*-SZREQ+7)/8 SZREQ dword size w/
                                            temp buffer

SZREQ Storage Layout | Top of page

    *** 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 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  90 |///////////////////////////////////////////////////////|
    *     +---------------------------+---------------------------+
    *  98 |///////////////////////////|///////////////////////////|
    *     +---------------------------+---------------------------+
    *  A0 |         SZRXASI           |         SZRXFLG           |
    *     +---------------------------+---------------------------+
    *  A8 |         SZRXTOT           |         SZRXUSD           |
    *     +---------------------------+---------------------------+
    *  B0 |                       SZRXVPN                         |
    *     +---------------------------+---------------------------+
    *  B8 |         SZRXRPNH          |         SZRXRPNL          |
    *     +---------------------------+---------------------------+
    *  C0 |///////////////////////////////////////////////////////|
    *     +---------------------------+---------------------------+
    *  C8 |         SZRBEXTH          |         SZRBEXTL          |
    *     +---------------------------+---------------------------+
    *  D0 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  F8 |                       SZRDVREF                        |
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 108 |                       SZRPSREF                        |
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 118 |                       SZRIODON                        |
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 128 |///////////////////////////////////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    * 138 |///////////////////////////////////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    * 148 |                       SZRTODS                         |
    *     +-------------------------------------------------------+
    * 150 |                       SZRTODE                         |
    *     +-------------------------------------------------------+
    * 158 |///////////////////////////////////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *
    *** SZREQ - SCSI Strategy Call Request Block

    *** Overlay for SZREQEND in SZREQ
    *
    *     +---------------------------+---------------------------+
    * 168 |         SZRCPEC           |         SZRADRLN          |
    *     +---------------------------+---------------------------+
    * 170 |         SZRNXTRQ          |         SZREDEVA          |
    *     +---------------------------+---------------------------+
    *
    *** Overlay for SZREQEND in SZREQ

    *** Overlay for SZRADDRS in SZREQ
    *
    *     +---------------------------+---------------------------+
    * 178 |         SZRCPSRC          |///////////////////////////|
    *     +---------------------------+---------------------------+
    * 180 |                       SZRCPTGT                        |
    *     +---------------------------+---------------------------+
    * 188 |         SZRCPLEN          |///////////////////////////|
    *     +---------------------------+///////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    * 198
    *
    *** Overlay for SZRADDRS in SZREQ

    *** Overlay for SZRADDRS in SZREQ
    *
    *     +---------------------------+---------------------------+
    * 178 |         SZRSVRTN          |         SZRSVPIR          |
    *     +---------------------------+---------------------------+
    * 180 |         SZREXPA           |         SZRCPEA           |
    *     +---------------------------+---------------------------+
    * 188 |         SZRTIMER          |         SZRINTIM          |
    *     +---------------------------+------+--------------------+
    * 190 |         SZRNMREQ          |:CPFLG|////////////////////|
    *     +---------------------------+------+--------------------+
    * 198 |         SZRADRLH          |         SZRADRLL          |
    *     +---------------------------+---------------------------+
    *
    *** Overlay for SZRADDRS in SZREQ

    *** Overlay for SZRXTND in SZREQ
    *
    *
    *** Overlay for SZRXTND in SZREQ

    *** Overlay for SZRXTND in SZREQ
    *
    *     +-------------------------------------------------------+
    * 1A0 |                                                       |
    *     =                       SZRTBUFR                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 3A0
    *
    *** Overlay for SZRXTND in SZREQ

SZREQ Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    SZRADDRS       0178
    SZRADR         0194 02
    SZRADRBX       01A0
    SZRADRLH       0198
    SZRADRLL       019C
    SZRADRLN       016C
    SZRADRLT       0198
    SZRADRMX       01A0 000001CA
    SZRBASYN       0006 01
    SZRBBUSY       0007 08
    SZRBCNT        0050
    SZRBCNTH       0050
    SZRBCNTL       0054
    SZRBDONE       0007 02
    SZRBERR        0007 04
    SZRBEXT        00C8
    SZRBEXTH       00C8
    SZRBEXTL       00CC
    SZRBFBSZ       01A0 000003A0
    SZRBFDSZ       01A0 00000074
    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        01A0 000001A0
    SZRCONTG       0194 80
    SZRCPEA        0184
    SZRCPEC        0168
    SZRCPFLG       0194
    SZRCPLEN       0188
    SZRCPSRC       0178
    SZRCPTGT       0180
    SZRDONE        0194 10
    SZRDVREF       00F8
    SZRDWSZ        01A0 00000034
    SZREACCE       006C 0D
    SZREAGAI       006C 0B
    SZREBUSY       006C 10
    SZRECONN       006C 4F
    SZREDEAD       006C 74
    SZREDEVA       0174
    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       0168
    SZRERANG       006C 22
    SZRERROR       006C
    SZRESOFT       006C 6F
    SZRESTAL       006C 34
    SZRETIME       006C 4E
    SZREUNAT       006C 2A
    SZREWRPR       006C 2F
    SZREXPA        0180
    SZRFLGEX       0006
    SZRFLGST       0007
    SZRFLGU        0000
    SZRFORW        0018
    SZRFORWH       0018
    SZRFORWL       001C
    SZRIDA         0194 40
    SZRINTIM       018C
    SZRIODON       0118
    SZRNATER       0194 08
    SZRNATIV       0194 20
    SZRNMREQ       0190
    SZRNPMUL       0194 04
    SZRNXTRQ       0170
    SZRPSREF       0108
    SZRRESID       0058
    SZRRSIDH       0058
    SZRRSIDL       005C
    SZRSVPIR       017C
    SZRSVRTN       0178
    SZRTBUF        0194 01
    SZRTBUFR       01A0
    SZRTIMER       0188
    SZRTODE        0150
    SZRTODS        0148
    SZRXASI        00A0
    SZRXFLG        00A4
    SZRXMEM        00A0
    SZRXRPN        00B8
    SZRXRPNH       00B8
    SZRXRPNL       00BC
    SZRXTND        01A0
    SZRXTOT        00A8
    SZRXUSD        00AC
    SZRXVMTP       00A0 00FFFF9C
    SZRXVPN        00B0

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:31:09 EDT.
Copyright IBM Corporation, 1990, 2020