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

 

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   16 DDC_PARM_LIST (0)
                                        Start of Parameter List
0000    0 Bitstring    2 DDC_CODE (0)   Diagnose Code
          000000DC       DDC_DIAG_VAL   X'00DC' Value expected in
                                        DDC_CODE field. Used for
                                        compatibility with VM/SP.
0000    0 Address      1 DDC_FCN        Function Code
          00000000       DDC_FCN_START  0 Diagnose 'DC' Start
          00000001       DDC_FCN_STOP   1 Diagnose 'DC' Stop
          00000002       DDC_FCN_EVENT  2 Diagnose 'DC' Event
          00000003       DDC_FCN_CONFIG 3 Diagnose 'DC' Config
0001    1 Address      1 DDC_LEN        Length of parameter list in bytes
          00000010       DDC_PLEN       16 Expected length of Diag
                                        Parameter list in bytes
0004    4 Address      4 DDC_PROD_ID    Guest real address 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   Application buffer address (guest
                                        abs)
          00000010       DDC$END        * End of DDCBK
          00000002       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 |:_FCN |:_LEN |/////////////|       DDC_PROD_ID         |
*     +------+------+-------------+---------------------------+
*   8 |/////////////|DDC_BUFF_LEN |       DDC_BUFF_GAA        |
*     +-------------+-------------+---------------------------+
*  10
*
*** DDCBK - Diagnose 'DC' Control Block

 

DDCBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
DDC$END        000C 00000010
DDC_BUFF_GAA   000C
DDC_BUFF_LEN   000A
DDC_CODE       0000
DDC_DIAG_VAL   0000 000000DC
DDC_FCN        0000
DDC_FCN_CONFIG
               0000 00000003
DDC_FCN_EVENT  0000 00000002
DDC_FCN_START  0000 00000000
DDC_FCN_STOP   0000 00000001
DDC_LEN        0001
DDC_PARM_LIST  0000
DDC_PLEN       0001 00000010
DDC_PROD_ID    0004
DDC_PROD_LEN   000C 00000010
DDC_RC_BUFFERR
               000C 00000008
DDC_RC_INVBLEN
               000C 00000006
DDC_RC_INVCODE
               000C 00000001
DDC_RC_INVFCN  000C 00000002
DDC_RC_INVLEN  000C 00000003
DDC_RC_NOTAUTH
               000C 00000005
DDC_RC_NOTFOUND
               000C 00000009
DDC_RC_PAGERR  000C 00000004
DDC_RC_PIDERR  000C 00000007
DDCSIZE        000C 00000002

This information is based on z/VM V4R2.0. Last updated on 17 Oct 2001 at 15:01:16 EDT.
Copyright IBM Corporation, 1990, 2001