All IEASDUMP.SERVER exits that are defined receive control when
SDATA=SERVERS are specified on the SDUMPX macro, on the DUMP command,
or on an SDUMP option of the CHNGDUMP SDUMP command.
The IEASDUMP.SERVER exit receives control before the system obtains
the areas to be dumped. The exit receives control in the DUMPSRV
address space.
The current dump request is provided to the caller and is mapped
by the IHASDMSE mapping macro. For example:
- Address spaces, specified in an area mapped by DSECT SDMSE_ASIDLST.
The address of this area is in SDMSE_INPUT_ASIDLST_ADDR.
- Storage ranges, specified in an area mapped by DSECT SDMSE_STORAGE.
The address of this area is in SDMSE_INPUT_STORAGE_ADDR.
- Subpools, specified in an area mapped by DSECT SDMSE_SUBPLST.
The address of this area is in SDMSE_INPUT_SUBPLST_ADDR.
- Keys for the subpools, specified in an area mapped by DSECT SDMSE_KEYLIST.
The ddress of this area is in SDMSE_INPUT_KEYLIST_ADDR.
- SDATA options, specified in the SDMSE_SDATA_OPTIONS fields.
If the return code indicates that data should be added, the exit
can add the areas to be dumped, specifying them in the area mapped
by the IHASDMSE mapping macro. For example:
- Address spaces, specified in an area mapped by DSECT SDMSE_ASIDLST.
When used, place the address of this area in SDMSE_OUTPUT_ASIDLST_ADDR.
- Storage ranges, specified in an area mapped by DSECT SDMSE_STORAGE.
When used, place the address of this area in SDMSE_OUTPUT_STORAGE_ADDR.
- Jobs, specified in an area mapped by DSECT SDMSE_JOBLIST. When
used, place the address of this area in SDMSE_OUTPUT_JOBLIST_ADDR.
- Data spaces, specified in an area mapped by DSECT SDMSE_DSPLIST.
When used, place the address of this area in SDMSE_OUTPUT_DSPLIST_ADDR.
- Subpools, specified in an area mapped by DSECT SDMSE_SUBPLST.
When used, place the address of this area in SDMSE_OUTPUT_SUBPLST_ADDR.
- Keys for the subpools, specified in an area mapped by DSECT SDMSE_KEYLIST.
When used, place the address of this area in SDMSE_OUTPUT_KEYLIST_ADDR.
- SDATA options, specified in the SDMSE_SDATA_OPTIONS fields.
The exit can place data to be dumped in a 4096-byte work area supplied
by the system. The address of the work area is in the SDMSE_INPUT_WORKAREA_ADDR
field. If the exit requires more storage, the exit should request
it with a GETMAIN or STORAGE OBTAIN macro and describe it as follows:
- Address in the SDMSE_OUTPUT_WORKAREA_ADDR field
- Length in the SDMSE_OUTPUT_WORKAREA_LENGTH field
- Subpool in the SDMSE_OUTPUT_WORKAREA_SUBPOOL field
- Key in the SDMSE_OUTPUT_WORKAREA_KEY field. Make sure that the
key is in bits 0-3 of the 8-bit field. For example, if using key
1, set the field to X'10'.
Upon return from the exit, the system releases the storage described
by these fields.
Code the IEASDUMP.SERVER exit to be reentrant.