Skip to main content

<trace>

Write a message to the foreground ObjectScript shell.

Syntax

<trace value='"The time is: " & Now' />

Attributes and Elements

value attribute

Required. This is the text for the trace message. It can be a literal text string (up to 255 characters) or an expression to be evaluated.

In an ObjectScript expression, you can also use virtual property syntax using the {} convention.

LanguageOverride attribute

Optional. Specifies the scripting language in which any expressions (within in this element) are written.

Can be "python", "objectscript", or "basic" (not documented). Default is the language specified in the containing <process> element.

name, disabled, xpos, ypos, xend, yend attributes

Description

The <trace> element writes a message to the ObjectScript shell. <trace> messages appear only if the BPL business process that generates them has been configured to Run in Foreground mode.

Trace messages may be written to the Event Log as well as to the console. A system administrator controls this behavior by configuring a production from the Interoperability > Configure > Production page in the Management Portal. If a BPL business process has the Log Trace Events option checked, it writes trace messages to the Event Log as well as displaying them at the console. If a trace message is logged, its Event Log entry type is Trace.

The BPL <trace> element generates trace message with User priority; the result is the same as calling the $$$TRACE utility from ObjectScript.

Note:

For details, see Adding Trace Elements.

FeedbackOpens in a new tab