TMF Management Programming Manual (H06.05+)

Commands and Responses
HP NonStop TMF Management Programming Manual—540140-002
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 subystem; 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