Previous Topic: SCRATCH User ExitNext Topic: Utility Reference


SECURITY REPORTS User Exit

Use the SECURITY REPORTS user exit to control data contained in the audit reports.

The SECURITY REPORTS has this syntax:

VMXSRB [infileid outfileid [( USEREXIT fn [ft | TEXT]]

Definitions

infileid

Specifies the input filename, filetype, and filemode.

outfileid

Specifies the output filename, filetype, and filemode.

USEREXIT fn [ft]

Specifies the filename and filetype of the user exit file to be used. The filetype can be either TEXT (the default) or EXEC.

If the filetype is TEXT, the user exit routine saves and restores registers and is called with register 1 pointing to an 80‑byte buffer containing the audit record, and register 13 pointing to a standard save area.

Description

The SECURITY REPORTS user exit is specified by an option on the VMXSRB command line. If you use this user exit, the user exit file must reside on a minidisk accessed by the user ID issuing VMXSRB.

After the report program has determined which records to include in the report (based on the options you specified), the user exit is invoked to allow you to exclude any of the selected records. Each selected audit record is passed to the SECURITY REPORTS user exit as input.

Note: For more information about the security reports, see VMXSRB Report Program.

Return Codes

The following table describes the return codes:

Return Code

Meaning

0

Record should be used

8

Record should be ignored