Trace mediation primitive properties

You can specify values for mediation primitive properties either by using the property fields in the IBM® Integration Designer user interface or by using an XML format. The property field names displayed in IBM Integration Designer are generally different from the property names used when building a mediation flow using XML code. In the following information, icons are used to identify each property name used in IBM Integration Designer and the corresponding XML name. (Where applicable, XML names that are required, but not shown in IBM Integration Designer, are also described.)

Enabled

Defines whether the message is mediated by the Trace mediation primitive. By default, the mediate action of the Trace mediation primitive is enabled. You can suspend the mediation action by clearing the check box.

Field detail	Value and notes
Required	Yes
Valid values	Boolean Note:
Default	true

Destination

Determines where the trace messages are written to.

Field detail	Value and notes
Required	Yes
Valid values	Local Server Log 0 The Trace primitive outputs INFO level java.util.logging messages to the server system console. User Trace 1 The trace messages are logged to a UserTrace.log file in the server logs directory, as specified by the LOG_ROOT WebSphere Variable. File 2 The trace messages are logged to the file specified by the File property. Note:
Default	Local Server Log

File path

Defines the file to which trace messages are logged. The file property is only valid when the Destination property is File. If an absolute file path is specified, for example C:\trace\MyTraceFile.txt, then the file is created and logged to in the specified directory. If a relative file path is specified, for example trace/MyTraceFile.txt, then the file is created and logged to in the server logs directory, as specified by the LOG_ROOT IBM variable.

Field detail	Value and notes
Required	No
Valid values	String Note:

Message

A user-supplied message. Inserts {0} to {5} can be included in the message.

Field detail	Value and notes
Required	Yes
Valid values	String Note:
Default	{0}, {1}, {2}, {3}, {4}, {5}

Root path

An XPath 1.0 expression representing the scope of the message and SMO to be inserted into the trace message at insert {4}. You can specify your own XPath expression. If you specify your own XPath expression, the part of the SMO you specify is inserted. The message to be logged is converted to XML from the point specified by Root.

Field detail	Value and notes
Required	Yes
Valid values	XPath Note:
Default	/ The default value is the entire SMO.

Sample XML code

<node name="Trace1" type="Trace">
  <property name="root" value="/body"/>
  <inputTerminal/>
  <outputTerminal/>
  <failTerminal/>
</node>