Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

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.
          .... ...1      DSSVERCD       1 DSSVERCD 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' DSSWRITE 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' DSSFVCIT 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.

 

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

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 01
DSSVERSN       0006
DSSWRITE       0035 80

This information is based on z/VM V5R3.0. Last updated on 25 Jun 2007 at 16:23:34 EDT.
Copyright IBM Corporation, 1990, 2007