Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SBIOP
Control Block Contents
SBIOP DSECT
SBILIST DSECT
Cross Reference (Contains links to field and bit definitions)
SBIOP Prolog
NAME : HCPSBIOP DESCRIPTION: Synchronous Block I/O Parameter DSECT : SBIOP FUNCTION : Describe the parameters of a Diagnose 'A4' request LOCATED BY : The "X" register contains the logical address of the SBIOP in Guest storage at the time Diagnose 'A4' is issued. CREATED BY : The program issuing Diagnose 'A4'. DELETED BY : N/A COMMENTS : None
SBIOP Control Block Content
SBIOP DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure SBIOP Synchronous Block I/O Parameter 0000 0 Signed 2 SBIRESET (0) Dummy name at offset 0 for DATAMAP 0000 0 Signed 2 SBIDEVNO The virtual device number of the DASD to be used. 0002 2 Bitstring 1 SBIKEY The Storage Protection Key to use for I/O operations with this request. 0003 3 Bitstring 1 SBICODE Type of Request. 00000001 SBIWRITE X'01' SBIWRITE Write data from storage to DASD. 00000002 SBIREAD X'02' SBIREAD Read data from DASD to storage. 00000004 SBIFORMT X'04' SBIFORMT Format SCSI DASD 0004 4 Signed 4 SBIBLKSZ Size of physical records on DASD for this request. 0008 8 Signed 2 SBIFRMAT (0) Dummy name use by format ORG 0008 8 Address 4 SBILSTAD Address of list of block number / data address pairs for this request. See SBILIST, below. 000C 12 Signed 4 SBILSTCT The number of pairs in list at SBILSTAD. Provided by the issuer of the diagnose. 000001F4 SBILSTMX 500 Maximum number of blocks that may be processed in one READ or WRITE operation. 0010 16 Signed 4 SBIBLKCT The number of blocks processed by CP. 0014 20 Bitstring 1 SBIDEVST Device status byte, returned by CP. 0015 21 Bitstring 1 SBISCHST The subchannel status byte, returned by CP 0016 22 Signed 2 SBIRESCT The residual count, returned by CP. 0018 24 Bitstring 1 SBILPM Path I/O will be issued down 0019 25 Bitstring 1 SBIRESV0 (3) Reserved for future IBM use. 001C 28 Signed 2 SBIRESVD Reserved for future IBM use. 001E 30 Signed 2 SBISNSCT The amount of sense data present. 0020 32 Bitstring 24 SBIRESV1 Reserved for IBM future use 0038 56 Bitstring 32 SBISDATA The sense data (only if unit check is on in SBIDEVST) 00000058 SBIBYLEN *-SBIOP Length (in bytes) of SBIOP 0000000B SBIDWSIZ (SBIBYLEN+7)/8 Size of SBIOP in doublewords. 0008 8 Bitstring 3 * 000B 11 Bitstring 1 SBILSTA3 Right-most byte for alignment test The following ORG is for use by SBICODE = FORMAT. 0008 8 Dbl-Word 8 SBILBA Logical block address to start the format on 0010 16 Dbl-Word 8 SBIFBLKS Number of blocks to format (zero means format to end of device) 0018 24 Address 8 SBIFDATA Pointer to a 512 byte block of data to use for formatting (zero means format with zeros) 0020 32 Dbl-Word 8 SBIDIDBK Number of blocks which will be formatted when SBIFBLKS is zero (minidisk size) 0028 40 Signed 4 SBIFRETC IBM service diagnostic rc 002C 44 Signed 4 SBIFREAC IBM service diagnostic reason 0030 48 Signed 4 SBIFEID IBM service diagnostic errid 0034 52 Bitstring 36 SBIFRSVD Reserved for future IBM use The following ORG is to reset LOCTR to zero for DATAMAP. SBILIST is not a redefinition of any part of SBIOP, but the mapping of the data pointed to by SBILSTAD.
SBILIST DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure SBILIST Synchronous Block I/O Parameter 0000 0 Dbl-Word 8 SBILNTRY (0) A list entry is two words long 0000 0 Signed 4 SBILBKNO The block number of data on DASD ( zero - origin ) 0004 4 Address 4 SBILBFAD The absolute address of data in guest machine storage. 0008 8 Bitstring 8 SBILNEXT (0) The next list entry starts here...
SBIOP Storage Layout
*** SBIOP - Synchronous Block I/O Parameter * * +-------------+------+------+---------------------------+ * 0 | SBIDEVNO |SBIKEY|:CODE | SBIBLKSZ | * +-------------+------+------+---------------------------+ * 8 | SBILSTAD | SBILSTCT | * +---------------------------+------+------+-------------+ * 10 | SBIBLKCT |:DEVST|:SCHST| SBIRESCT | * +------+--------------------+------+------+-------------+ * 18 |SBILPM| SBIRESV0 | SBIRESVD | SBISNSCT | * +------+--------------------+-------------+-------------+ * 20 | | * = SBIRESV1 = * | | * +-------------------------------------------------------+ * 38 | | * = SBISDATA = * | | * +-------------------------------------------------------+ * 58 * *** SBIOP - Synchronous Block I/O Parameter *** Overlay for SBILSTAD in SBIOP * * +--------------------+------+ * 8 |////////////////////|:LSTA3| C * +--------------------+------+ * *** Overlay for SBILSTAD in SBIOP *** Overlay for SBIFRMAT in SBIOP * * +-------------------------------------------------------+ * 8 | SBILBA | * +-------------------------------------------------------+ * 10 | SBIFBLKS | * +-------------------------------------------------------+ * 18 | SBIFDATA | * +-------------------------------------------------------+ * 20 | SBIDIDBK | * +---------------------------+---------------------------+ * 28 | SBIFRETC | SBIFREAC | * +---------------------------+---------------------------+ * 30 | SBIFEID | | * +---------------------------+ | * 38 | | * = SBIFRSVD = * | | * +-------------------------------------------------------+ * 58 * *** Overlay for SBIFRMAT in SBIOP *** SBILIST - Synchronous Block I/O Parameter * * +---------------------------+---------------------------+ * 0 | SBILBKNO | SBILBFAD | * +---------------------------+---------------------------+ * *** SBILIST - Synchronous Block I/O Parameter
SBIOP Cross Reference
Symbol Dspl Value -------------- ---- ----- SBIBLKCT 0010 SBIBLKSZ 0004 SBIBYLEN 0038 00000058 SBICODE 0003 SBIDEVNO 0000 SBIDEVST 0014 SBIDIDBK 0020 SBIDWSIZ 0038 0000000B SBIFBLKS 0010 SBIFDATA 0018 SBIFEID 0030 SBIFORMT 0003 00000004 SBIFREAC 002C SBIFRETC 0028 SBIFRMAT 0008 SBIFRSVD 0034 SBIKEY 0002 SBILBA 0008 SBILBFAD 0004 SBILBKNO 0000 SBILNEXT 0008 SBILNTRY 0000 SBILPM 0018 SBILSTAD 0008 SBILSTA3 000B SBILSTCT 000C SBILSTMX 000C 000001F4 SBIREAD 0003 00000002 SBIRESCT 0016 SBIRESET 0000 SBIRESVD 001C SBIRESV0 0019 SBIRESV1 0020 SBISCHST 0015 SBISDATA 0038 SBISNSCT 001E SBIWRITE 0003 00000001
This information is based on z/VM V5R4.0. Last updated on 18 Feb 2010 at 04:04:50 EDT.
Copyright IBM Corporation, 1990, 2009