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. |
DSSBK
Cross Reference (Contains links to field and bit definitions)
DSSBK Prolog
NAME : HCPDSSBK DESCRIPTION: Data Space Services Block. DSECT : DSSBK FUNCTION : The DSSBK is used for parameter passing for diagnose X'23C'. LOCATED BY : Guest Rx register issued by diagnose X'23C'. CREATED BY : Created in the guest virtual machine's storage and copied to VMDVOBUF for CP to use. DELETED BY : Deleted by the guest virtual machine. SERIALIZED : Guest Virtual Machine is responsible. COMMENTS : Any changes to this control block may require MACRO ADDRSPACE to also be changed.
DSSBK Control Block Content
DSSBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure DSSBK Data Space Services Block. 0000 0 Signed 2 DSSDIAGC Diagnose number. ****************------------ 0002 2 Signed 2 DSSFCODE Diagnose function code. ****************------------ 0004 4 Signed 2 DSSDWLEN Y(DSSSIZE) Size of block in doublewords ****************------------ 0006 6 Signed 2 DSSVERSN H(DSSVERCD) Version field. ****************------------ 00000001 DSSVERCD 1 The version number of this DSSBK. 0008 8 Dbl-Word 8 DSSVCIT (0) Virtual Configuration Identification Token (VCIT) used to identify a virtual machine to be permitted access to an address space. 0008 8 Character 8 DSSUSRID Userid for the address space. 0010 16 Character 8 * Reserved for IBM use. 0018 24 Bitstring 24 DSSPACNM Address space name. 0030 48 Signed 4 DSSPAGCT Size of address space in pages(4k). 0034 52 Bitstring 1 DSSSKEY Storage key designating key of address space pages. 0035 53 Bitstring 1 DSSTYPFG Type flag. ****************------------ 1... .... DSSWRITE X'80' Indicates the ALE has read/write access to the address space. If the bit is zero then it indicates read only access to the address space. .... 1... DSSFVCIT X'08' Indicates that the userid field is being used for a VCIT. 0036 54 Bitstring 2 DSSRSVD3 Reserved for IBM use. 0038 56 Dbl-Word 8 DSSASIT Address Space Identification Token (ASIT) associated with the address space. The following equates are used to indicate the size of this control block. 00000040 DSSLEN *-DSSBK Length of this control block in bytes. 00000008 DSSSIZE (DSSLEN+7)/8 Size of this control block in doublewords. This will cause an assembly error if this control block gets to large to fit into VMDVOBUF. 0040 64 Address 4 * (0) IEV075 will resu lt if DSSSIZE*8 GT 256 @P3714FM
DSSBK Storage Layout
*** DSSBK - Data Space Services Block. * * +-------------+-------------+-------------+-------------+ * 0 | DSSDIAGC | DSSFCODE | DSSDWLEN | DSSVERSN | * +-------------+-------------+-------------+-------------+ * 8 | DSSUSRID | * +-------------------------------------------------------+ * 10 |///////////////////////////////////////////////////////| * +-------------------------------------------------------+ * 18 | | * = DSSPACNM = * | | * +---------------------------+------+------+-------------+ * 30 | DSSPAGCT |:SKEY |:TYPFG| DSSRSVD3 | * +---------------------------+------+------+-------------+ * 38 | DSSASIT | * +-------------------------------------------------------+ * 40 * *** DSSBK - Data Space Services Block.
DSSBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----DSSASIT 0038
DSSDIAGC 0000
DSSDWLEN 0004
DSSFCODE 0002
DSSFVCIT 0035 08
DSSLEN 0038 00000040
DSSPACNM 0018
DSSPAGCT 0030
DSSRSVD3 0036
DSSSIZE 0038 00000008
DSSSKEY 0034
DSSTYPFG 0035
DSSUSRID 0008
DSSVCIT 0008
DSSVERCD 0006 00000001
DSSVERSN 0006
DSSWRITE 0035 80
Last updated on 3 Aug 1999 at 11:53:11 EDT.
Copyright IBM Corporation, 1990, 1999