Trace Generation › Literals

Literals

In addition to exhibiting values, the user can display LITERALS that are not defined as elements in map or work records. The syntax of the LITERAL command is as follows:

LITERAL alphanumeric characters

The limit is 61 alphanumeric characters, including blanks.

If you use a LITERAL statement as the first statement of a dialog, the statement must end with a period.

For example, the command

LITERAL I AM IN SUBROUTINE PUTMAP05

is a valid example of a literal that may be coded in the process. When CA ADS Trace encounters this statement, it comments the command as follows:

!<>LITERAL I AM IN SUBROUTINE PUTMAP05

For subsequent trace generations, you do not need to uncomment this statement. CA ADS Trace recognizes this syntax and adds the code necessary to trace the user-defined literals.

When tracing is no longer desired, remove the LITERAL statement from the source code or choose TRACE OFF option A. Option A directs CA ADS Trace to remove all trace statements, including generated trace statements and EXHIBITS, LITERALS, and TRACE ON and TRACE OFF statements.