Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM. |
BELBK
Control Block Contents
BELBK DSECT
Cross Reference (Contains links to field and bit definitions)
BELBK Prolog
NAME : HCPBELBK DESCRIPTION: Block I/O entry list DSECT : BELBK FUNCTION : This DSECT maps the input parameter list sent by the guest to CP when the guest requests an I/O operation via DIAGNOSE X'250'. LOCATED BY : BRQBELBK in the BRQBK CREATED BY : HCPBIDRW (who copies the guest's parameter list into host storage) DELETED BY : HCPBIDRW, for synchronous requests HCPBIDRW. for asynchronous requests satisfied synchronously HCPBIRIN, for asynchronous requests satisfied asynchronously SERIALIZED : Instruction stream serialization COMMENTS : This parameter list may not be word-aligned in guest storage. However, this DSECT assumes that before any fields are referenced, the parameter list has been moved into host storage and word-aligned. References to fields in this block will cause an exception if this is not the case. There is one entry within the block I/O entry list for each read/write request. This control block is a GPI, and should not be changed incompatibly.
BELBK Control Block Content
BELBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure BELBK Block I/O entry list 0000 0 Signed 4 * (0) 0000 0 Bitstring 1 BELRQTYP Type of operation being .requested. 00000001 BELWRITE X'01' Write operation requested 00000002 BELREAD X'02' Read operation requested 00000000 * 00000000 * 0001 1 Bitstring 1 BELSTAT Status code for this operation 00000000 BELOK X'00' The read or write operation was successful 00000001 BELINVBK X'01' Invalid block number specified 00000002 BELADDRE X'02' Addressing exception condition 00000003 BELRODEV X'03' A write operation was requested to a read-only device 00000004 BELINVSZ X'04' Block size does not match that of the virtual device 00000005 BELIOERR X'05' Unrecoverable I/O error 00000006 BELBADRQ X'06' Request type is not read or write 00000007 BELPROTE X'07' Protection exception condition 00000008 BELADCPE X'08' Addressing-capability exception condition 00000009 BELALTRE X'09' ALEN-translation exception condition 0000000A BELALSPE X'0A' ALET-specification exception condition 0000000B BELSPECE X'0B' Specification exception condition 0000000C BELNOTPR X'0C' This block I/O entry was not processed 00000000 * 0002 2 Bitstring 2 BELRSD01 Reserved for IBM use 0004 4 Signed 4 BELBKNUM Block number 0008 8 Address 4 BELBALET ALET of guest data buffer 000C 12 Address 4 BELBUFAD Address of guest data buffer .(guest absolute address) 0010 16 Signed 4 BELNEXT (0) Start of next entry in p-list 00000002 BELSIZE (*-BELBK+7)/8 Size of one entry of the .BELBK in doublewords
BELBK Storage Layout
*** BELBK - Block I/O entry list * * +------+------+-------------+---------------------------+ * 0 |:RQTYP|:STAT | BELRSD01 | BELBKNUM | * +------+------+-------------+---------------------------+ * 8 | BELBALET | BELBUFAD | * +---------------------------+---------------------------+ * *** BELBK - Block I/O entry list
BELBK Cross Reference
Symbol Dspl Value -------------- ---- ----- * 0000 00000000 * 0000 00000000 * 0001 00000000 BELADCPE 0001 00000008 BELADDRE 0001 00000002 BELALSPE 0001 0000000A BELALTRE 0001 00000009 BELBADRQ 0001 00000006 BELBALET 0008 BELBKNUM 0004 BELBUFAD 000C BELINVBK 0001 00000001 BELINVSZ 0001 00000004 BELIOERR 0001 00000005 BELNEXT 0010 BELNOTPR 0001 0000000C BELOK 0001 00000000 BELPROTE 0001 00000007 BELREAD 0000 00000002 BELRODEV 0001 00000003 BELRQTYP 0000 BELRSD01 0002 BELSIZE 0010 00000002 BELSPECE 0001 0000000B BELSTAT 0001 BELWRITE 0000 00000001
Last updated on 5 Jun 2001 at 12:59:09 EDT.
Copyright IBM Corporation, 1990, 2001