TMF Supplement for Large Audit Files (G06.24+)

TMF Reference Manual
HP NonStop TMF Supplement for Large Audit-Trail Files—527391-001
5-17
ALTER AUDITTRAIL (Pages 3-51 through 3-60)
The integer value specifies the total number of audit-trail files retained across the
entire set of restore-audit volumes. In other words, whether you have one restore-
audit volume or five restore-audit volumes, setting the value to 50 would give you a
maximum of 50 retained audit-trail files in either case.
The integer value does not affect the restored audit-trail files that are currently in use
by a recovery process, only what happens to those files when they are no longer in
use.
If you decrease integer from its current value, and the present number of retained
audit-trail files exceeds the new limit, TMF immediately purges the lowest-numbered
retained audit-trail files from disk until the new limit is reached. (For example, TMF
purges the files named AA000032 and AA000033 before AA000034.) If you increase
integer from its current value, TMF allocates no new space but does retain more
audit-trail files from this moment on, until the currently allocated space runs out.
If you set the integer value too high, attempts by a recovery process to restore
required audit-trail files may fail with File System Error 43. In this case, you can
correct the problem without restarting the recovery operation by taking any of these
actions:
•
Lower the MAXRETAINEDATFILES value.
•
Free more restore-audit-volume disk space.
•
Add more restore-audit volumes to the TMF configuration.
Before using the MAXRETAINEDATFILES option, be sure that enough space actually
exists on the restore-audit volumes to contain the restored audit dumps. This
precaution is particularly important where restore-audit volumes overlap between
configured audit trails.
MAXRETAINEDATFILES does not guarantee that an audit-trail file will be restored
from tape only once. Space requirements and the impact of other recoveries all play a
part in determining which audit-trails files are retained indefinitely.
The current MAXRETAINEDATFILES value remains in effect until you explicitly change
it by entering a new value or using RESET MAXRETAINEDATFILES, or until you
request a DELETE TMF operation:
•
If you enter an ALTER AUDITTRAIL command without the
MAXRETAINEDATFILES option, the current MAXRETAINEDATFILES value is
unchanged.
•
If you never enter an ALTER AUDITTRAIL command with the
MAXRETAINEDATFILES option, or if you enter this command with RESET
MAXRETAINEDATFILES specified, the MAXRETAINEDATFILES attribute is set to
its default value of 0.