TIM Setting Name Prefixes and Configtool

Document ID : KB000030433
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

One of the overlooked areas for TIM problems are TIM settings. This underdocumented area will be explored below.

 

Solution:

The TIM has a variety of Global settings that have the format of names and a value. The name is usually two parts such as BtStats/Enabled where the first part is a prefix that describes a class, function, or category. The second part is the operation or subcategory to be configured. Note that there are one-part setting names such as MaxLogSizeInMB. This is shown below:

 

 TIM1.jpg

Some settings may not be explicitly defined so they will use default implied settings.

 

The common Name Prefixes include:

 

AutoGen                        - Transaction Discovery
BtStats                          - To enable/disable RTTM, change log level and other functionality.
DiskSpace                      - Disk space settings.
Flex                               - Flex Processing
FlexAMFParser                - Flex Processing
Parallel                          - To enable using workers for MTP.
SetTimTime                   - Set the Tim Time maximum difference.
SiteMinder                     - SiteMinder settings such as trace enabled.
TessTimeZone                - Hour Offset
TraceFilters                    - TIM Trace options
TransactionInspection     - TIM Transaction Settings options
XmlPlugin                      - Enabling XML Plugin


These settings are accessed are accessed or changed through the TIM System Setup>Configure TIM Setup page via your browser. Once there, you may view the current settings and then change them. Or you may add a new name/value page. After the change is made, a TIM restart is NOT needed.

 

Besides looking at the GUI, there are other ways to view the TIM settings:

 

1) When collecting the TIM logs and configuration files from the TIM system setup there is a settings file in the status folder.


2) Using configtool (which is a python script)  allows you to read, write, or delete  one or more entries in the tim database. It is found in the /etc/wily/cem/tim/bin or /opt/CA/APM/tim/ (APM 9.6 and later) directories. There are various command line arguments to do this:

-f     -- the Tim settings filename and location. This is
          required. Filename is timsettings.db
-g    -- display specific name/value pair.
-l     -- list all values

-n    -- create a new TIM settings database
-u    -- unset a value
-F    --  Fast - Does not tell TIM of change. (Normally TIM
           is aware of all changes made to the TIM Settings
           database.)


Examples:
1. Getting all settings -- /etc/wily/cem/tim/bin/configtool -f /etc/wily/cem/tim/config/timsettings.db -l
2. Getting a specific setting -- /etc/wily/cem/tim/bin/configtool -f /etc/wily/cem/tim/config/timsettings.db -l | grep 'Tess.*IpAddr'

3) On TIM Restart, all of the TIM Settings are listed included those not shown in the GUI. The difference is this also includes the implied TIM Settings. So while a TIM Restart after a change is not needed, it is recommended to see if the TIM setting change took place. The line will look something like this: (This is for a MTP so there is a worker number.)

Mon Mar 30 09:24:32 2015 18717   w2: ComponentMonitor: DB: BTStats/Level = 0
         ^                                                                                ^                ^                  ^
     Date &Time                                                         TIM Process        Setting Name  Setting Value


The data is stored in a Berkeley database which has nothing other than the TIM Settings name/value pairs. The TIM process does not need to be running to access the database.

 

Notes:

1. Some programs will write the TIM Settings to the APM database for you. (nCipher is one such example.)
2. There is no database name/value validation. So please check that your name/value entries are correct after entry.