Micro Focus Visual COBOL 2.3 Update 1 for Eclipse (UNIX) > Programming > COBOL Programming > Using COBOL and XML together > XML Extensions > XML Extensions statements reference > State management statements > XML TRACE

XML TRACE

This statement has the following parameters:

Description

Parameter

Description

Flags

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.

[File-name]

Optionally 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[]