TMF Reference Manual (G06.26+)

TMFCOM Commands
HP NonStop TMF Reference Manual—522418-003
3-73
ALTER AUDITTRAIL
If the primary transaction management process (TMP) fails before the ALTER
AUDITTRAIL command completes, the backup TMP takes over and undoes the effects
of that command before processing any new requests from TMFCOM. If both TMPs
fail before the ALTER AUDITTRAIL command completes, however, the effects of the
command are not undone; to get the configuration to the desired state, use the INFO
AUDITTRAIL command to check the configuration and then enter ALTER AUDITTRAIL
commands to compensate for the changes needed.
If the ALTER AUDITTRAIL command returns an error, files that were preallocated
when active volumes were added might not be purged from the volumes; this occurs if
the TMP loses access to these volumes. If you attempt the ALTER AUDITTRAIL
command again, adding these volumes as active, the existing preallocated files are
purged before the new ones are created.
TMF includes a transaction abort threshold based on master audit trail (MAT) capacity.
This threshold dictates that if the oldest pinned MAT file is pinned because of currently
active transactions, and 45% or more of the MAT’s active capacity is filled, TMF
automatically aborts those transactions involved in this pinning. (TMF reports these
aborts with EMS event message 289.) The MAT-based threshold cannot be adjusted
by any operator command. Instead, if this threshold is aborting transactions that
should not be aborted, you must increase the audit trail capacity. You can do this
either by increasing the number of audit-trail files per volume or by adding another
active-audit volume.
Examples
The following command changes the FILESPERVOLUME value for the master audit
trail to 4:
TMF 21> ALTER AUDITTRAIL MAT, FILESPERVOLUME 4
The subsequent command adds an active-audit volume and changes the number of
files for the volume to six for the AUX02 audit trail:
TMF 22> ALTER AUDITTRAIL AUX02, ADDACTIVEVOL $AUDIT2, &
>>>FILESPERVOLUME 6
Caution. To avoid severe performance problems during overflow processing, HP strongly
recommends configuring your audit trails to take advantage of same-volume optimization as
discussed under OVERFLOWVOL and OVERFLOWTHRESHOLD Option Considerations