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 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.

#### 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 V5R2.0. Last updated on 12 Apr 2006 at 16:51:53 EDT.
Copyright IBM Corporation, 1990, 2005