Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Language Reference Manual

%ACTIVATE Statement

A %ACTIVATE statement makes an identifier active and eligible for replacement. Any subsequent encounter of that identifier in the input text while the identifier is active initiates replacement activity.

Read syntax diagramSkip visual syntax diagram                .-,------------------------.
                V             .-RESCAN---. |
>>-%--ACTIVATE----identifier--+----------+-+--;----------------><
                              +-SCAN-----+
                              '-NORESCAN-'
 

Abbreviation: %ACT

identifier
Specifies the name of a preprocessor variable, a preprocessor procedure, or a preprocessor built-in function.

The identifier should not refer to an array variable.

RESCAN
Specifies that the identifier is replaced as many times as necessary to replace all active identifiers before being placed into the output.
SCAN
Specifies that the identifier is replaced only once before being placed into the output.
NORESCAN
Synonym for SCAN.

Using the %ACTIVATE statement for an identifier that is already active has no effect, except possibly to change the scanning status.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)