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   16 DDC_PARM_LIST (0)
                                        Start of Parameter List - 390
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
0003    3 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    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)
          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 |  DDC_CODE   |:_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        0002
DDC_FCN_CONFIG
               0002 00000003
DDC_FCN_EVENT  0002 00000002
DDC_FCN_START  0002 00000000
DDC_FCN_STOP   0002 00000001
DDC_LEN        0003
DDC_PARM_LIST  0000
DDC_PLEN       0003 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