User Exit Routines

In order to accommodate installation accounting and reporting requirements not supported by the standard features of the Report Writer, provision is made for user exit routines to augment or modify the actions normally taken. These user exit routines may be written in any language that supports the standard OS/VS program linkage conventions, but COBOL or the Assembler are probably the easiest to use with the least likelihood of problems. The Assembler must be used for input or account exits that intend to insert records. This section describes the parameters passed to exit routines at each of the following four phases in the Report Writer's processing logic:

Creation of the working account file (account exit).
Processing of the working account file prior to the application of billing algorithms (exit-1 exit).
Processing of the working account file after the application of billing algorithms (exit-2 exit).
Processing of user-defined reports prior to formatting a report print line (exit-3 exit).

Exit routines must be present on an accessed disk. A routine may be in the form of a TEXT file, a member in a GLOBALed TXTLIB, or a member in a GLOBALed LOADLIB. To use a LOADLIB member, you must also include the LOADLIB in the FILEDEF statement for $SYSLIB. You should modify the CAIJV050 EXEC to include the statement:

FILEDEF $SYSLIB DISK lib-name LOADLIB fm (CONCAT

It is not necessary to link edit an exit routine with the Report Writer. The exit routine should be compiled and linked independently of the Report Writer.

Exit routines are invoked according to standard linkage conventions, as follows:

Register  Description

   13     Address of a register save area.
   14     Return address.
   15     Address of the exit routine's entry point.
    1     Address of the parameter list.