XML TRACE

This statement has the following parameters:

Description

Parameter	Description
Flags	A numeric integer literal or an identifier of a numeric integer data item, with one of the following values: 0 = Turn tracing off and keep any existing trace file. 1 = Turn tracing on and keep any existing trace file. 2 = Turn tracing off and delete any existing trace file. 3 = Turn tracing on and delete any existing trace file. The XML Extensions definitions copy file lixmldef.cpy defines the constant-names XML-TraceOffV (0), XML-TraceOnAppendV (1) and XML-TraceOnReplaceV (3) as a convenience for setting the flags.
[FileName]	Optional. A nonnumeric literal or an identifier of an alphanumeric data item, the value of which specifies the name of the trace file. If omitted, a value of XMLTrace.log is assumed.

Parameter

Description

Flags

A numeric integer literal or an identifier of a numeric integer data item, with one of the following values:

0 = Turn tracing off and keep any existing trace file.
1 = Turn tracing on and keep any existing trace file.
2 = Turn tracing off and delete any existing trace file.
3 = Turn tracing on and delete any existing trace file.

The XML Extensions definitions copy file lixmldef.cpy defines the constant-names XML-TraceOffV (0), XML-TraceOnAppendV (1) and XML-TraceOnReplaceV (3) as a convenience for setting the flags.

[FileName]

Optional. A nonnumeric literal or an identifier of an alphanumeric data item, the value of which specifies the name of the trace file. If omitted, a value of XMLTrace.log is assumed.

The XML TRACE statement generates trace information to a designated file. The statement name and parameter values (as well as the calling program name and the time executed) are recorded on entry. Updated parameter values are displayed on exit.

Examples

Without Trace File Parameter:

XML TRACE
 MY-FLAGS.
IF NOT XML-OK GO TO Z.

Showing Optional Trace File Parameter:

XML TRACE
 MY-FLAGS
 MY-TRACE-FILE.
IF NOT XML-OK GO TO Z.

Showing Trace Output for the Execution of an XML IMPORT FILE Statement:

XMLImportFile - entry
 DocumentName[test83i1]
 ModelFileDataName[./code/test83.cob#test-83//test-83-n2-n2//cp1]
 StyleSheetName[]
Date-Time: Tue Apr 17 11:56:16 2007
Called from line 1151 in
TEST-83-N2-N2(C:\xmlext\root\rmc85\test\xmlext\code\TEST83.COB),
compiled
2007/04/17 11:55:24.
XMLImportFile - exit
 Status[0]
FullDocumentName[C:\xmlext\root\rmc85\test\xmlext\xml\test83i1.xml]
 FullModelFileName[C:\xmlext\root\rmc85\test\xmlext\code\TEST83_TEST-83.xtl]
 ModelDataName[test-83//test-83-n2-n2//cp1]
FullStyleSheetName[]