Tivoli Storage Manager Installing the Clients


Appendix D. Journal Service Configuration

Journal service configuration settings are specified in the journal configuration file tsmjbbd.ini. This file may be installed and configured with the GUI setup wizard or edited manually. The tsmjbbd.ini file is a Windows style stanza based .ini file and should always reside in the same directory as the journal service executable module (tsmjbbd.exe).

The configuration settings are applied when the journal service is started and any changes made while the journal service is running are not applied until the journal service is restarted.

The following is the syntax for stanza and stanza settings:

Syntax for stanzas:
[StanzaName]
Syntax for stanza settings:
stanzaSetting=value

Stanza and value names are not case sensitive.

Numeric values may be specified in hexadecimal by preceding the value with 0x otherwise they are interpreted as decimal.

There is no correlation between these settings and any settings in the backup-archive client options file. The journal service is a completely independent process and does not process backup-archive client options.


JournalSettings Stanza

Settings under this stanza are global and apply to the entire journal service.

The following is the syntax for the JournalSettings stanza:

Syntax for JournalSettings stanza:
[JournalSettings]
Syntax for stanza settings:
JournalSettings=value

You can specify the following JournalSettings values:

NlsRepos
Specifies the National Language Support repository the journal service uses for generating messages. Since the journal service is non-interactive this only applies to messages written to the journal error log. The default value is dscameng.txt. For example:
  NlsRepos=dscameng.txt  

ErrorLog
Specifies the log file where detailed error messages generated by the journal service are written. Note that less detailed error and informational messages are written to the Windows NT, 2000 application eventlog as well. The default value is jbberror.log. For example:
  ErrorLog=jbberror.log  

JournalDir
Specifies the directory where journal database files are written. The default directory is the journal service installation directory. For example:
  JournalDir=c:\TsmJournalDb  

JournalExcludeList Stanza

This list of exclude statements filters changes from being recorded in the journal database. Changes to objects which match statements in this stanza are ignored and are not recorded in the journal database.

There is no correlation between the journal exclude list and the backup-archive client exclude list.

The following pattern matching meta characters are supported:

%
Matches exactly one character.

*
Matches zero or more characters.

%EnvVar%
Expands environment variable.

The following is an exclude statement syntax example:

  [JournalExcludeList]
  %SystemRoot%\System32\Config\*
  %SystemDrive%\Adsm.Sys\*
  %TEMP%\*
  %TMP%\*
  c:\excludedir\*
  c:\dir1\excludefile
  *.:\*.tmp
Note:
The c:\excludedir\* statement matches the entire tree including subdirectories and files.

JournaledFileSystemSettings Stanza

Settings under this stanza (with the exception of the JournaledFileSystems setting) apply to each specified journaled file system. These settings may be overridden for individual file systems in an override stanza; see "Overriding Stanzas" for more information.

The following is the syntax for the JournaledFileSystemSettings stanza:

Syntax for JournaledFileSystemSettings stanza:
[JournaledFileSystemSettings]
Syntax for stanza settings:
JournaledFileSystemSetting=value

You can specify the following JournaledFileSystemSettings values:

JournaledFileSystems
Specifies a space delimited list of file systems to journal. With the exception of Windows 2000 mount points, only entire file systems are supported. There is no default value. You must specify at least one journaled file system for the journal service to run. For example:
  JournaledFileSystem=c: d:

JournalDbSize
Specifies the maximum size the journal database can grow. The journal database size is expressed in bytes. A value of zero (0) indicates that the database size is limited only by the capacity of the file system containing the journal database. The default is 0 (unlimited). For example:
  JournalDBSize=0x005000

NotifyBufferSize
Specifies the size of the memory buffer receiving file system change notifications. You may need to increase this value for journaled file systems that generate a very large volume of change activity. The buffer size is limited by memory. The default value is 0x00100000 (1 megabyte). For example:
  NotifyBufferSize=0x00200000

NotifyFilter
Specifies what file system change actions generate notifications to the journal service. Multiple actions may be monitored by combining (logical OR'ing) values together. The default value is 0x117 (File and Dir Name, Attrib, Size, Last Write, and security Changes). Supported values are:
Value Type Decimal Hex
File Name 1 0x001
Dir Name 2 0x002
Attribute 4 0x004
File size* 8 0x008
Last Write Time* 16 0x010
Last Access Time 32 0x020
Create Time 64 0x040
Security (ACL) 256 0x100

The asterisk (*) indicates that notification may be deferred until disk write cache is flushed. Name changes are object creations, deletions, or renames.

Example:

  NotifyFilter=0x107

Overriding Stanzas

Any setting in the JournaledFileSystemSettings stanza may be overridden for a particular journaled file system by creating an override stanza.

The following is the syntax for the JournaledFileSystemSettings stanza:

Syntax for JournaledFileSystemSettings stanza:
[JournaledFileSystemSettings.fs]
Syntax for stanza settings:
JournaledFileSystemSetting=override value

Example:

  [JournalFileSystemSettings.C:\]
  NotifyBuffer=0x0020000
  NotifyFilter=0x107


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]