Build Extensions debugging attributes

These attributes are common to all the Build Extensions Ant tasks that extend the AbstractExtensionsTask or the AbstractExtensionsTeamTask.

Attributes

The following table describes the Build Extensions debugging attributes.
Attribute Description Required
debugOn Specify true to enable Build Extensions debug facilities. The default is false. This attribute must be enabled for the trace, debug, or items messages to be generated. If this attribute is enabled, at least one of the trace, debug, or items attributes must be enabled. No
trace Specify true to enable Build Extensions trace messages. The default is false. Trace messages provide basic debugging information. It is the first level of debug data. No
debug Specify true to enable Build Extensions debug messages. The default is false. Debug messages provide additional debugging information. It is the second level of debug data. Enabling this attribute does not enable the trace attribute. Each level operates as a separate entity. No
items Specify true to enable Build Extensions debug messages. The default is false. Items messages provide detailed debugging information. It is the highest level of debug data. Not all tasks provide items level messages. Enabling this attribute does not enable the trace or debug attribute. Each level operates as a separate entity. No
multi Specify true to include a thread ID in all the debugging messages. The default is false. This option is useful in multi-processing environments where debug messages from different threads might be interleaved. No
timer Specify true to include a timestamp in all the debugging messages. The default is false. This option is useful to track timings or delays, and to merge debug data from different systems or platforms. No
Note:
The Build Extensions debug facilities can also be controlled by creating Ant properties and setting them to the appropriate value, as the following table shows:
Property Description
debugOn Enables the Build Extensions debug facilities when it is set to true.
trace Enables trace messages when it is set to true.
debug Enables debug messages when it is set to true.
items Enables items messages when it is set to true.
multi Enables thread ID inclusion in all the debugging messages when it is set to true.
timer Enables timestamp inclusion in all the debugging messages when it is set to true.