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

#### SBIOP

Prolog

Control Block Contents
SBIOP DSECT
SBILIST DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SBIOP Prolog

     NAME       : HCPSBIOP
     DESCRIPTION: Synchronous Block I/O Parameter
     DSECT      : SBIOP
     FUNCTION   : Describe the parameters of a Diagnose 'A4' request
     LOCATED BY : The "X" register contains the logical address of
                  the SBIOP in Guest storage at the time Diagnose 'A4'
                  is issued.
     CREATED BY : The program issuing Diagnose 'A4'.
     DELETED BY : N/A
     COMMENTS   : None

#### SBIOP Control Block Content

#### SBIOP DSECT

####

####

####

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SBIOP          Synchronous Block I/O Parameter
    0000    0 Signed       2 SBIRESET (0)   Dummy name at offset 0 for
                                            DATAMAP
    0000    0 Signed       2 SBIDEVNO       The virtual device number of the
                                            DASD to be used.
    0002    2 Bitstring    1 SBIKEY         The Storage Protection Key to use
                                            for I/O operations with this
                                            request.
    0003    3 Bitstring    1 SBICODE        Type of Request.
              00000001       SBIWRITE       X'01' SBIWRITE Write data from
                                            storage to DASD.
              00000002       SBIREAD        X'02' SBIREAD Read data from DASD
                                            to storage.
              00000004       SBIFORMT       X'04' SBIFORMT Format SCSI DASD
    0004    4 Signed       4 SBIBLKSZ       Size of physical records on DASD
                                            for this request.
    0008    8 Signed       2 SBIFRMAT (0)   Dummy name use by format ORG
    0008    8 Address      4 SBILSTAD       Address of list of block number /
                                            data address pairs for this
                                            request. See SBILIST, below.
    000C   12 Signed       4 SBILSTCT       The number of pairs in list at
                                            SBILSTAD. Provided by the issuer
                                            of the diagnose.
              000001F4       SBILSTMX       500 Maximum number of blocks that
                                            may be processed in one READ or
                                            WRITE operation.
    0010   16 Signed       4 SBIBLKCT       The number of blocks processed by
                                            CP.
    0014   20 Bitstring    1 SBIDEVST       Device status byte, returned by
                                            CP.
    0015   21 Bitstring    1 SBISCHST       The subchannel status byte,
                                            returned by CP
    0016   22 Signed       2 SBIRESCT       The residual count, returned by
                                            CP.
    0018   24 Bitstring    1 SBILPM         Path I/O will be issued down
    0019   25 Bitstring    1 SBIRESV0 (3)   Reserved for future IBM use.
    001C   28 Signed       2 SBIRESVD       Reserved for future IBM use.
    001E   30 Signed       2 SBISNSCT       The amount of sense data present.
    0020   32 Bitstring   24 SBIRESV1       Reserved for IBM future use
    0038   56 Bitstring   32 SBISDATA       The sense data (only if unit
                                            check is on in SBIDEVST)
              00000058       SBIBYLEN       *-SBIOP Length (in bytes) of
                                            SBIOP
              0000000B       SBIDWSIZ       (SBIBYLEN+7)/8 Size of SBIOP in
                                            doublewords.
    0008    8 Bitstring    3 *
    000B   11 Bitstring    1 SBILSTA3       Right-most byte for alignment
                                            test
          The following ORG is for use by SBICODE = FORMAT.
    0008    8 Dbl-Word     8 SBILBA         Logical block address to start
                                            the format on
    0010   16 Dbl-Word     8 SBIFBLKS       Number of blocks to format (zero
                                            means format to end of device)
    0018   24 Address      8 SBIFDATA       Pointer to a 512 byte block of
                                            data to use for formatting (zero
                                            means format with zeros)
    0020   32 Dbl-Word     8 SBIDIDBK       Number of blocks which will be
                                            formatted when SBIFBLKS is zero
                                            (minidisk size)
    0028   40 Signed       4 SBIFRETC       IBM service diagnostic rc
    002C   44 Signed       4 SBIFREAC       IBM service diagnostic reason
    0030   48 Signed       4 SBIFEID        IBM service diagnostic errid
    0034   52 Bitstring   36 SBIFRSVD       Reserved for future IBM use
          The following ORG is to reset LOCTR to zero for DATAMAP.
          SBILIST is not a redefinition of any part of SBIOP, but
          the mapping of the data pointed to by SBILSTAD.

    SBILIST DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SBILIST        Synchronous Block I/O Parameter
    0000    0 Dbl-Word     8 SBILNTRY (0)   A list entry is two words long
    0000    0 Signed       4 SBILBKNO       The block number of data on DASD
                                            ( zero - origin )
    0004    4 Address      4 SBILBFAD       The absolute address of data in
                                            guest machine storage.
    0008    8 Bitstring    8 SBILNEXT (0)   The next list entry starts
                                            here...

    SBIOP Storage Layout

    *** SBIOP - Synchronous Block I/O Parameter
    *
    *     +-------------+------+------+---------------------------+
    *   0 |  SBIDEVNO   |SBIKEY|:CODE |         SBIBLKSZ          |
    *     +-------------+------+------+---------------------------+
    *   8 |         SBILSTAD          |         SBILSTCT          |
    *     +---------------------------+------+------+-------------+
    *  10 |         SBIBLKCT          |:DEVST|:SCHST|  SBIRESCT   |
    *     +------+--------------------+------+------+-------------+
    *  18 |SBILPM|     SBIRESV0       |  SBIRESVD   |  SBISNSCT   |
    *     +------+--------------------+-------------+-------------+
    *  20 |                                                       |
    *     =                       SBIRESV1                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  38 |                                                       |
    *     =                       SBISDATA                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  58
    *
    *** SBIOP - Synchronous Block I/O Parameter

    *** Overlay for SBILSTAD in SBIOP
    *
    *     +--------------------+------+
    *   8 |////////////////////|:LSTA3| C
    *     +--------------------+------+
    *
    *** Overlay for SBILSTAD in SBIOP

    *** Overlay for SBIFRMAT in SBIOP
    *
    *     +-------------------------------------------------------+
    *   8 |                        SBILBA                         |
    *     +-------------------------------------------------------+
    *  10 |                       SBIFBLKS                        |
    *     +-------------------------------------------------------+
    *  18 |                       SBIFDATA                        |
    *     +-------------------------------------------------------+
    *  20 |                       SBIDIDBK                        |
    *     +---------------------------+---------------------------+
    *  28 |         SBIFRETC          |         SBIFREAC          |
    *     +---------------------------+---------------------------+
    *  30 |         SBIFEID           |                           |
    *     +---------------------------+                           |
    *  38 |                                                       |
    *     =                       SBIFRSVD                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  58
    *
    *** Overlay for SBIFRMAT in SBIOP

    *** SBILIST - Synchronous Block I/O Parameter
    *
    *     +---------------------------+---------------------------+
    *   0 |         SBILBKNO          |         SBILBFAD          |
    *     +---------------------------+---------------------------+
    *
    *** SBILIST - Synchronous Block I/O Parameter

    SBIOP Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    SBIBLKCT       0010
    SBIBLKSZ       0004
    SBIBYLEN       0038 00000058
    SBICODE        0003
    SBIDEVNO       0000
    SBIDEVST       0014
    SBIDIDBK       0020
    SBIDWSIZ       0038 0000000B
    SBIFBLKS       0010
    SBIFDATA       0018
    SBIFEID        0030
    SBIFORMT       0003 00000004
    SBIFREAC       002C
    SBIFRETC       0028
    SBIFRMAT       0008
    SBIFRSVD       0034
    SBIKEY         0002
    SBILBA         0008
    SBILBFAD       0004
    SBILBKNO       0000
    SBILNEXT       0008
    SBILNTRY       0000
    SBILPM         0018
    SBILSTAD       0008
    SBILSTA3       000B
    SBILSTCT       000C
    SBILSTMX       000C 000001F4
    SBIREAD        0003 00000002
    SBIRESCT       0016
    SBIRESET       0000
    SBIRESVD       001C
    SBIRESV0       0019
    SBIRESV1       0020
    SBISCHST       0015
    SBISDATA       0038
    SBISNSCT       001E
    SBIWRITE       0003 00000001

    This information is
    based on z/VM V6R1.0.
    Last updated on 18 Feb 2010 at 09:02:42 EDT.

    Copyright IBM Corporation, 1990, 2008