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
 RELOCATION CONSIDERATIONS : None
 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 DSECT
Top of page

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 - 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

 
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