Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

SNDBK

Prolog  

Control Block Contents  
   SNDBK DSECT

Storage Layout  

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
 RELOCATION CONSIDERATIONS : None

 

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' SNDMONO Indicate Single BLK
                                        SEND REQ Protocol
          .1.. ....      SNDMULTI       X'40' SNDMULTI Indicate Multi BLK
                                        SEND REQ Protocol
          ..1. ....      SNDIWAIT       X'20' SNDIWAIT Indicate waiting
                                        for I/O interrupts
          ...1 ....      SNDSYNC        X'10' SNDSYNC 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' SNDBLKNC Bypass MDC
                                        processing
          .... ..11      SNDBLKMB       X'03' SNDBLKMB Multi-block
                                        request
          .... ..1.      SNDBLKRD       X'02' SNDBLKRD Single block read
          .... ...1      SNDBLKWR       X'01' SNDBLKWR Single block write
          SNDBLKIO       SNDTCMSK       X'FFFFFFFF'-(SNDBLKNC+SNDBLKMB)
                                        SNDTCMSK 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' SNDSVRTY 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

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:21:39 EDT.
Copyright IBM Corporation, 1990, 2011