Instrlogname

When you use the enableinstrumentation yes option to collect performance data during backup and restore operations, the client automatically stores the information in a log file.

By default, the performance data is stored in the instrumentation log file (dsminstr.log) in the directory that is specified by the DSM_LOG environment variable (or the DSMI_LOG environment variable for the API-dependent products Tivoli® Storage Manager for Databases: Data Protection for Microsoft SQL Server and Tivoli Storage Manager for Mail: Data Protection for Microsoft Exchange Server). If you did not set the DSM_LOG environment variable, the instrumentation log file is stored in the current directory (the directory where you issued the dsmc command).

Use this option only when you want to change the file name and location of the instrumentation log.

If you want to control the size of the log file, use the instrlogmax option.

Supported Clients

This option is valid for all clients and the Tivoli Storage Manager API.

Options File

Place this option in the client system-options file (dsm.sys) within a server stanza. The option can be set in the client option set on the Tivoli Storage Manager server.

Place this option in the client options file (dsm.opt). The option can be set in the client option set on the Tivoli Storage Manager server.

Important: Set the DSM_LOG environment variable to name a directory where the log is to be placed. The directory that is specified must have permissions that allow write-access from the account under which the client is run. The root directory is not a valid value for DSM_LOG.

Important: Set the DSM_LOG environment variable to name a directory where the log is to be placed. The directory that is specified must have permissions that allow write-access from the account under which the client is run.

Parameters

filespec

Specifies the path and file name where you want to store performance information during backup or restore processing. If any part of the path that you specify does not exist, the client attempts to create it.

If you specify a file name only, the file is stored in the directory that is specified by the DSM_LOG environment variable. If you did not set the DSM_LOG environment variable, the instrumentation log file is stored in the current directory (the directory where you issued the dsmc command).

If you specify a file name only, the file is stored in the directory that is specified by the DSM_LOG environment variable. If you did not set the DSM_LOG environment variable, the instrumentation log file is stored in the current directory (the directory where you issued the dsmc command). The instrumentation log file cannot be a symbolic link.

For Mac OS X, if you specify a file name only, the file is stored in your default folder. The default directories are:

~/Library/Logs/tivoli/tsm
/Library/Logs/tivoli/tsm 

This instrumentation log file name replaces the previous instrumentation log file name dsminstr.report.pXXX that was created by the TESTFLAG=instrument:detail or instrument:API option.