docs.intersystems.com
Home / Business Process and Data Transformation Language Reference / BPL Elements / <trace>


Business Process and Data Transformation Language Reference
<trace>
Previous section           Next section
InterSystems: The power behind what matters   
Search:  


Write a message to the foreground Terminal window.
Synopsis
<trace value='"The time is: " & Now' />
Details
Attribute or Element Description Value
value attribute Required. This is the text for the trace message. It can be a literal text string or an expression to be evaluated. A string of one or more characters. May be an expression or a literal string. If this is an expression, it must use the scripting language specified by the containing <process> element. You can also use virtual property syntax using the {} convention.
name, disabled, xpos, ypos, xend, yend attributes See Common Attributes and Elements.”  
<annotation> element
Description
The <trace> element writes a message to the Terminal window. <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 InterSystems IRIS 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 in the chapter Programming in InterSystems IRIS in Developing Productions.


Previous section           Next section
View this book as PDF
Copyright © 1997-2019 InterSystems Corporation, Cambridge, MA
Content Date/Time: 2019-02-22 22:51:58