|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
BIOPL
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
(contains links to field and bit definitions)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
Last updated on 3 Aug 1999 at 11:42:01 EDT.
Copyright IBM Corporation, 1990, 1999