How do I enable/disable WVTrace debug level tracing?

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

In order to troubleshoot a problem with 12.0/12.1 Web Viewer - especially for a problem not providing an error message, CA Support may ask you for a Web Viewer debug level (debug level WVTrace) trace.


How do I enable then disable WVTrace debug level tracing in Output Management Web Viewer 12.1?


1. Edit your OmWVTrace.cfg file. Assuming system level external configuration, this is located in the ${CAOMWV12_HOME}/config folder.

2. If low-level tracing isn't enabled (look for =DEBUG or =EXIT un-commented log4j.logger lines), please uncomment these lines by removing the "#" as first character of the line.

3. This will enable low-level tracing in Web Viewer's communications.

4. Stop and start Tomcat or WebSphere to enable this tracing (or you can wait - changes should be picked up in 5 minutes or so).

5. Once this tracing is enabled, wait for the next occurrence of the problem.

6. When the problem occurs, note the approximate time of the problem and the userid.  Or attempt a fresh login while noting the time and the userid.

7.  Then locate and send to us the wvtrace.log file (in the ${CAOMWV12_HOME}/logs folder).

8. Also send the DRAS and Tomcat or WebSphere log files for the same test.

9. Reverse the changes made above when testing is complete to return to a standard logging level. 

Additional Information:

Following is an example of how change your OmWVTrace.cfg file. 

C:\Program Files\CA\CA_OM_Web_Viewer\apache-tomcat-7.0.54\webapps\CAOMWebViewer12\config\



# Set the categoryFactory to OmTrace category factory.



# Setup the default appender object.  Set the root/default trace priority.

#, A3, stdout, A3  <<== change this from ERROR to DEBUG











log4j.appender.A3.layout.ConversionPattern=%-5p %d{DATE} [%t] %c: %m%n


# Appender for rolling file appender.






log4j.appender.R3.layout.ConversionPattern=%-5p %d{DATE} [%t] %c: %m%n


# Appender for NT file system appender




log4j.appender.NT3.layout.ConversionPattern=%-5p %d{DATE} [%t] %c: %m%n




# Set the priority of "" for default tracing.

# Priorities are from lowest to highest: EXIT, ENTRY, DEBUG, INFO, WARN, ERROR, FATAL

# Priorities greater than or equal to that specified are printed.

# EXIT and ENTRY priorities are defined in


# Since we set OmTraceFactory as the category factory.

# <<== change this from ERROR to DEBUG