The IDIXUFMT load module Formatting user exit
The IDIXUFMT load module Formatting user exit (in the following topics referred to as the IDIXUFMT exit) is a special type of user exit. It does not follow the normal rules that apply to other user exits described in Options, whether in REXX or in load module format.
The IDIXUFMT exit cannot be specified though the Exits option, but is located by load module name. If a load module with the name IDIXUFMT is found in an APF-authorized library during Fault Analyzer execution, then it is invoked during the formatting of the analysis report. The IDIXUFMT exit is called immediately before any other Formatting user exits specified through the Exits option.
The IDIXUFMT exit:
- Must be LE-compliant.
- Must not contain a "main" function.
- Must be link-edited with the NORENT option.
Fault Analyzer invokes the IDIXUFMT exit by way of the IDIXMFMT entry point, which is contained within IDIXLFMT, the non-executable load module that is provided with Fault Analyzer. The exit user code is invoked by way of entry point IDIXUFMT.
Entry specifications
The user code IDIXUFMT entry point is invoked with:
- R1 pointing to two fullwords:
- The first fullword is the address of the ENV data area (see ENV - Common exit environment information).
- The second fullword is the address of the UFM data area (see UFM - Formatting user exit parameter list).
- R13 pointing to save area.
- R14 containing the return address.
- R15 containing the IDIXUFMT entry point address.
Return specifications
On return from the IDIXUFMT entry point:
- R0 and R1 are undefined.
- R2 through R14 must be unchanged.
- R15 is undefined.
Sample IDIXUFMT exits
Two sample IDIXUFMT exits are provided, along with JCL to compile (or Assemble) and link:
- A sample C IDIXUFMT exit is provided in IDI.SIDISAM1(IDIXUFMC)
- A sample Asssembler IDIXUFMT exit is provided in IDI.SIDISAM1(IDIXUFMA)