Reference Guide › Utility Reference › VMXSRB Report Program

VMXSRB Report Program

Use the VMXSRB report program to generate formatted output of all audit data captured by CA VM:Secure.

VMXSRB [fn ft fm [ofn oft ofm]] [("Options"]

Options:

[BYUSER userid]
[NOCP]
[PRINT]
[TOUSER userid]
[UPCASE]
[USEREXIT exitfn [TEXT | EXEC]]

Definitions

fn ft fm

Specifies the file that contains the audit data. This data is collected by the AUDITEXT command, so this file should be the same name as the one you specified on the AUDITEXT command. The default is AUDIT EXTRACT A0.

ofn oft ofm

Specifies the file to which to write the audit report. The default is REPORTB LISTING A0.

BYUSER userid

Includes in the report only actions issued by the specified user ID.

NOCP

(CA VM:Secure only) Excludes from the report all CP command activity. This excludes all data reported by VMXSRA. This option is meaningful only if the Rules Facility is implemented.

PRINT

Sends the report to the virtual printer instead of your A–disk.

TOUSER userid

Includes in the report only data where the specified user ID is the object of the action.

UPCASE

Produces the report in uppercase.

USEREXIT fn [ft]

The filename and filetype of the SECURITY REPORTS user exit. EXEC2, REXX, and assembler language are supported. The prototype SECURITY REPORTS exit is VMXEXITD. The filetype can be TEXT or EXEC; the default is TEXT.

Description

The explanation of each action being audited is an English translation of the audit codes stored with the audit record. The output is sorted by date and time.

For each record in the report, the following information displays:

• Date and time of the action
• Terminal address from which the action was issued. For more information about terminal addresses, see Terminal Addresses.
• User ID that issued the action
• Brief explanation of the action

The SECURITY REPORTS User Exit allows you to exclude records from the report. If you use the SECURITY REPORTS user exit, the user exit file must reside on a minidisk you have accessed.

Write the SECURITY REPORTS user exit in assembler language for faster execution.

Return Codes

The following table describes the return codes:

Note: For more information about generating the audit information used as input for this report program, see AUDITEXT Command in the chapter Command Reference.