XYGATE Merged Audit Reference Manual

XYGATE Merged Audit
®
Reference Manual
Chapter 3. Configuring Filters and the FILTERS File
XYPRO Technology Corporation 65 Proprietary and Confidential
MAXCOMPLETIONTIME
Once the MOVER “fires off” the RUNCMD statements, the concatenated commands
are sent to TACL for execution. The MOVER then waits for TACL to respond back that
the command(s) have executed. The MOVER will wait for a response for the number
of seconds defined by the MAXMPLETIONTIME. If this wait period expires before
TACL responds, then an error counter is incremented, an error message is generated,
and the MOVER continues on to the next incoming audit record.
The MAXCOMPLETIONTIME keyword sets the timeout in case the macro does not
complete. If it does not complete within the time, the MOVER will try to re-execute the
RUNCMD statements five times. If five errors occur trying to get TACL to execute
commands, then the MOVER abends.
Note: During the MAXCOMPLETIONTIME timeout period, the MOVER is actually
waiting. It is not processing any other work. So the timeout should be kept as
small as practically possible.
TCLEXC
The structure TCLEXC contains information from the Audit Session, Audit Detail,
Installation, and Product tables for the row currently being examined for filtering
purposes. The structure TCLEXC can be used when the ACTIONTYPE RUNCMD is
specified. This information is contained in the TCLEXC file in the XMA subvolume on
the pathway node. Refer to Appendix F: “TCLEXC” starting on page 227 for the format
of this structure.
Configuring SETDATA Actions
Use the SETDATA action to put text into the USER_DATA column of the AUDIT table.
The text can then be used as selection criteria for audit reports and/or displayed in
audit reports.
If you wish to SETDATA, enter the text you wish to insert in the USER_DATA column
of the AUDIT table.
Syntax:
USER_DATA {<text string>}
Quotation marks are not necessary, but you can insert quotation marks if you like.
The text string can be up to 16-characters long.
Example 8 below shows a SETDATA action. The text “Priv User” will be inserted in the
USER_DATA column of the AUDIT table. This information is available as selection
criteria for generating reports. For example, if all Filters that had something to do with
privileged IDs had this entry, you could run an audit report that selected records with
this string, creating a report that contained all activity regarding Privileged userids.