TMF Reference Manual (G06.24+)

TMFCOM Commands
HP NonStop TMF Reference Manual—522418-002
3-59
ALTER AUDITTRAIL
volume holds audit-trail files needed by TMF for backout, volume recovery, or system
restart, the volume is marked as “deleting.” Any preallocated files stored on the
volume are purged immediately, and new files are not written to the volume. When no
more audit-trail files reside on the volume, it is removed from the TMF configuration.
Once a disk volume is defined in the TMF configuration as an active or overflow
volume, that volume cannot be taken down through an SCF STOP DISK command
until all audit-trail files are purged from it by TMF and the volume is removed from the
audit-trail configuration. All volumes defined as active or overflow volumes must be
accessible before TMF can be started.
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