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. --------------------------------------------------------------------
| 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
| 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 | |