Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
IEAVTSEL — Post Dump Exit Name List Exit z/OS MVS Installation Exits SA23-1381-00 |
|
Topics for This Exit Appear as Follows:
IEAVTSEL is the SVC, IEATDUMP, and SYSMDUMP post-dump exit names list. In IEAVTSEL, you list the names of installation exit routines that the system is to invoke after each SVC dump and SYSMDUMP. You can also set a flag bit for each exit routine to indicate whether the system is to invoke the routine for any dump that dump analysis and elimination (DAE) has suppressed. Each routine receives control in the order it is listed in IEAVTSEL. However, to prevent endless recursion processing loops, the system does not invoke any of the exit routines in IEAVTSEL if an SVC dump request is issued by a post-dump exit routine or its recovery routine. You can use post-dump exit routines to:
Installing Post-Dump Exit RoutinesTo
install a post-dump installation exit routine in your system, you
need to take both of the following steps:
Defining Post-Dump Exits to IEAVTSELYou can specify post-dump exits in any of the blank entries in the IEAVTSEL exit name list. At the completion of each SVC dump, IEATDUMP, or SYSMDUMP, the system invokes the routines in the order you specified them. That is, the exit routine specified in entry 1 gets control first, followed by the exit routine specified in entry 2, and so on. IEAVTSEL
is a CSECT in load module IEAVTSEL (which resides in SYS1.LINKLIB).
The IBM-supplied version of IEAVTSEL contains the following 12-byte
entries:
You can add as many post-dump exit routine load modules to IEAVTSEL as you want. IBM recommends that you use the existing blank entries in IEAVTSEL before creating new ones. Ensure that you do not delete any entries in use by MVS, and that the last entry contains 12 bytes of hexadecimal zeroes. Contents of Entries: The first 8 bytes of each entry contain the exit load module name, and the last 4 bytes of each entry contain a flag bit you would set under certain conditions (explained in The Flag Bit). Entries that have 8 bytes of X'40' (blanks) for the exit load module name are available for customer use. This is how the first, second, and last entries in IEAVTSEL
appear:
To insert a post-dump exit load module name in the list, select an available entry (one that is set to blanks) and substitute the exit load module name in place of the blanks. Exit names can be one to eight characters. Also, set the flag bit if appropriate. For examples of changing entries in IEAVTSEL, see Methods of Adding and Deleting Exit Names in IEAVTSEL. The Flag BitYou can set the
high-order bit of the 4-byte flag field to indicate whether the corresponding
exit routine is invoked for dumps that are suppressed through dump
analysis and elimination (DAE).
Methods of Adding and Deleting Exit Names in IEAVTSELThere are two ways to add or delete exit names
in the exit name list. You can use either of the following methods:
Both methods are explained in greater detail in the other topics. Method 1 — Using DUMPEXIT to Add Names: When using the DUMPEXIT macro, take the following steps:
The changes will take effect on the next IPL. You can
add as many post-dump exit routine load modules to IEAVTSEL as you
want. Additional DUMPEXIT macro invocations can be added to the post-dump
exit routine load module anywhere before the end of
the table marker:
Method 1 — Using DUMPEXIT to Delete Names: When using the DUMPEXIT macro, take the following steps:
The changes will take effect on the next IPL. Method
2 — Using SPZAP or SMP/E to Add Names: When using SPZAP or SMP/E,
take the following steps:
The changes will take affect on the next IPL. Example 1 - Using SPZAP to Add Exit Names: The following job adds EXITRTN1 to the first entry in IEAVTSEL and sets the flag to indicate that EXITRTN1 should get control even if the dump is suppressed by DAE. The job also adds EXITRTN2 to IEAVTSEL and sets the flag to indicate that EXITRTN2 should get control only when a dump is not suppressed by DAE. The job then dumps IEAVTSEL to verify the changes.
Example 1A - Using SMP/E to Add Exit Names: The following job adds EXITRTN1 to the first entry in IEAVTSEL and sets the flag to indicate that EXITRTN1 should get control even if the dump is suppressed by DAE. The job also adds EXITRTN2 to IEAVTSEL and sets the flag to indicate that EXITRTN2 should get control only when a dump is not suppressed by DAE.
Method 2 — Using SPZAP or SMP/E to Delete Name: When using SPZAP or SMP/E, take the following steps:
The changes will take effect on the next IPL. If all entries are in use, you can replace module IEAVTSEL, or expand it. Ensure that you do not delete any entries in use by MVS, and that the last entry contains 12 bytes of hexadecimal zeroes. Example 2 - Using SPZAP to Delete Exit Names: The following job deletes EXITRTN1 from the post-dump exit list. The job then dumps IEAVTSEL to verify the changes.
Example 2A - Using SMP/E to Delete Exit Names: The following job deletes EXITRTN1 from the post-dump exit list.
For
more information on the following topics, use these references:
Exit Routine EnvironmentEach
routine in IEAVTSEL receives control in the following environment:
Exit Recovery: SVC dump establishes its own ESTAE before calling the IEAVTSEL exit routines. Each exit routine must establish its own recovery. Exit Routine ProcessingThe installation exit routines listed in IEAVTSEL receive control with the completion of the dump. Each exit routine in IEAVTSEL accesses a common parameter list (SDEPL) containing data and an interface area that the routines can use to pass information to succeeding routines. The SDEPL is mapped by macro IHASDEPL. Exit Status Flags: A post-dump exit routine listed in IEAVTSEL can determine whether the exit routine that immediately preceded it completed successfully or not by checking the SDEPLEXE flag bit in the SDEPL. The system sets this bit on if the preceding exit routine returned a nonzero return code (in register 15). A post-dump exit routine can determine whether any of the preceding exit routines failed to complete successfully by checking the SDEPLERR flag bit in the SDEPL. Like SDEPLEXE, this bit is set to ‘1’ if a post-dump exit returns a nonzero return code. However, once set on, SDEPLERR is not reset when a subsequent exit routine returns a zero return code. Programming ConsiderationsParameter
List: The SDUMP exit parameter list (SDEPL) is passed to each
post-dump exit routine listed in IEAVTSEL. In addition to other useful
information, the SDEPL contains the addresses of both an exit interface
area and a 200-byte exit work area:
Dump Header Record: The SDEPLHD field in the parameter list (SDEPL) points to a copy of the dump header record. The AMDDATA mapping macro maps the dump header record, and the description of AMDDATA contains information about fields in the header record. For details, see z/OS MVS Data Areas in z/OS Internet Library at http://www.ibm.com/systems/z/os/zos/bkserv/. The
DAE section of the dump header record, which is located in the second
2K of the header record, contains information about the dump that
DAE has gathered. Some fields in the DAE section of the header record
that contain useful diagnostic information are:
If DAE has not suppressed the dump, the first
2K of the dump header record also contains information that a post-dump
exit routine can use. To determine whether DAE has suppressed the
dump, the exit routine can test the PRDID field in the header record.
If the PRDID field contains X'000000', DAE has suppressed
the dump, and the first 2K of the header record does not contain useful
information. If PRDID is non-zero, DAE has not suppressed the dump,
and the first 2K of the dump header record contains valid information
about the dump. Some fields in this part of the header record that
contain useful diagnostic information are:
Other
Considerations:
Entry SpecificationsEach exit routine in IEAVTSEL receives control sequentially and receives a common parameter list. Registers at Entry: The contents of the registers on entry to an installation exit routine in IEAVTSEL are as follows.
Parameter List Contents: Register 1 points to address of the SDUMP exit parameter list (SDEPL) mapped by macro IHASDEPL (data area SDEPL). For a mapping of the SDEPL data area, see z/OS MVS Data Areas in z/OS Internet Library at http://www.ibm.com/systems/z/os/zos/bkserv/. Return SpecificationsThe installation exit routine returns a code indicating whether the exit was successful. Registers at Exit: Upon return from an installation exit routine in IEAVTSEL, the register contents must be as follows.
The system sets exit status flags SDEPLEXE and SDEPERR based on the return code in register 15. See Exit Routine Processing. |
Copyright IBM Corporation 1990, 2014
|