DUAFB - Dump Domain Authorised Parameter Block

  
  
  
  The Dump Authorized Facility Parameter Block. This is used to
  pass parameters to the Dump SVC routine DFHDUSVC, and return
  responses to the caller.
  
  --------------------------------------------------------------------
Table 1.
Offset Hex Type Len Name (Dim) Description
(0) STRUCTURE 100 DAFPB
(0) CHARACTER 16 DAFPB_PREFIX
(0) UNSIGNED 2 DAFPB_LENGTH control block length
(2) CHARACTER 1 DAFPB_ARROW >
(3) CHARACTER 3 DAFPB_DFH DFH
(6) CHARACTER 2 DAFPB_DOMAIN DU
(8) CHARACTER 8 DAFPB_BLOCK_ID DAFPB
(10) CHARACTER 84 DAFPB_DATA
(10) UNSIGNED 2 DAFPB_FUNCTION required auth. function
(12) UNSIGNED 2 DAFPB_RESPONSE return code from DFHDUSVC
(14) FULLWORD 4 DAFPB_SDUMPX_RESPONSE MVS return code from SDUMPX
(18) ADDRESS 4 DAFPB_SYMREC_PTR pointer to symptom record
(1C) FULLWORD 4 DAFPB_SYMREC_LEN length of symptom record
(20) CHARACTER 8 DAFPB_DUMPCODE dump code
(28) CHARACTER 9 DAFPB_DUMPID dump identifier
(31) CHARACTER 3 * reserved
(34) BIT(32) 4 * reserved
(38) ADDRESS 4 DAFPB_REMOTE_MSG_PTR address of remote message
(3C) FULLWORD 4 DAFPB_CSVDYNEX_ RETURN_CODE MVS return code from CSVDYNEX
(40) FULLWORD 4 DAFPB_CSVDYNEX_REASON MVS reason code from CSVDYNEX
(44) FULLWORD 4 DAFPB_IWMWQWRK_ RETURN_CODE MVS return code from IWMWQWRK
(48) FULLWORD 4 DAFPB_IWMWQWRK_REASON MVS reason code from IWMWQWRK
(4C) CHARACTER 8 DAFPB_XCFGROUP XCFGroup for RELATED DMP
(54) ADDRESS 4 DAFPB_JOBLIST_PTR pointer to joblist
(58) FULLWORD 4 DAFPB_JOBLIST_LEN length of joblist
(5C) ADDRESS 4 DAFPB_DSPLIST_PTR pointer to dsplist
(60) FULLWORD 4 DAFPB_DSPLIST_LEN length of dsplist
(64) CHARACTER 0 DAFPB_END

Constants

Table 2.
Len Type Value Name Description 
The valid functions for the Dump SVC routine, passed in the
"DAFPB" field "dafpb_function".

The functions currently supported are:

take_sdumpx
provides a fast unformatted dump of virtual storage and returns
a response/reason.
take_related_sdumpx
uses IWMWQWRK to obtain a list of active units of work. This
data is passed to SDUMPX with a request for REMOTE dumps across
the SYSPLEX for CICS systems in XCF group DFHIR00 which are
involved in the active units of work. A dump of virtual storage
is also taken for the local address space.
csvdynex_add_dfhdumpx
adds dfhdumpx to the SDUMPX IEASDUMP.QUERY dynamic exit and
returns a response.

--------------------------------------------------------------------
2 DECIMAL 1 DAFPB_TAKE_SDUMPX
2 DECIMAL 2 DAFPB_TAKE_RELATED_ SDUMPX
2 DECIMAL 3 DAFPB_CSVDYNEX_ADD_ DFHDUMPX 
The valid responses from the Dump SVC routine, passed in the
"DAFPB" field "dafpb_response".

The responses currently produced are:

ok
The operation was executed successfully.
not_supported
The function code supplied is not valid.
getmain_failed
A GETMAIN request for SP 253 storage failed.
festae_failed
The FESTAE could not be established.
not_authorized
The authorization check failed.
sdumpx_failed
The SDUMPX request failed to complete the dump. The MVS response
and reason are returned in "dafpb_sdumpx_response".
csvdynex_failed
The CSVDYNEX request failed. The MVS return code and reason are
returned in "dafpb_csvdynex_return_code" and
"dafpb_csvdynex_reason".
iwmwqwrk_failed
The IWMWQWRK request failed. The MVS return code and reason are
returned in "dafpb_iwmwqwrk_return_code" and
"dafpb_iwmwqwrk_reason".
dfhdumpx_not_found
The exit module DFHDUMPX was not found in the LPA.
invalid_probdesc
The SDUMPX PROBDESC data is invalid.

--------------------------------------------------------------------
2 DECIMAL 0 DAFPB_OK
2 DECIMAL 1 DAFPB_NOT_SUPPORTED
2 DECIMAL 2 DAFPB_GETMAIN_FAILED
2 DECIMAL 3 DAFPB_FESTAE_FAILED
2 DECIMAL 4 DAFPB_NOT_AUTHORIZED
2 DECIMAL 5 DAFPB_SDUMPX_FAILED
2 DECIMAL 6 DAFPB_CSVDYNEX_FAILED
2 DECIMAL 7 DAFPB_IWMWQWRK_FAILED
2 DECIMAL 8 DAFPB_DFHDUMPX_NOT_ FOUND
2 DECIMAL 9 DAFPB_INVALID_PROBDESC