IBM Support

KBB_RAS1_LOG and Universal Agent

Technote (troubleshooting)


When KBB_RAS1_LOG parameter is used into um.ini, the agent keeps writing into the same log file, not switching between multiple files.


The Universal Agent log file keeps growing more and more because the agent does not switch between multiple log files when maximum size is reached.
Furthermore, the file name does not have the usual suffix indicating the log file number.

It looks like :

instead of the expected



Universal Agent configuration file, um.ini, by default does not include the keyword KBB_RAS1_LOG, that is instead present for all the other ITM Agents.

Sometime, for troubleshooting purpose, IBM support can ask you to add KBB_RAS_LOG into um.ini,
in example to increase the number of generated log files (COUNT option) or the maximum file size (LIMIT option):


In this line, KBB_RAS1_LOG is populated with the content of some variables, like RUNNINGHOSTNAME, systask or sysutcstart.
During startup, the agent must resolve these variables to build the string that is passed to the KBB_RAS1_LOG, but it must know the character that is used as "variable prefix".
When adding KBB_RAS1_LOG to um.ini you must also include another keyword that
is indeed already present by default in all the other ITM Agents configuration file:

Using this keyword into the um.ini file, the variables will be correctly resolved and Universal Agent will use the ITM RAS1 log files as expected, switching to the next file when the maximum size is reached and wrapping when the maximum number of log files is reached.

Resolving the problem

Add KBB_VARPREFIX=% keyword into um.ini file before the KBB_RAS1_LOG keyword and restart
the agent

Product Alias/Synonym

IBM Tivoli Monitoring Universal Agent V6.x

Document information

More support for: IBM Tivoli Monitoring V6
ITM Universal Agent V6

Software version: 6.2, 6.2.1, 6.2.2, 6.2.3

Operating system(s): AIX, HP-UX, Linux, Solaris

Reference #: 1624344

Modified date: 29 January 2016

Translate this page: