XML TRACE

This statement has the following parameters:

Parameter Description
Flags Numeric literal or identifier of a numeric data item that specifies the sum of the desired flag values, which are the following:
  • 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.
[Filename] Optional. Nonnumeric literal or identifier of an alphanumeric data item that specifies the filename of the trace file. If omitted, a value of XMLTrace.log is assumed.

If an extension is not specified in the filename, the extension .log is appended to the specified filename. This parameter is ignored if the flags indicate that tracing is being turned off.

Description

The XML TRACE statement generates trace information to a designated file for each statement executed. 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 along with the status returned from the statement.

Examples

XML TRACE
        MY-FLAGS. 
IF NOT XML-OK GO TO Z.
XML TRACE 
    MY-FLAGS 
    MY-TRACE-FILE. 
IF NOT XML-OK GO TO Z.
XMLImportFile - entry
 DocumentName[test1in]
 ModelDataName[XYZ-Data--Document]
 StyleSheetName[]
Date-Time: Fri Jul 02 12:42:53 2010
Called from line 100 in test1.acu(test1.acu), 
                  compiled 2010070212412500000.
XMLImportFile - exit
 Status[0000]
 FullDocumentName[C:\acucobol9\code\test1in.xml]
 FullStyleSheetName[]