Chapter Contents

Previous

Next
The ODS Statements

ODS TRACE Statement


Writes to the SAS log a record of each output object that is created, or suppresses the writing of this record.

Default: OFF
Featured in: Determining What Output Objects a Procedure Creates


ODS TRACE ON< / <option(s)>>;
ODS TRACE OFF;


Required Arguments

OFF
turns off the writing of the trace record.
Featured in: Determining What Output Objects a Procedure Creates

ON
turns on the writing of the trace record.
Alias: OUTPUT
Featured in: Determining What Output Objects a Procedure Creates


Options

LABEL
includes the label path for the output object in the record. You can use a label path anywhere that you can use a path.
Tip: This option is most useful for users who are running a localized version of SAS because the labels are translated from English to the local language. The names and paths of output objects are not translated because they are part of the syntax of the Output Delivery System.
Featured in: Determining What Output Objects a Procedure Creates

LISTING
writes the trace record to the Listing destination, so that each part of the trace record immediately precedes the output object that it describes.


Contents of the Trace Record

ODS produces an output object by combining data (the data component) with a table definition. The trace record provides information about the data component, the table definition, and the output object. By default, the record that the ODS TRACE statement produces contains these items:

Name
is the name of the output object. You can use the name to reference this output object and others with the same name. (For details on how to reference an output object, see How to Specify an Output Object.) For example, you could use this name in an ODS OUTPUT statement to make a data set from the output object, or you could use it in an ODS SELECT or an ODS EXCLUDE statement.
Tip: The name is the rightmost part of the path that appears in the trace record.

Label
briefly describes the contents of the output object. This label also identifies the output object in the Results folder in the Results window.

Data name
is the name of the data component that was used to create this output object. The data name appears only if it differs from the name of the output object.

Data label
describes the contents of the data.

Template
is the name of the table definition that ODS used to format the output object. You can modify this definition with PROC TEMPLATE (see EDIT Statement).

Path
is the path of the output object. You can use the path to reference this output object. For example, you could use the path in the ODS OUTPUT statement to make a data set from the output, or you could use it in an ODS SELECT or an ODS EXCLUDE statement.

The LABEL option modifies the trace record by including the label path for the object in the record. See the discussion of the LABEL option.


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.