XYGATE User Authentication Reference Manual

XYGATE
®
User Authentication
™
Reference Manual
Chapter 19. XUA Auditing and Audit Reports
XYPRO Technology Corporation 176 Proprietary and Confidential
19.1.2 Audit File Rollover
If any of the disk files specified using the AUDIT keyword in the UACONF file become
unavailable, which can occur if the audit file fills up or is renamed, the XUA server will
close the current file and then attempt to recreate and re-open the original filename. If
the audit file named in the UACONF entry is still unavailable, then XUA will wait and
retry the open operation.
Note: If the file error cannot be retried, because a disk is down for example, then XUA
processing will continue without auditing. When the disk comes back up, XUA
will not resume auditing. You must restart the server to resume auditing.
When an audit defined as a disk file fills up, XUA will receive an error 45 writing to it. At
that point, the current file will be renamed using the first-three characters of the current
file’s name followed by a five-digit sequence number. A new file will be created with
the original name with the same format as the original file. Processing will continue.
The file names will continue to increment each time a new audit file is created.
19.1.3 Resizing AUDIT Files Using the XUA_NEXTGEN Macro
To resize an AUDIT file after audit has been initiated, use the XUA_NEXTGEN macro
described in Appendix C13: on page 304. Change the value of the EXT(pri,sec,max)
sub-keyword in the UACONF file and rename the existing AUDIT files manually for the
new ones to be created
It may be necessary to rename the AUDIT file to the next rolled-over iteration; that is,
AUD#####. The following is an example of how to check what the next AUD#####
should be:
1. Volume to the installation subvolume.
2. Run XUA INSTALL to attach the segment. (Refer to Appendix C1: on page 289.)
3. Check the AUDIT file that will use the current EXT by executing:
#OUTPUT [XUA_NEXTGEN <audit initial>].
4. Open the UACONF file and change the EXT settings.
5. Run the XUA_SYNTAX_CHECK macro to make sure there are no syntax errors in
both the UACONF and UAACL files.
6. Rename the current AUDIT file to the next generated audit file AUD##### from
step 3 above.
7. Check the AUDIT file that will use the changed EXT from now on by executing:
#OUTPUT [XUA_NEXTGEN AUD].