TMF Reference Manual (G06.26+)

TMFCOM Commands
HP NonStop TMF Reference Manual—522418-003
3-66
ALTER AUDITTRAIL
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.
If you specify RESET MAXRETAINEDATFILES, any retained audit-trail files presently
on disk will be purged immediately after they are no longer needed.
Note. You cannot use the ADD AUDITTRAIL command to set the MAXRETAINEDATFILES
value; the MAXRETAINEDATFILES option is only available with ALTER AUDITTRAIL.
Each time TMF is started, all audit-trail files on restore-audit volumes are purged automatically.
Thus, any subsequent recovery is always forced to restore any needed audit trails that were
dumped to tape.