XYGATE User Authentication Reference Manual

XYGATE
®
User Authentication
™
Reference Manual
Appendix C: XUA Macros
XYPRO Technology Corporation 304 Proprietary and Confidential
C13: XUA_NEXTGEN
The XUA_NEXTGEN macro allows users to check what the name of the next Audit file
should be when the current Audit file is going to be rolled over when it reaches its size.
Syntax:
XUA_NEXTGEN <first 3-chars of current AUDIT file> [<retain>]
Where:
<first 3-chars of
current AUDIT file>
is an audit filename that must be provided as an input to this
macro. For example, AUD is an argument for the default AUDIT
file configuration.
<retain>
is optional. The macro purges the oldest rolled-over audit file until
the number of rolled-over files is less than the entered <retain>
count.
As shown in the Example below, the command #output [xua_nextgen aud 3]
purged the file AUD00002 and displayed the next filename aud00005.
Example:
$VIK XYGATEUA 45> #output [xua_nextgen aud 3]
$VIK.XYGATEUA.AUD00002 PURGED
aud00005
$VIK XYGATEUA 46> fi aud*
$VIK.XYGATEUA
CODE EOF LAST MODIFIED OWNER RWEP PExt SExt
AUD00003 3333 8192 15SEP2013 19:57 232,52 NUUU 300 300
AUD00004 3333 4096 15SEP2013 19:58 232,52 NUUU 300 300
AUDIT 3333 4096 15SEP2013 19:58 232,52 NUUU 300 300
$VIK XYGATEUA 47>
The command fi aud* shows three files: AUDIT and two rolled-over files named
AUD00003 and AUD00004. The number for these two files (that is, 2) is less than the
entered <retain> count of 3.
Refer also to section 19.1, “AUDIT File Considerations” starting on page 175.
C14: XUA_REPORT
The XUA_REPORT macro is used to interactively report on logons that have been
processed by XUA. Refer to Chapter 19, “XUA Auditing and Audit Reports” starting on
page 175 which describes how to run reports using this macro.