|
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
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
Copyright IBM Corporation, 1990, 2005