About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
|
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.
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, 2009