Using the program SNAP interface (IDISNAP)
A program SNAP interface is provided to assist users in debugging problems with applications that do not abend, or that for any other reason cannot be analyzed by Fault Analyzer using one of the normal abend invocation exits described in Exits for invoking Fault Analyzer. This interface permits a call to Fault Analyzer from anywhere within an application program to request an analysis of the current environment. For 24-bit and 31-bit programs, the program SNAP interface module name is IDISNAP. For 64-bit programs, the module name is IDISNAP6.
An example of where a call to IDISNAP might be used is in a DB2® application after execution of an SQL statement that results in a negative SQLCODE.
Apart from the way in which Fault Analyzer is invoked, there is no difference between this type of analysis and any other real-time analysis caused by an abend.
This exit can extract WTO console messages related to the current job from the main trace table and include these messages in the analysis report, except when running under CICS.
It is recommended that you invoke IDISNAP dynamically to ensure that you are always using the most current version:
- If the invoking program is compiled with the DLL option, then invocations of IDISNAP need to be STATIC rather than DYNAMIC.
- For programs written in C, IDISNAP can only be invoked dynamically.