Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Appendix B Trace Messages : Setting Custom Engine Properties for Trace Message Roles

Setting Custom Engine Properties for Trace Message Roles
The following sections describe how to set properties of trace message roles in testing environment and in deployed projects:
Each property represents a trace message role as shown in Table 36. The default value for the trace message roles are shown in the Default Value column. If the property file is not defined, the default value will be used for the message roles.
Custom Properties in Testing Environment
To enable or disable a trace message role in testing environment, you need to set custom property and to specify its location. Perform the following tasks to set properties for trace message roles in testing environment:
Task A Create and Configure a Property File
Perform the following steps to create and configure a property file:
1.
2.
To set property values, follow the rules:
To enable a trace message role, set the value of the corresponding property to true. For example, the following line sets the Trace.Info.* property to true:
Trace.Info.*=true
To disable a trace message role, set the value of the corresponding property to false. For example, the following line sets the Trace.Error.* property to false:
Trace.Error.*=false
Task B Specify the Properties in Testing Environment
Perform the following steps to set properties when testing a process:
1.
2.
Select Tools > Tester > Start from the TIBCO Designer menu. The Select Processes to Load dialog is displayed.
3.
a.
Click Advanced in the Select Processes to Load dialog. The Advanced Test Settings dialog is displayed.
b.
In the Test Engine User Args field, enter the following values:
-p file_directory/file_name
where,
file_directory is the location of the property file name, for example, c:/tibco.
file_name is the property file name, for example, properties.cfg.
c.
Click OK to save the setting.
The enabled messages are logged to the console where the runtime plug-in was started. See "Custom Engine Properties" in TIBCO ActiveMatrix BusinessWorksTM Administration for more information.
Custom Properties in Deployed Projects
TIBCO Administrator is responsible for deploying process engines in a production environment. TIBCO ActiveMatrix BusinessWorksTM provides a file, bwengine.xml, for specifying custom properties in deployed engines. The bwengine.xml file is located in the TIBCO_HOME\bw\release_version\lib\com\tibco\deployment directory.
The file has a properties element that defines all of the properties in the deployed process engine. Each property is contained in a property element with the following structure:
 

 
<property>
 <name>name to display in TIBCO Administrator</name>
 <option>name of property</option>
 <default>default value</default>
 <description>short description of property</description>
</property>

 
Perform the following steps to set properties for trace message roles in deployed projects:
1.
Open the bwengine.xml file.
2.

 
   <property>
    <name>RESTJSON Plug-in Debug Role</name>
    <option>com.tibco.plugin.restjson.debug</option>
    <default>true</default>
    <description>Indicates RESTJSON debug message property.</description>
   </property>

 
After defining the property in the bwengine.xml file, it is available in Enterprise Archive Files that are created by TIBCO Designer, and it is displayed in the Advanced tab of the deployment configuration in TIBCO Administrator.
3.
You can alter the value of a property in the Advanced tab of the deployment configuration and that value will be used in the deployed project. For more information about creating and managing deployment configurations, see "Creating and Deploying Applications" in TIBCO ActiveMatrix BusinessworksTM Administration.
For more information about setting properties in deployed projects, see "Setting Custom Engine Properties in Deployed Projects" in TIBCO ActiveMatrix BusinessworksTM Administration.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved