Enabling ARM debug tracing for Robotic Response Time monitors

Use the following procedure to enable tracing for Robotic Response Time monitors that make ARM calls, such as Rational Performance Tester, Rational Functional Tester, Robot GUI, Robot VU and CLI Application:
  1. Edit the t6-logging.properties file located in the following location:
    <ITM_HOME>\TMAITM6 (Windows)
    <ITM_HOME>/config (UNIX)
  2. Locate the BWM.trc.arm.debug.logging parameter and set it to true:
    BWM.trc.arm.debug.logging=true
  3. Save your edit and restart the Robotic Response Time agent.
  4. Look for the log files in the following location:
    <ITM_HOME>\TMAITM6\logs (Windows)
    <ITM_HOME>/logs (UNIX)
    The files will be named similar to the following example:
    <short hostname>_t6arm_4bcf2cab-01.log

    For example, test1_t6arm_4bcf2cab-01.log

An XML file, kt6armenv.xml, containing logging configuration settings (such as the log level and the location of the ARM log files) is created the first time that ARM logging is enabled. This file is located in the following directory:
<ITM_HOME>\TMAITM6 (Windows)
<ITM_HOME>/config (UNIX)
The contents of the kt6armenv.xml file is similar to the following example:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
  <comment>T6 RAS1 Logging Properites for ARM</comment>
  <entry key="KBB_RAS1_LOG">
    KBB_RAS1_LOG=%<ITM_HOME>\tmaitm6\logs\%<computer_name>
    _t6arm_%<sysutcstart>-.log
    INVENTORY=%<ITM_HOME>\tmaitm6\logs\%<computer_name>_t6arm.inv
    COUNT=03 LIMIT=5 PRESERVE=1 MAXFILES=9
  </entry>
  <entry key="KBB_VARPREFIX">KBB_VARPREFIX=%</entry>
  <entry key="KBB_RAS1">KBB_RAS1=(COMP:ALL)</entry>
</properties>

To change the location or name of the log file, change the value of the KBB_RAS1_LOG entry element.

To change the log level, change the value of the KBB_RAS1 entry element. For example to log only errors, change <entry key="KBB_RAS1">KBB_RAS1=(COMP:ALL)</entry> to <entry key="KBB_RAS1">KBB_RAS1=ERROR</entry> and restart the Robotic Response Time agent.

Note: For CL1 Scripts/Apps that do not make ARM calls the Robotic agent makes the ARM call on their behalf. ARM logging should be enabled for the Robotic agent in this case by adding the following statement (COMP:ARM ALL) to the RAS1 logging configuration for the agent. In this case the ARM logs will be written directly to the agent logs.