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

#### BIOPL

Prolog

Control Block Contents
BIOPL DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### BIOPL Prolog

     NAME       : HCPBIOPL
     DESCRIPTION: Block I/O Parameter List
     DSECT      : BIOPL
     FUNCTION   : This DSECT maps data representing details of
                  a service requested of the Diagnose X'250'
                  processor.
     LOCATED BY : The Rx register contains the address of the
                  BIOPL in guest storage at the time the
                  DIAGNOSE X'250' is issued.  If this is an XC
                  guest executing in host-access-register mode,
                  then the Ax register identifies the address
                  space containing the BIOPL.
     CREATED BY : HCPBID25
     DELETED BY : HCPBID25
     SERIALIZED : Instruction stream serialization
     COMMENTS   : This control block is used to map the
                  parameter list for each function code of
                  DIAGNOSE X'250'. Since each has its own
                  requirements, with only the device number
                  in common, redefinitions are done, one per
                  function code.
                  NOTES      : when adding fields to this control
                  block, the following conventions should be
                  followed:
                  - Fields common to all function codes should
                  be added BEFORE field BIOFNDEF.
                  - Fields specific to a function code should
                  be added to the areas that remap BIOFNDEF.
                  - If it is necessary to expand the size of
                  one of the function-code-specific
                  sections, all must be expanded and the
                  explicitly coded length on the BIOFNDEF
                  field must be changed.
                  This control block is a GPI, and should
                  not be changed incompatibly.

#### BIOPL Control Block Content

#### BIOPL DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      BIOPL          Block I/O Parameter List
    0000    0 Dbl-Word     8 * (0)          Specify doubleword boundary
    0000    0 Signed       2 BIODEVN        Virtual device number
    0002    2 Bitstring    1 BIOFLAGA       Block I/O common flag
              1... ....      BIO64BIT       X'80' BIO64BIT Using 64 bit
                                            fields in the BIOPL and the
                                            BELBK.
              .111 1111      BIOFANOT       X'FF'-BIO64BIT BIOFANOT Flag A
                                            NOT defined.
    0003    3 Character    1 BIORSD00       Reserved for IBM use
    0004    4 Character   20 BIORSD01       Reserved for IBM use
    0018   24 Character   40 BIOFNDEF       Start of area redefined for each
                                            function code.
            Mapping for the INITIALIZATION
            function when BIO64BIT is zero.
    0018   24 Signed       4 BIOBLKSZ       DASD block size
    001C   28 Signed       4 BIOOFFST       32 bit offset of the first block
                                            on the minidisk.
    0020   32 Signed       4 BIOSTART       32 bit starting block number
                                            (returned by the initialization
                                            function.)
    0024   36 Signed       4 BIOEND         32 bit ending block number
                                            (returned by the initialization
                                            function.)
    0028   40 Character   24 BIORSD10       Reserved for IBM use
            Mapping for the INITIALIZATION
            function when BIO64BIT is one.
    0018   24 Signed       4 *              BIOBLKSZ DASD block size
    001C   28 Character    4 BIORSD13       Reserved for IBM use.
    0020   32 Dbl-Word     8 BIOOFFST64     64 bit offset of the first block
                                            on the minidisk.
    0028   40 Dbl-Word     8 BIOSTART64     64 bit starting block number
                                            (returned by the initialization
                                            function.)
    0030   48 Dbl-Word     8 BIOEND64       64 bit ending block number
                                            (returned by the initialization
                                            function.)
    0038   56 Character    8 BIORSD16       Reserved for IBM use
            Mapping for the READ/WRITE function
            when BIO64BIT is zero.
    0018   24 Bitstring    1 BIOKEY         Subchannel key
              1111 ....      BIOACCBT       X'F0' BIOACCBT Mask to get just
                                            the access-control bits of the
                                            storage key.
    0019   25 Bitstring    1 BIOFLAG        Block I/O flag information
              1111 11..      BIOFNOT        X'FF'-BIOASYN-BIOBYPAS BIOFNOT
                                            Bits not defined in FLAG.
              .... ..1.      BIOASYN        X'02' BIOASYN Do I/O
                                            asynchronously
              .... ...1      BIOBYPAS       X'01' BIOBYPAS Bypass minidisk
                                            cache
    001A   26 Signed       2 BIORSD20       Reserved for IBM use
    001C   28 Signed       4 BIOLENTN       Number of entries in the block
                                            I/O entry list block (BELBK).
              00000100       BIOMAXCT       256 Maximum number of BELBK
                                            entries in a request.
    0020   32 Signed       4 BIOLALET       Access list entry token (ALET)
                                            identifying the address space
                                            containing the block I/O entry
                                            list.
    0024   36 Address      4 BIOLADDR       31 bit guest real address of the
                                            block I/O entry list. (BELBK).
    0028   40 Signed       4 BIOIPARM       32 bit external interruption
                                            parameter (for asynchronous
                                            requests).
    002C   44 Character   20 BIORSD21       Reserved for IBM use
            Mapping for the READ/WRITE function
            when BIO64BIT is one.
            The difference begins after BIOLALET.  Comments are for
            documenting common names of fields.
         BIORSD20  DS    H                Reserved for IBM use
         BIOLENTN  DS    F                Number of entries in the
                                           block I/O entry list
                                           block (BELBK).
                                           entries in a request.
         BIOLALET  DS    F                Access list entry token
                                           (ALET) identifying the
                                           address space containing
                                           the block I/O entry list.
    0024   36 Character    4 BIORSD24       Reserved for IBM use.
    0028   40 Dbl-Word     8 BIOIPARM64     64 bit external interruption
                                            parameter (for asynchronous
                                            requests).
    0030   48 Address      8 BIOLADDR64     64 bit guest real address of the
                                            block I/O entry list. (BELBK).
    0038   56 Character    8 BIORSD27       Reserved for IBM use
            Mapping for the REMOVE function,
            does not depend on BIO64BIT
    0018   24 Character   40 BIORSD30       Reserved for IBM use
            Length of the block.
              00000008       BIOSIZE        (*+7-BIOPL)/8 BIOPL size in
                                            double words
              00000040       BIOBSIZE       *-BIOPL BIOPL size in bytes

