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. |