Instrlogmax

The instrlogmax option specifies the maximum size of the instrumentation log (dsminstr.log), in MB. Performance data for the client is collected in the dsminstr.log file during backup or restore processing when the enableinstrumentation option is set to yes.

If you change the value of the instrlogmax option, the existing log is extended or shortened to accommodate the new size. If the value is reduced, the oldest entries are deleted to reduce the file to the new size.

If you do not specify the instrlogmax option, the instrumentation log can grow without any limit on its size. You must manually manage the log contents to prevent the log from depleting disk resources.

Supported Clients

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

Options File

AIX operating systemsHP-UX 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. The option can be set in the client option set on the Tivoli Storage Manager server.

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

Syntax

Read syntax diagramSkip visual syntax diagram
>>-INSTRLOGMAX-- --size----------------------------------------><

Parameters

size
Specifies the maximum size, in MB, for the instrumentation log file. The range of values is 0 - 2047. The default value is 25.

When the size of the dsminstr.log file exceeds the maximum size, the log file is renamed to dsminstr.log.bak. Subsequent instrumentation data continues to be saved to the dsminstr.log file.

If you specify 0, the log file grows indefinitely.

Examples

Options file:
instrlogmax 100
Command line:
AIX operating systemsHP-UX operating systemsLinux operating systemsMac OS X operating systemsOracle Solaris operating systemsdsmc sel /home/mydir/* -subdir=yes -enableinstrumentation=yes -instrlogmax=100
Windows operating systemsdsmc sel c:\mydir\* -subdir=yes -enableinstrumentation=yes -instrlogmax=100

This option is valid only on the initial command line. It is not valid in interactive mode.