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 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. 00000000 * 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 00000000 * 0001 1 Address 1 DDC_LEN Length of parameter list in bytes 00000010 DDC_PLEN 16 Expected length of Diag Parameter list in bytes 00000000 * 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 -------------- ---- ----- * 0000 00000000 * 0000 00000000 * 0001 00000000 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
Last updated on 5 Jun 2001 at 13:16:03 EDT.
Copyright IBM Corporation, 1990, 2001