Installation and User's Guide

The following is an example of the messages that are issued when the audit log isconfigured to capture the full level of information (in addition to all messagesissued for the basic level of audit logging):04/21/07 15:25:05 ANS1660I Excluded:\\spike\c$\test\file.txt04/21/07 15:25:05 ANS1661I Unchanged:\\spike\c$\test\file.txtThe audit log is not a substitute or a replacement for the standard error log(dsmerror.log) or for the schedule log (dsmsched.log). If an error occurs thatprevents a file from being processed, a message indicating that an error hasoccurred is written to the audit log, but the message will not indicate the nature ofthe error. For problem diagnostics the standard error log must still be used.The audit log entries only contain a time stamp and object name. There is noinformation to distinguish between files and directories or any information aboutthe size of an object.When using the Windows Backup-Archive Client, all object names are written inthe UNC format. The Windows Backup-Archive Client creates the audit log as aUnicode file.By default, the name of the audit log is dsmaudit.log and it is contained in thesame directory as the error log, dsmerror.log. The name and location of the auditlog can be configured using the auditlogname option. There are no parameters tocontrol the size of the audit log or to prune the audit log. The auditlogname optioncannot be set as an option in a Tivoli Storage Manager Server client options set.The auditlogging command is not supported with backup commands whichinteract with image-level objects such as backup image or restore image. Theauditlogging command is supported with backup commands that interact withfile-level objects such as backup groups, backup systemobject, and backupsystemstate.If you have enabled audit logging for an operation and there is a failure trying towrite to the audit log (for example, the disk on which the audit log resides is outof space), the audit logging is disabled for the rest of the operation and the returncode for the operation is set to 12, regardless of the outcome of the operation.Supported ClientsThis option is valid for all clients.Options FilePlace this option in the dsm.opt file.Syntax►►AUDITLOGGingoffbasicfull►◄306 IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide