Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SZREQ
Control Block Contents
SZREQ DSECT
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
Copyright IBM Corporation, 1990, 2008