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' 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 .... .... SZRBWRIT X'00' Non-read flag .... ...1 SZRBREAD X'01' Read when I/O occurs .... ..1. SZRBDONE X'02' I/O complete .... .1.. SZRBERR X'04' Error detected .... 1... 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 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 Address 8 * Reserved for SCSI Container use 00B8 184 Bitstring 16 SZRPRTI primary resource tracking identifier 00C8 200 Bitstring 16 SZRSRTI secondary resource tracking ID 00D8 216 Bitstring 16 SZRUTKN user provided purge token 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 Signed 2 SZREQEND (0) End of architected request block End of block architected for z/Series Portable I/O Stack. Remaining data is for CP use only. 0138 312 Signed 2 SZREQCP (0) Beginning of CP USE ONLY data areas 0138 312 Bitstring 4 SZRCPEC Eye-catcher for start of CP area 013C 316 Address 4 SZRNXTRQ Copy of SZRFORWL for CP use 0140 320 Address 4 SZREDEVA 31-bit HL EDEV address 0144 324 Address 4 SZRCPSRC 31-bit HL source address of data to be copied from a temp buffer 0148 328 Address 8 SZRCPTGT 64-bit HA target address of data to be copied from a temp buffer 0150 336 Signed 4 SZRCPLEN Number of bytes to be copied from SZRCPSRC to SZRCPTGT 0154 340 Bitstring 1 SZRCPFLG Status flags 1... .... SZRCONTG X'80' Indicates target address is contiguous with previous request. ...1 .... SZRDONE X'10' HCPSZADN called for this block .... ...1 SZRTBUF X'01' This block contains a temp buffer (mutually exclusive with SZRDAT) .... ..1. SZRDAT X'02' This block contains a DAT buffer (mutually exclusive with SZRTBUF) 0155 341 Bitstring 1 * (3) RESERVED FOR FUTURE IBM USE 0158 344 Address 8 SZRDATBL (0) Table of 64-bit HA addresses (entry 1) See SZRDATBX note below. 0158 344 Address 4 SZRDTBLH High word of SZRDATBL 015C 348 Address 4 SZRDTBLL Low word of SZRDATBL 0160 352 Character 1 SZRXTND (0) Start of extended data 00000160 SZRBYSZ *-SZREQ SZREQ byte size 0000002C SZRDWSZ (*-SZREQ+7)/8 SZREQ doubleword size SZREQ containing a DAT table with more than 1 entry. NOTES : The DAT table extension MUST immediately follow SZRDATBL. 0160 352 Dbl-Word 8 SZRDATBX (11) DAT table extension (entries 2 to SZRDATLN-1) 0000000C SZRDATLN 12 Max elements in DAT table (max pages QDIO can handle per I/O) 000001B8 SZRDTBSZ *-SZREQ SZREQ byte size with DAT table 00000037 SZRDTDSZ (*-SZREQ+7)/8 SZREQ dword size w/ DAT table SZREQ containing a 512 byte buffer. 0160 352 Bitstring 1 SZRTBUFR (512) Buffer for a single 512 byte FBA block space 1 00000360 SZRBFBSZ *-SZREQ SZREQ byte size with temp buffer 0000006C 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 | SZRPRTI | * | | * +-------------------------------------------------------+ * C8 | SZRSRTI | * | | * +-------------------------------------------------------+ * D8 | SZRUTKN | * | | * +-------------------------------------------------------+ * E8 | SZRDVREF | * | | * +-------------------------------------------------------+ * F8 | SZRPSREF | * | | * +-------------------------------------------------------+ * 108 | SZRIODON | * | | * +-------------------------------------------------------+ * 118 |///////////////////////////////////////////////////////| * |///////////////////////////////////////////////////////| * +-------------------------------------------------------+ * 128 |///////////////////////////////////////////////////////| * |///////////////////////////////////////////////////////| * +---------------------------+---------------------------+ * 138 | SZRCPEC | SZRNXTRQ | * +---------------------------+---------------------------+ * 140 | SZREDEVA | SZRCPSRC | * +---------------------------+---------------------------+ * 148 | SZRCPTGT | * +---------------------------+------+--------------------+ * 150 | SZRCPLEN |:CPFLG|////////////////////| * +---------------------------+------+--------------------+ * 158 | SZRDTBLH | SZRDTBLL | * +---------------------------+---------------------------+ * *** SZREQ - SCSI Strategy Call Request Block *** Overlay for SZRXTND in SZREQ * * +-------------------------------------------------------+ * 160 | | * = SZRDATBX = * | | * +-------------------------------------------------------+ * 1B8 * *** Overlay for SZRXTND in SZREQ *** Overlay for SZRXTND in SZREQ * * +-------------------------------------------------------+ * 160 | | * = SZRTBUFR = * | | * +-------------------------------------------------------+ * 360 * *** Overlay for SZRXTND in SZREQ
SZREQ Cross Reference
Symbol Dspl Value -------------- ---- ----- SZRBASYN 0006 01 SZRBBUSY 0007 08 SZRBCNT 0050 SZRBCNTH 0050 SZRBCNTL 0054 SZRBDONE 0007 02 SZRBERR 0007 04 SZRBFBSZ 0160 00000360 SZRBFDSZ 0160 0000006C 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 0160 00000160 SZRCONTG 0154 80 SZRCPEC 0138 SZRCPFLG 0154 SZRCPLEN 0150 SZRCPSRC 0144 SZRCPTGT 0148 SZRDAT 0154 02 SZRDATBL 0158 SZRDATBX 0160 SZRDATLN 0160 0000000C SZRDONE 0154 10 SZRDTBLH 0158 SZRDTBLL 015C SZRDTBSZ 0160 000001B8 SZRDTDSZ 0160 00000037 SZRDVREF 00E8 SZRDWSZ 0160 0000002C SZREACCE 006C 0000000D SZREAGAI 006C 0000000B SZREBUSY 006C 00000010 SZRECONN 006C 0000004F SZREDEVA 0140 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 SZREQCP 0138 SZREQEND 0138 SZRERANG 006C 00000022 SZRERROR 006C SZRESOFT 006C 0000006F SZRESTAL 006C 00000034 SZRETIME 006C 0000004E SZREUNAT 006C 0000002A SZREWRPR 006C 0000002F SZRFLGEX 0006 SZRFLGST 0007 SZRFLGU 0000 SZRFORW 0018 SZRFORWH 0018 SZRFORWL 001C SZRIODON 0108 SZRNXTRQ 013C SZRPRTI 00B8 SZRPSREF 00F8 SZRRESID 0058 SZRRSIDH 0058 SZRRSIDL 005C SZRSRTI 00C8 SZRTBUF 0154 01 SZRTBUFR 0160 SZRUTKN 00D8 SZRXASI 0090 SZRXFLG 0094 SZRXMEM 0090 SZRXRPN 00A8 SZRXRPNH 00A8 SZRXRPNL 00AC SZRXTND 0160 SZRXTOT 0098 SZRXUSD 009C SZRXVMTP 0090 00FFFF9C SZRXVPN 00A0
Copyright IBM Corporation, 1990, 2004