BIOPL Back to Index page
 
Prolog 
Control Block Contents 
   BIOPL DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  BIOPL Prolog Top of page
 
 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 Control Block Content Top of page
 

 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 Storage Layout Top of page
 
          
*** 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 Top of page
 
 
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 7.3.0 Last updated on 22 Jun 2022 at 15:47:39 EDT.
Copyright IBM Corporation, 1990, 2022