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.