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.3.0 Last updated on 22 Jun 2022 at 15:56:54 EDT.
Copyright IBM Corporation, 1990, 2022