|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
DDCBK
Control Block Contents
DDCBK DSECT
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
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
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
Copyright IBM Corporation, 1990, 2011