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

Windows operating systemsPlace this option in the dsm.opt file.

AIX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsPlace this option in the client system-options file (dsm.sys) within a server stanza.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-AUDITLOGName--filespec--------------------------------------><

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.

Windows operating systemsIn 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.

AIX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsSample output
AIX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsThe 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
Windows operating systemsOptions file:
Windows operating systemsStore the audit log in a non-default path.
auditlogname c:\mypath\myaudit.log
Windows operating systemsCommand line:
Windows operating systemsBack 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"
Windows operating systemsSample output
Windows operating systemsThe 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