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 V4R1.0.
Last updated on 6 Jun 2001 at 11:12:03 EDT.
Copyright IBM Corporation, 1990, 2001