IEASDUMP.GLOBAL and IEASDUMP.LOCAL dynamic exit processing

The IEASDUMP.GLOBAL and IEASDUMP.LOCAL exits, if defined, receive control when another system in the sysplex requests an SVC dump on this system and the IEASDUMP.QUERY did not block the dump. The SVC dump on this system is requested by:

A SDUMPX macro with a REMOTE parameter
A DUMP command with a REMOTE parameter

The exits receive control as follows:

IEASDUMP.GLOBAL exit: Receives control in the DUMPSRV address space during global data capture, once for an SVC dump on its system.
Note: Do not specify STOKEN on the CSVDYNEX REQUEST=ADD macro for IEASDUMP.GLOBAL.
IEASDUMP.LOCAL exit: Receives control during local data capture in each address space being dumped for an SVC dump on its system. The exit can run several times for one dump.
If STOKEN is specified in the CSVDYNEX REQUEST=ADD macro for an IEASDUMP.LOCAL, the exit will receive control only in the address space represented by the STOKEN and only when the dump includes that address space.

Both exits can add areas to be dumped, specifying them in the area mapped by the IHASDEXI mapping macro. You can dump a single page of data or, if a range is specified, pages of data:

Indicate a range by turning on bit SDEXIADDRESSRANGE and providing the end address in field SDEXIRANGEEND. See the description of bit SDEXIADDRESSRANGE for more complete information about providing an address range.
Indicate a single page of data by making sure that bit SDEXIADDRESSRANGE is off. Place the 4096 bytes of data in the buffer whose address is in field SDEXIFAD.

Note that, in all cases, the system dumps entire 4096-byte pages. The addresses you specify are rounded down or up to page boundaries, as needed.

If the storage to be dumped is in the primary address space, specify its start address in field SDEXICDAD. If the storage is not in the primary address space, define a dump record prefix, which describes the location and the address space or data space being dumped. When defining a dump record prefix, set bit SDEXIDRPS on and place in field SDEXIDRPXLAD the address of the start of the area to be included in the dump; for example, the start of a range, or the address of the 4096-byte buffer's contents, or the address to be associated with the component data. The dump record prefix is a 64-byte area provided by the system, mapped by DSECT SDEXIDRPX, and pointed to by field SDEXIDRPA. See the description preceding the SDEXIDRPX DSECT for information about the fields to set in the dump record prefix area.

After setting the fields in the area mapped by IHASDEXI, the IEASDUMP.GLOBAL or IEASDUMP.LOCAL exit should call the system routine whose address is in the SDEXIORAD field. The system routine adds the storage range or buffer to the dump.

The IEASDUMP.GLOBAL or IEASDUMP.LOCAL exit is to use the following interface when calling the system routine. The system routine must receive control in the following environment:

In supervisor state with PSW key 0.
In dispatchable unit mode of task.
In cross memory mode of any PASN, any SASN, and the HASN under which the IEASDUMP exit received control.
In AMODE 31.
In primary ASC mode.
Enabled for I/O and external interrupts.
With no locks held.
With no enabled, unlocked task (EUT) FRRs.

The contents of the registers on entry to the system routine addressed by SDEXIORAD are:

Register: Contents
0: Not applicable
1: Address of SDEXI
2-12: Not applicable
13: Address of a 72-byte standard save area
14: Return address
15: Entry point address

The contents of the registers on exit from the system routine addressed by SDEXIORAD are:

Register: Contents
0-1: Used as work registers
2-13: Unchanged
14-15: Used as work registers

Code the IEASDUMP.GLOBAL and IEASDUMP.LOCAL exits to be reentrant.