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

#### DDCBK

Prolog

Control Block Contents
DDCBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### DDCBK Prolog

     NAME       : HCPDDCBK
     DESCRIPTION: Diagnose 'DC' Control Block
     DSECT      : DDCBK
     FUNCTION   : Maps the Diagnose 'DC' parameter list. Also
                  contains constants related to Diagnose 'DC' processing
     LOCATED BY :
     CREATED BY : HCPMXPDC        Diagnose 'DC' START processing
     DELETED BY : HCPMXSSP        Diagnose 'DC' STOP  processing
     REFERENCES : None
     SERIALIZED : None
     NOTES      : The parameter list format must be identical to VM/SP.
                  The basic plist is identical to VM/SP, however, there
                  is a new parameter list extention area for AMODE 64
                  callers.

#### DDCBK Control Block Content

#### DDCBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      DDCBK          Diagnose 'DC' Control Block
    0000    0 Bitstring   32 DDC_PARM_LIST (0)
                                            Start of Parameter List
    0000    0 Bitstring    2 DDC_CODE       Diagnose Code
              000000DC       DDC_DIAG_VAL   X'00DC' DDC_DIAG_VAL Value
                                            expected in DDC_CODE fiel for
                                            compatibility with VM/SP.
    0002    2 Address      1 DDC_FCN        Function Code
              00000000       DDC_FCN_START  X'00' DDC_FCN_START Diagnose 'DC'
                                            Start - stnd plist
              00000001       DDC_FCN_STOP   X'01' DDC_FCN_STOP Diagnose 'DC'
                                            Stop - stnd plist
              00000002       DDC_FCN_EVENT  X'02' DDC_FCN_EVENT Diagnose 'DC'
                                            Event - stnd plist
              00000003       DDC_FCN_CONFIG X'03' DDC_FCN_CONFIG Diagnose
                                            'DC' Config- stnd plis
              00000080       DDC_FCN_START_G
                                            X'80' DDC_FCN_START_G Diagnose
                                            'DC' Start - ext'd
              00000081       DDC_FCN_STOP_G X'81' DDC_FCN_STOP_G Diagnose
                                            'DC' Stop - ext'd p
              00000082       DDC_FCN_EVENT_G
                                            X'82' DDC_FCN_EVENT_G Diagnose
                                            'DC' Event - ext'd
              00000083       DDC_FCN_CONFIG_G
                                            X'83' DDC_FCN_CONFIG_G Diagnose
                                            'DC' Config- ext'd
    0003    3 Address      1 DDC_LEN        Length of parameter list in bytes
              00000010       DDC_PLEN       16 DDC_PLEN Expected length of
                                            Diag Parameter list
              00000020       DDC_PLEN_G     32 DDC_PLEN_G Extended len of
                                            64-bit Diag Plist in bytes
    0004    4 Address      4 DDC_PROD_ID    31-bit addr of Product id field
    0008    8 Bitstring    2 *              Reserved for IBM use
    000A   10 Address      2 DDC_BUFF_LEN   Application buffer length in
                                            bytes
    000C   12 Address      4 DDC_BUFF_GAA   31-bit Guest appl. buffer addr
                                            (guest absolute address)
    0010   16 Character    8 DDC_PROD_ID_G  64-bit addr of Product-Id (guest
                                            absolute address)
    0018   24 Character    8 DDC_BUFF_GAA_G 64-bit Guest appl. buffer addr
                                            (guest absolute address)
              00000020       DDC$END        * End of DDCBK
              00000004       DDCSIZE        (DDC$END-DDCBK+7)/8 DDCBK size in
                                            doublewords
              00000010       DDC_PROD_LEN   16 Expected product ID field
                                            length
            Return codes passed back to the virtual machine
            Notes      : Return codes are compatible with VM/SP.
              00000001       DDC_RC_INVCODE 1 Diagnose code not 'DC'
              00000002       DDC_RC_INVFCN  2 Function code not valid
              00000003       DDC_RC_INVLEN  3 Invalid parameter list length
              00000004       DDC_RC_PAGERR  4 Parameter list paging error
              00000005       DDC_RC_NOTAUTH 5 Virtual machine not authorized
              00000006       DDC_RC_INVBLEN 6 Invalid application buffer
                                            length
              00000007       DDC_RC_PIDERR  7 Product ID field not
                                            addressable
              00000008       DDC_RC_BUFFERR 8 Buffer not addressable
              00000009       DDC_RC_NOTFOUND
                                            9 Matching buffer not found

#### DDCBK Storage Layout

    *** DDCBK - Diagnose 'DC' Control Block
    *
    *     +-------------+------+------+---------------------------+
    *   0 |  DDC_CODE   |:_FCN |:_LEN |       DDC_PROD_ID         |
    *     +-------------+------+------+---------------------------+
    *   8 |/////////////|DDC_BUFF_LEN |       DDC_BUFF_GAA        |
    *     +-------------+-------------+---------------------------+
    *  10 |                    DDC_PROD_ID_G                      |
    *     +-------------------------------------------------------+
    *  18 |                    DDC_BUFF_GAA_G                     |
    *     +-------------------------------------------------------+
    *  20
    *
    *** DDCBK - Diagnose 'DC' Control Block

#### DDCBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DDC$END        0018 00000020
    DDC_BUFF_GAA   000C
    DDC_BUFF_GAA_G
                   0018
    DDC_BUFF_LEN   000A
    DDC_CODE       0000
    DDC_DIAG_VAL   0000 000000DC
    DDC_FCN        0002
    DDC_FCN_CONFIG
                   0002 00000003
    DDC_FCN_CONFIG_G
                   0002 00000083
    DDC_FCN_EVENT  0002 00000002
    DDC_FCN_EVENT_G
                   0002 00000082
    DDC_FCN_START  0002 00000000
    DDC_FCN_START_G
                   0002 00000080
    DDC_FCN_STOP   0002 00000001
    DDC_FCN_STOP_G
                   0002 00000081
    DDC_LEN        0003
    DDC_PARM_LIST  0000
    DDC_PLEN       0003 00000010
    DDC_PLEN_G     0003 00000020
    DDC_PROD_ID    0004
    DDC_PROD_ID_G  0010
    DDC_PROD_LEN   0018 00000010
    DDC_RC_BUFFERR
                   0018 00000008
    DDC_RC_INVBLEN
                   0018 00000006
    DDC_RC_INVCODE
                   0018 00000001
    DDC_RC_INVFCN  0018 00000002
    DDC_RC_INVLEN  0018 00000003
    DDC_RC_NOTAUTH
                   0018 00000005
    DDC_RC_NOTFOUND
                   0018 00000009
    DDC_RC_PAGERR  0018 00000004
    DDC_RC_PIDERR  0018 00000007
    DDCSIZE        0018 00000004

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:32:46 EDT.
Copyright IBM Corporation, 1990, 2008