TMF Management Programming Manual (H06.06+, J06.03+)

Commands and Responses
HP NonStop TMF Management Programming Manual—540140-010
5-32
ALTER AUDITTRAIL
Tokens in Command Buffer
ZTMF-TKN-AuditTrailId
specifies the audit trail to be altered. This token is required and must only appear
once in the buffer. The following values are valid:
ZTMF-TKN-AddActiveVolume
specifies a volume to be added to the active-audit volumes. This token is optional;
multiple occurrences are allowed but the total number of volumes configured as
active volumes must not exceed 16 (and must be at least 1). You must specify a
unique disk volume for each audit trail.
If the volume can be added, the current value of ZFilesPerVolume (for the audit
trail) determines how many files are preallocated on the volume when the
command is processed. If the volume has insufficient space, the command fails.
Active-audit volumes are added to the end of the list of available volumes
maintained by the subsystem; therefore, they might not be used immediately. Audit
trail files are written to active-audit volumes sequentially, but the subsystem tries to
avoid writing two audit trail files in succession to the same volume. When the
subsystem is ready to write to an active-audit volume, it uses the next preallocated
file that resides on that volume. Eventually, all preallocated files on the volume are
used.
ZTMF-TKN-DelActiveVolume
specifies a volume to be deleted from the active volume list. The volume containing
the audit file that is currently receiving audit information cannot be deleted. The
volume holding the “Next” file (if it has been prepared) can also not be deleted. If
the volume holds active files that are still needed by TMF, it is not removed from
the active list immediately, but no new files are allocated to it. When the remaining
files are no longer needed, they are purged. When all of the files have been
purged, the volume is removed from the active file list.
At least one active volume must be configured for each audit trail. This token is
optional; multiple occurrences are allowed but the total number of volumes
configured as active volumes must be at least 1.
Deleting a volume from a configuration reduces the capacity of the active audit trail
by the number of files specified in ZFilesPerVolume.
ZTMF-VAL-Mat Master audit trail
ZTMF-VAL-Aux01 Auxiliary audit trail #1
ZTMF-VAL-Aux02 Auxiliary audit trail #2
. . .
ZTMF-VAL-Aux015 Auxiliary audit trail #15