The AUDITFILE emitter user exit is invoked to report on emitter status changes. It is enabled by specifying its name to the AUDITFILE emitter via the AuditfileExit property, see AUDITFILE Emitter Properties. The following status changes are reported:
The AUDITFILE emitter loads the DLL or shared object named by the AuditfileExit property and invokes the AUDITFILE_EMITTER_EXIT entry point within it whenever an emitter status change occurs.
The interface to the AUDITFILE_EMITTER_EXIT entry point is as follows:
typedef cobrtncode_t (*PFI_AUDITFILE_EMITTER_EXIT)(cobuns32_t function, cobuns8_t *emitter_name, ...);
function | AUDITFILE emitter status change:
|
||||||||||
emitter name | The name of the emitter invoking the exit | ||||||||||
... | A variable number of parameters depending on the value of
function. When:
|
Nothing
Dependent upon the exit function. At present this should always be 0.
Please note that the user exit should not be written in COBOL.
See auditfile_exit.c for an example.