#### BIOPL Storage Layout

    *** BIOPL - Block I/O Parameter List
    *
    *     +-------------+------+------+---------------------------+
    *   0 |  BIODEVN    |:FLAGA|:RSD00|                           |
    *     +-------------+------+------+                           |
    *     |                       BIORSD01                        |
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  18 |                                                       |
    *     =                       BIOFNDEF                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  40
    *
    *** BIOPL - Block I/O Parameter List

    *** Overlay for BIOFNDEF in BIOPL
    *
    *     +---------------------------+---------------------------+
    *  18 |         BIOBLKSZ          |         BIOOFFST          |
    *     +---------------------------+---------------------------+
    *  20 |         BIOSTART          |          BIOEND           |
    *     +---------------------------+---------------------------+
    *  28 |                                                       |
    *     =                       BIORSD10                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  40
    *
    *** Overlay for BIOFNDEF in BIOPL

    *** Overlay for BIOFNDEF in BIOPL
    *
    *     +---------------------------+---------------------------+
    *  18 |///////////////////////////|         BIORSD13          |
    *     +---------------------------+---------------------------+
    *  20 |                      BIOOFFST64                       |
    *     +-------------------------------------------------------+
    *  28 |                      BIOSTART64                       |
    *     +-------------------------------------------------------+
    *  30 |                       BIOEND64                        |
    *     +-------------------------------------------------------+
    *  38 |                       BIORSD16                        |
    *     +-------------------------------------------------------+
    *  40
    *
    *** Overlay for BIOFNDEF in BIOPL

    *** Overlay for BIOFNDEF in BIOPL
    *
    *     +------+------+-------------+---------------------------+
    *  18 |BIOKEY|:FLAG |  BIORSD20   |         BIOLENTN          |
    *     +------+------+-------------+---------------------------+
    *  20 |         BIOLALET          |         BIOLADDR          |
    *     +---------------------------+---------------------------+
    *  28 |         BIOIPARM          |                           |
    *     +---------------------------+                           |
    *     |                       BIORSD21                        |
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  40
    *
    *** Overlay for BIOFNDEF in BIOPL

    *** Overlay for BIOFNDEF+12 in BIOPL
    *
    *                                 +---------------------------+
    *  20 ...                      24 |         BIORSD24          |
    *     +---------------------------+---------------------------+
    *  28 |                      BIOIPARM64                       |
    *     +-------------------------------------------------------+
    *  30 |                      BIOLADDR64                       |
    *     +-------------------------------------------------------+
    *  38 |                       BIORSD27                        |
    *     +-------------------------------------------------------+
    *  40
    *
    *** Overlay for BIOFNDEF+12 in BIOPL

    *** Overlay for BIOFNDEF in BIOPL
    *
    *     +-------------------------------------------------------+
    *  18 |                                                       |
    *     =                       BIORSD30                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  40
    *
    *** Overlay for BIOFNDEF in BIOPL

#### BIOPL Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    BIOACCBT       0018 F0
    BIOASYN        0019 02
    BIOBLKSZ       0018
    BIOBSIZE       0018 00000040
    BIOBYPAS       0019 01
    BIODEVN        0000
    BIOEND         0024
    BIOEND64       0030
    BIOFANOT       0002 7F
    BIOFLAG        0019
    BIOFLAGA       0002
    BIOFNDEF       0018
    BIOFNOT        0019 FC
    BIOIPARM       0028
    BIOIPARM64     0028
    BIOKEY         0018
    BIOLADDR       0024
    BIOLADDR64     0030
    BIOLALET       0020
    BIOLENTN       001C
    BIOMAXCT       001C 00000100
    BIOOFFST       001C
    BIOOFFST64     0020
    BIORSD00       0003
    BIORSD01       0004
    BIORSD10       0028
    BIORSD13       001C
    BIORSD16       0038
    BIORSD20       001A
    BIORSD21       002C
    BIORSD24       0024
    BIORSD27       0038
    BIORSD30       0018
    BIOSIZE        0018 00000008
    BIOSTART       0020
    BIOSTART64     0028
    BIO64BIT       0002 80

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:26:50 EDT.
Copyright IBM Corporation, 1990, 2008