TMF Management Programming Manual (G06.24+)

Commands and Responses
HP NonStop TMF Management Programming Manual—522420-002
5-36
ALTER AUDITTRAIL
ZMAXRETAINEDATFILES
specifies the maximum number of restored audit-trail files to retain on disk in
the RESTOREVOLS for the specified audit trail after the restored audit-trail
files are no longer being used by a recovery process. The minimum value is 1,
the maximum 9999.
Tokens in Response Buffer
ZTMF-TKN-VOLUMENAME
contains the name of a volume that was in error, if an error is returned. This token
is not returned if no volume-related error is returned.
ZTMF-TKN-ATVOLUMETYPE
contains the type of the volume specified in ZTMF-TKN-VOLUMENAME. This
token is only present if ZTMF-TKN-VOLUMENAME is present.
ZTMF-TKN-FS-ERROR
contains the file-system error that may have caused the command to fail. Its
presence depends on the value of ZSPI-RET-CODE.
Usage Guidelines
Only super-group users can issue this command.
You can issue this command when TMF is started or stopped. After TMF is started for
the first time (with a specific configuration), you can only add or delete active volumes
when TMF is started.
If an error is returned by this command, then none of the specified changes take place.
The command is executed on an “all or none” basis.
If the primary TMFSERVE fails before the ALTER AUDITTRAIL command completes,
the backup TMFSERVE takes over and undoes the effects of the command before it
processes any new requests from another command. If both TMFSERVE processes
fail while an ALTER AUDITTRAIL command is being processed, the incomplete
command is not undone. You need to check the configuration using the INFO
AUDITTRAIL command and perform the necessary ALTER AUDITTRAIL commands to
return the configuration to the desired state.
If an ALTER AUDITTRAIL command returns an error, it is still possible for preallocated
files not to be purged from the volumes—if they were allocated during the addition of
active volumes and the TMP is unable to purge them. If the ALTER AUDITTRAIL
command is attempted again (and the same volumes are added as active), the extra
files are purged and new ones are created to correspond to the new command.
For more information about the ALTER AUDITTRAIL command, see the TMF
Reference Manual.