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

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

This information is based on z/VM V3R1.0.
Last updated on 29 Mar 2001 at 16:39:45 EDT.
Copyright IBM Corporation, 1990, 2001