XYGATE User Authentication Reference Manual

XYGATE
®
User Authentication
™
Reference Manual
Appendix C: XUA Macros
XYPRO Technology Corporation 291 Proprietary and Confidential
result
Explanation of audit event; specify * for all.
audit-file
The name of the audit file from which to pull report data; for
example, $SYSTEM.XYGATEUA.AUDIT.
output-location
Spooler location and report name; for example, $S.#XUA.REPORT.
sort-type
Specify SUBJECT, TARGET, TIME, SESSION, COUNTS, or
<IP address>.
delete-comments
Specify YES if you want to suppress comments; otherwise, specify
NO.
Production/Test
Result
Type of Results: specify P(roduction), T(est) or BOTH.
target-login-name
May be any of the following:
• One or more case-sensitive Guardian group name.user names
separated by commas
• One or more case-sensitive Safeguard aliases separated by
commas
• Specify
* for all login names.
You may also exclude certain user names or aliases by using the
word NOT.
target-user
The target Userid/Login Name is the ID of the person that the
subject ID is trying to logon contained in the report. This can be one
of the following: #,# GROUP.
* GROUP.USER or *,*
outcome
Specify S(ucess), F(ail), or * for all.
final outcome only
If Final Outcome is set to YES, only results that are granted or
denied will be displayed; otherwise, specify NO.
debug
Determines if debugging information is displayed:
• 1 to display information
• 0 to not display information.
These parameters can be strung together on one line as shown in the following
example:
Example:
$SYSTEM XYGATEUA 1> XUA_AUDIT_REPORT 2004-02-01 00:00 2004-02-10 23:59 222,* * * *
* GROUP-MANAGERS * ALL $SYSTEM.XYGATEUA.AUDIT $S.#XUA.REPORT TARGET NO BOTH * *.*
* NO 0
The above command will generate a report for the time period beginning on
01/FEB/2004 at midnight and ending at 10/FEB/2004 at 1 minute to midnight. All
users in group 222 will be displayed. All login names are included. All terminals will be
included. All IP address will be included. All systems will be included. Only audit
entries matching UAGROUP "GROUP-MANAGERS" will be included. All comments and all
results will be included. All results will be included. The audit file to use is
$SYSTEM.XYGATEUA.AUDIT. The report will be written to $S.#XUA.REPORT. A TARGET
report will be generated. Comments will not be suppressed. Both test and production