How to turn on detailed tracing in BW ?How to debug a particular activity(task)/processStarter in BW ?How to publish AE trace messages in BW ?[Keywords : trace, debug, info, warn, error, role, userRole, AE trace, publish, RV sink]

How to turn on detailed tracing in BW ?How to debug a particular activity(task)/processStarter in BW ?How to publish AE trace messages in BW ?[Keywords : trace, debug, info, warn, error, role, userRole, AE trace, publish, RV sink]

book

Article ID: KB0085726

calendar_today

Updated On:

Products Versions
TIBCO ActiveMatrix BusinessWorks -
Not Applicable -

Description

Resolution:
BW allows the following roles for AE tracing:
-Info
-Debug
-Warn
-Error
-userRole                           //used in log tasks

BW allows three sinks for AE tracing
-Term         //terminal or console
-Log         //log file
-Publish                          //RV sink

The roles and sinks can configured using the following BW properties :
Trace.&ltrole>.Term
Trace.&ltrole>.Log
Trace.&ltrole>.Publish

For user defined roles substitute &ltrole> with 'Role.&ltuserRole>'
Ex.
Trace.Role.myRole.Term=true

By default all sinks for all roles are true. The exception is RV sink. It is false by default. Note that though Debug and Info roles are true by default, you will not see any debug, info trace messages. This is because each component in BW has a switch. Its only when you turn on this switch, you will start seeing debug and info messages for that specific component of BW

To customize the Log file sink, you can use the following properties :
Engine.Log.Dir         //directory to which log file is written
Engine.Log.MaxSize        //max size of log file in bytes
Engine.Log.MaxNum        //Maximum no of log files. Rollover feature

To customize the RV sink, you can use the following properties :
Trace.&ltrole>.Publish.Subject
Trace.&ltrole>.Publish.Service
Trace.&ltrole>.Publish.Daemon
Trace.&ltrole>.Publish.Network

Following are the properties(switch) by which you can control tracing for specific components in BW :
Trace.Startup        //Detailed tracing during engine startup
Trace.JC.*            //Detailed tracing for all process starters
Trace.Engine        //Tracing when job enters process flow        
Trace.Task.*        //Detailed tracing for all tasks

If you wish to turn on tracing for a specific process starter, you should use the following property :
Trace.JC.&ltProcessFlowName>
Ex: I want to debug process starter in "MyPr1" under the folder "ProcessFlows"
Trace.JC.ProcessFlows/MyPr1.process=true

If you wish to turn on tracing for all activities for a specific process flow, you should use following property :
Trace.Task.&ltProcessFlowName>.*
Ex: I want to debug all activities in the process flow "MyPr1" under the folder "ProcessFlows"
Trace.Task.ProcessFlows/MyPr1.process.*=true

If you wish to turn on tracing for a specific activity in a process flow, you should use the following  property :
Trace.Task.&ltProcessFlowName>.&ltActivityName>
Ex: I want to debug an activity "RVPub" in the process flow "MyPr1" under the folder "ProcessFlows"
Trace.Task.ProcessFlows/MyPr1.process.RVPub=true


Issue/Introduction

How to turn on detailed tracing in BW ?How to debug a particular activity(task)/processStarter in BW ?How to publish AE trace messages in BW ?[Keywords : trace, debug, info, warn, error, role, userRole, AE trace, publish, RV sink]