BIOPL - 64-bit CP - V4R4.0

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 Signed       2 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.
    0018   24 Signed       4 BIOBLKSZ       DASD block size
    001C   28 Signed       4 BIOOFFST       Offset of the first block on
                                            minidisk
    0020   32 Signed       4 BIOSTART       Starting block number (returned
                                            by the initialize function).
    0024   36 Signed       4 BIOEND         Ending block number (returned by
                                            the initialize function).
    0028   40 Character   24 BIORSD10       Reserved for IBM use
         Mapping for the READ/WRITE function,
    0018   24 Bitstring    1 BIOKEY         Subchannel key
              1111 ....      BIOACCBT       X'F0' Mask to get just the
                                            access-control bits of the
                                            storage key.
    0019   25 Bitstring    1 BIOFLAG        Block I/O flag information
              .... ..1.      BIOASYN        X'02' Do I/O asynchronously
              .... ...1      BIOBYPAS       X'01' 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       Address of the block I/O entry
                                            list (BELBK).
    0028   40 Signed       4 BIOIPARM       External interruption parameter
                                            (for asynchronous requests).
    002C   44 Character   20 BIORSD21       Reserved for IBM use
         Mapping for the REMOVE function.
    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    |  BIORSD00   |                           |
    *     +-------------+-------------+                           |
    *     |                       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 |BIOKEY|:FLAG |  BIORSD20   |         BIOLENTN          |
    *     +------+------+-------------+---------------------------+
    *  20 |         BIOLALET          |         BIOLADDR          |
    *     +---------------------------+---------------------------+
    *  28 |         BIOIPARM          |                           |
    *     +---------------------------+                           |
    *     |                       BIORSD21                        |
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  40
    *
    *** Overlay for BIOFNDEF 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
    BIOFLAG        0019
    BIOFNDEF       0018
    BIOIPARM       0028
    BIOKEY         0018
    BIOLADDR       0024
    BIOLALET       0020
    BIOLENTN       001C
    BIOMAXCT       001C 00000100
    BIOOFFST       001C
    BIORSD00       0002
    BIORSD01       0004
    BIORSD10       0028
    BIORSD20       001A
    BIORSD21       002C
    BIORSD30       0018
    BIOSIZE        0018 00000008
    BIOSTART       0020

This information is based on z/VM V4R4.0. Last updated on 30 Jul 2003 at 12:29:47 EDT.
Copyright IBM Corporation, 1990, 2003