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

Prolog  

Control Block Contents  

DSSBK DSECT

Storage Layout  

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


This information is based on VM/ESA 2.4.0.
Last updated on 3 Aug 1999 at 11:53:11 EDT.
Copyright IBM Corporation, 1990, 1999