|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
BIOPL
Control Block Contents
BIOPL DSECT
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
Copyright IBM Corporation, 1990, 2008