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