|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SNDBK
Control Block Contents
SNDBK DSECT
Cross Reference (Contains links to field and bit definitions)
SNDBK Prolog
NAME : HCPSNDBK
DESCRIPTION: *BLOCKIO's IUCV SEND Request Block
DSECT : SNDBK
FUNCTION : This DSECT maps data relating to a multiple
or single BLOCKIO request.
LOCATED BY : DBISNDAD in HCPDBIRQ
BLKSNDAD in HCPBLKIO
CREATED BY : HCPBIM
DELETED BY : HCPBIM
SERIALIZED : Unique task execution
VMDBK dispatch lock.
BLKIO Lock
SNDBK Control Block Content
SNDBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure SNDBK *BLOCKIO's IUCV SEND Request
Block
0000 0 Address 4 SNDNEXT Pointer to next SNDBK for this
virtual device
0004 4 Bitstring 1 SNDOPER Operation field for SEND Request
1... .... SNDMONO X'80' Indicate Single BLK SEND
REQ Protocol
.1.. .... SNDMULTI X'40' Indicate Multi BLK SEND REQ
Protocol
..1. .... SNDIWAIT X'20' Indicate waiting for I/O
interrupts
...1 .... SNDSYNC X'10' Guest is requesting syn-
chronous processing.
0005 5 Bitstring 1 SNDRC IUCV Reply Return Code
0006 6 Signed 2 SNDSSHCT Number of real SSCH issued to
handle this send request.
0008 8 Dbl-Word 8 SNDIL2IA IUCV *BLOCKIO indirect level-2
operand I-ASIT. This I-ASIT
identifies the address space
containing *BLOCKIO indirect
level-2 operands, the guest
mulit-block data buffer
addresses.
0010 16 Signed 4 SNDDVIAD Pointer to first DVIOP block for
this set of I/O requests
0014 20 Signed 4 SNDMSGID IUCV message id
0018 24 Signed 4 SNDTRGCL IUCV target class
001C 28 Signed 4 * Reserved for future IBM use
0020 32 Dbl-Word 8 SNDIL1IA IUCV *BLOCKIO indirect level-1
operand I-ASIT. This I-ASIT
identifies the address space
containing *BLOCKIO indirect
level-1 operand, the multi-block
parameter list.
0028 40 Address 4 SNDPLADR Address of the multiple block
parameter list in host real
storage
002C 44 Signed 4 SNDPLSIZ Size of the multiple block
parameter list in bytes
0030 48 Signed 2 SNDPLCNT Count of elements in the multiple
block parameter list
0032 50 Signed 2 SNDDBICT Count of DBIRQ blocks sent to
HCPIOS
0034 52 Signed 4 SNDGPLST Guest address of the multiple
block parameter list in host
0038 56 Signed 4 * Reserved for Future IBM Use
003C 60 Signed 4 * Reserved for Future IBM Use
0040 64 Dbl-Word 8 SNDSINGL Storage for a single block I/O
version of the multiple block I/O
parameter list
0048 72 Dbl-Word 8 SNDWORKA (3) Work area for HCPBIM. Since
HCPBIMIN does not have a SAVBK
available, this is to be used as
a scratch area.
0060 96 Dbl-Word 8 * (0) Ensure double word boundary
0060 96 Bitstring 40 SNDPARML IUCV reply parameter list
00000011 SNDSIZE (*-SNDBK+7)/8 Size, in
doublewords, of SNDBK
0018 24 Bitstring 1 * (3)
001B 27 Bitstring 1 SNDBLKIO Blockio service request
1... .... SNDBLKNC X'80' Bypass MDC processing
.... ..11 SNDBLKMB X'03' Multi-block request
.... ..1. SNDBLKRD X'02' Single block read
.... ...1 SNDBLKWR X'01' Single block write
SNDBLKIO SNDTCMSK X'FFFFFFFF'-(SNDBLKNC+SNDBLKMB)
Mask to test for valid data in
the IPTRGCL/SNDTRGCL fields
Remapping of the work area
Remapping for routine SCHEDULE_IO, while processing VDISK I/O.
0048 72 Signed 4 SNDTRIED For VDISK DVIOPs whose I/O must
be retried, contains the number
of I/Os already attempted.
004C 76 Bitstring 1 SNDSVVDF Byte to contain saved flag
information for VDISK I/O
processing.
1... .... SNDSVRTY X'80' DVIENTRYs must be retried.
004D 77 Bitstring 1 SNDSVRC Save the error return code for
HCPQDL until the entries whose
I/Os were successful are marked.
004E 78 Bitstring 1 * (2) Reserved for IBM use.
0050 80 Dbl-Word 8 * (2) Reserved for IBM use.
End of work area remapping
SNDBK Storage Layout
*** SNDBK - *BLOCKIO's IUCV SEND Request Block
*
* +---------------------------+------+------+-------------+
* 0 | SNDNEXT |:OPER |SNDRC | SNDSSHCT |
* +---------------------------+------+------+-------------+
* 8 | SNDIL2IA |
* +---------------------------+---------------------------+
* 10 | SNDDVIAD | SNDMSGID |
* +---------------------------+---------------------------+
* 18 | SNDTRGCL |///////////////////////////|
* +---------------------------+---------------------------+
* 20 | SNDIL1IA |
* +---------------------------+---------------------------+
* 28 | SNDPLADR | SNDPLSIZ |
* +-------------+-------------+---------------------------+
* 30 | SNDPLCNT | SNDDBICT | SNDGPLST |
* +-------------+-------------+---------------------------+
* 38 |///////////////////////////|///////////////////////////|
* +---------------------------+---------------------------+
* 40 | SNDSINGL |
* +-------------------------------------------------------+
* 48 | |
* = SNDWORKA =
* | |
* +-------------------------------------------------------+
* 60 | |
* = SNDPARML =
* | |
* +-------------------------------------------------------+
* 88
*
*** SNDBK - *BLOCKIO's IUCV SEND Request Block
*** Overlay for SNDTRGCL in SNDBK
*
* +--------------------+------+
* 18 |////////////////////|:BLKIO| 1C
* +--------------------+------+
*
*** Overlay for SNDTRGCL in SNDBK
*** Overlay for SNDWORKA in SNDBK
*
* +---------------------------+------+------+-------------+
* 48 | SNDTRIED |:SVVDF|:SVRC |/////////////|
* +---------------------------+------+------+-------------+
* 50 |///////////////////////////////////////////////////////|
* |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* 60
*
*** Overlay for SNDWORKA in SNDBK
SNDBK Cross Reference
Symbol Dspl Value -------------- ---- ----- SNDBLKIO 001B SNDBLKMB 001B 03 SNDBLKNC 001B 80 SNDBLKRD 001B 02 SNDBLKWR 001B 01 SNDDBICT 0032 SNDDVIAD 0010 SNDGPLST 0034 SNDIL1IA 0020 SNDIL2IA 0008 SNDIWAIT 0004 20 SNDMONO 0004 80 SNDMSGID 0014 SNDMULTI 0004 40 SNDNEXT 0000 SNDOPER 0004 SNDPARML 0060 SNDPLADR 0028 SNDPLCNT 0030 SNDPLSIZ 002C SNDRC 0005 SNDSINGL 0040 SNDSIZE 0060 00000011 SNDSSHCT 0006 SNDSVRC 004D SNDSVRTY 004C 80 SNDSVVDF 004C SNDSYNC 0004 10 SNDTCMSK 001B SNDBLKIO SNDTRGCL 0018 SNDTRIED 0048 SNDWORKA 0048
Copyright IBM Corporation, 1990, 2002