TMF Supplement for Large Audit Files (G06.24+)

TMF Management Programming Manual
HP NonStop TMF Supplement for Large Audit-Trail Files—527391-001
6-13
ALTER AUDITTRAIL (Pages 5-32 through 5-36)
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.