Auditlogname
The auditlogname option specifies the path and file name where you want to store audit log information. This option applies when audit logging is enabled.
Supported Clients
This option is valid for all clients.
Options File
Place this option in the dsm.opt file.
Place this option in the client system-options file (dsm.sys) within a server stanza.
Parameters
- filespec
- Specifies the path and file name where you want the backup-archive client to store audit log
information.
If you specify a file name only, the file is stored in your current directory. The default is the installation directory with a file name of dsmaudit.log. The dsmaudit.log file cannot be a symbolic link.
In Uniform Naming Convention (UNC) format, the path must contain a drive letter. In the following example, the path contains the drive letter D$: \\computer7\D$\logs\tsmaudit.log.
Examples
Run an incremental backup with audit logging enabled.
- Sample output
- The following is a sample execution and output file:
> dsmc inc /SMSVT/mfs1 -auditlogging=full -auditlogname=/home/cliv3/audit.log IBM Spectrum Protect Command Line Backup-Archive Client Interface Client Version 8, Release 1, Level 0.0 Client date/time: 11/16/2016 12:05:35 (c) Copyright by IBM Corporation and other(s) 1990, 2016. All Rights Reserved. Node Name: NAXOS_CLUSTER Session established with server ODINHSMSERV: AIX-RS/6000 Server Version 8, Release 1, Level 0.0 Server date/time: 11/16/2016 12:05:35 Last access: 11/15/2016 12:01:57 Incremental backup of volume '/SMSVT/mfs1' Directory--> 4,096 /SMSVT /mfs1/ [Sent] Normal File--> 32,768 /SMSVT /mfs1/test0 [Sent] Normal File--> 32,768 /SMSVT /mfs1/test1 [Sent] Normal File--> 32,768 /SMSVT /mfs1/test2 [Sent] Normal File--> 32,768 /SMSVT /mfs1/test3 [Sent] Normal File--> 32,768 /SMSVT /mfs1/test4 [Sent] Normal File--> 32,768 /SMSVT /mfs1/test5 [Sent] Normal File--> 32,768 /SMSVT /mfs1/test6 [Sent] Normal File--> 32,768 /SMSVT /mfs1/test7 [Sent] Normal File--> 32,768 /SMSVT /mfs1/test8 [Sent] Normal File--> 32,768 /SMSVT /mfs1/test9 [Sent] Successful incremental backup of '/SMSVT/mfs1' Total number of objects inspected: 11 Total number of objects backed up: 11 Total number of objects updated: 0 Total number of objects rebound: 0 Total number of objects deleted: 0 Total number of objects expired: 0 Total number of objects failed: 0 Total number of bytes transferred: 320.31 KB Data transfer time: 0.01 sec Network data transfer rate: 17,141.84 KB/sec Aggregate data transfer rate: 297.43 KB/sec Objects compressed by: 0% Elapsed processing time: 00:00:01
The following are the audit log contents:
07/03/07 12:05:14 ANS1650I Command: inc /SMSVT/mfs1 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/ 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/test0 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/test1 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/test2 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/test3 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/test4 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/test5 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/test6 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/test7 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/test8 07/03/07 12:05:15 ANS1651I Backed Up: /SMSVT/mfs1/test9
- Options file:
- Store the audit log in a non-default path.
auditlogname c:\mypath\myaudit.log
- Command line:
- Back up a list of files using the maximum level of auditing, which
would enable a separate application, such as a Perl script, to verify
the results:
dsmc i -filelist=file.lst -auditlogging=full -auditlogname="c:\program files\tivoli\tsm\baclient\ temp_audit001.log"
- Sample output
- The following is a sample execution and output file:
C:\Program Files\Tivoli\TSM\baclient>dsmc i c:\test\* -sub=yes -auditlogging=full IBM Spectrum Protect Command Line Backup-Archive Client Interface Client Version 8, Release 1, Level 0.0 Client date/time: 11/16/2016 12:05:35 (c) Copyright by IBM Corporation and other(s) 1990, 2016. All Rights Reserved. Node Name: PATMOS Session established with server PATMOS_5331: Windows Server Version 8, Release 1, Level 0.0 Server date/time: 11/16/2016 12:05:35 Last access: 11/15/2016 15:52:06 Incremental backup of volume 'c:\test\*' Normal File--> 1,048,576 \\patmos\c$\test \dir1\file1 [Sent] Normal File--> 1,048,576 \\patmos\c$\test \dir1\file2 [Sent] Normal File--> 1,024 \\patmos\c$\test \dir1\file3 [Sent] Normal File--> 1,048,576 \\patmos\c$\test \dir2\file1 [Sent] Normal File--> 1,048,576 \\patmos\c$\test \dir2\file2 [Sent] Normal File--> 1,024 \\patmos\c$\test \dir2\file3 [Sent] Successful incremental backup of '\\patmos\c$\test\*' Total number of objects inspected: 12 Total number of objects backed up: 6 Total number of objects updated: 0 Total number of objects rebound: 0 Total number of objects deleted: 0 Total number of objects expired: 0 Total number of objects failed: 0 Total number of bytes transferred: 400.85 KB Data transfer time: 0.00 sec Network data transfer rate: 0.00 KB/sec Aggregate data transfer rate: 382.85 KB/sec Objects compressed by: 91% Elapsed processing time: 00:00:01 ANS1900I Return code is 0. ANS1901I Highest return code was 0.
The following are the audit log contents:
04/21/2007 15:52:25 ANS1650I Command: i c:\test\* 04/21/2007 15:52:26 ANS1661I Unchanged: \\patmos\c$\test 04/21/2007 15:52:26 ANS1661I Unchanged: \\patmos\c$\test\dir1 04/21/2007 15:52:26 ANS1661I Unchanged: \\patmos\c$\test\dir2 04/21/2007 15:52:26 ANS1661I Unchanged: \\patmos\c$\test\file1 04/21/2007 15:52:26 ANS1661I Unchanged: \\patmos\c$\test\file2 04/21/2007 15:52:26 ANS1661I Unchanged: \\patmos\c$\test\file3 04/21/2007 15:52:26 ANS1651I Backed Up: \\patmos\c$\test\dir1\file1 04/21/2007 15:52:26 ANS1651I Backed Up: \\patmos\c$\test\dir1\file2 04/21/2007 15:52:26 ANS1651I Backed Up: \\patmos\c$\test\dir1\file3 04/21/2007 15:52:26 ANS1651I Backed Up: \\patmos\c$\test\dir2\file1 04/21/2007 15:52:26 ANS1651I Backed Up: \\patmos\c$\test\dir2\file2 04/21/2007 15:52:26 ANS1651I Backed Up: \\patmos\c$\test\dir2\file3