User Exits › Exits 1, 2, and 3 › Exit 2

Exit 2

This exit provides control to the user immediately following completion of the standard accounting algorithm calculations and prior to the construction of user sort control fields, as specified by the SORT statement, for each accounting record being processed. This allows you to perform tests verifying the time and charge calculations or make unique billing adjustments to records reaching this phase of processing. The parameter list and record processing sequence for this exit are identical to that of Exit 1.

Exit 2 is identified in positions 18-25 on the EXITS control statement.

Accounting records and pertinent billing parameters are made available through the parameter list. The user can modify information in the accounting record or any field in the working storage area made available through the parameter list. Upon entry to the user exit routine, the time and charge fields in working storage contain the results of the standard accounting algorithm calculations based on the appropriate RATE, TSORATE, FORMRATE, RJERATE, SNARATE, APPCRATE, and PRIORITY statements.

Alterations in the charge fields must be reflected in the totals, which have already been accumulated at this exit point.

The one-byte EBCDIC disposition indicator, as referenced through the parameter list, is blank upon entry to the user exit routine. A hex 'FF' (high-values) upon entry indicates that an end-of-file condition has occurred and no further record processing is to be performed. The user should take this opportunity to have the exit prepare totals, generate user-formatted reports, close files, and so forth.

The user can optionally set the one-byte disposition indicator to specify the necessary action to be taken upon return to CA JARS. If the disposition indicator has been set by the user to any nonblank character, then the record will be automatically rejected from further processing.

Some possible uses of this exit type are:

• Verifying time or charge calculations.
• Performing unique rate calculations such as a surcharge or a discount.
• Rejecting records from future processing. Remember to reflect these changes in the totals.