DDCBK Back to Index page
 
Prolog 
Control Block Contents 
   DDCBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  DDCBK Prolog Top of page
 
 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
 RELOCATION CONSIDERATIONS : None
 COMPATIBILITY AND MIGRATION CONCERNS : 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 Top of page
 

 DDCBK DSECT Top of page
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 Top of page
 
          
*** 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 Top of page
 
 
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 7.3.0 Last updated on 22 Jun 2022 at 15:48:56 EDT.
Copyright IBM Corporation, 1990, 2022