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

 

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 - ESAME
0000    0 Bitstring    2 DDC_CODE       Diagnose Code
          000000DC       DDC_DIAG_VAL   X'00DC' Value expected in
                                        DDC_CODE field. Used for
                                        compatibility with VM/SP.
0002    2 Address      1 DDC_FCN        Function Code
          00000000       DDC_FCN_START  X'00' Diagnose 'DC' Start - stnd
                                        plist
          00000001       DDC_FCN_STOP   X'01' Diagnose 'DC' Stop - stnd
                                        plist
          00000002       DDC_FCN_EVENT  X'02' Diagnose 'DC' Event - stnd
                                        plist
          00000003       DDC_FCN_CONFIG X'03' Diagnose 'DC' Config- stnd
                                        plist
          00000080       DDC_FCN_START_G
                                        X'80' Diagnose 'DC' Start - ext'd
                                        plist
          00000081       DDC_FCN_STOP_G X'81' Diagnose 'DC' Stop - ext'd
                                        plist
          00000082       DDC_FCN_EVENT_G
                                        X'82' Diagnose 'DC' Event - ext'd
                                        plist
          00000083       DDC_FCN_CONFIG_G
                                        X'83' Diagnose 'DC' Config- ext'd
                                        plist
0003    3 Address      1 DDC_LEN        Length of parameter list in bytes
          00000010       DDC_PLEN       16 Expected length of Diag
                                        Parameter list
          00000020       DDC_PLEN_G     32 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 V5R1.0. Last updated on 8 Sep 2004 at 13:15:45 EDT.
Copyright IBM Corporation, 1990, 2004