<SUBSTITUTE>

The <SUBSTITUTE> tag identifies whether to substitute values for variable names (in-line variables) within the text of the print stream.

The <SUBSTITUTE> tag setting does not affect replacement of field variables.

The <SUBSTITUTE> tag is only necessary when the input print streams, inserts, or banners contain in-line variables. If all insert or simple variable values are defined by Field tag groups (that is, no %%varname actually exists in the text of any input print stream), you do not need to specify the <SUBSTITUTE> tag since its default is NO. Doing so can help decrease processing time.

Note: When you use the <SUBSTITUTE> tag inside the Insertpage or Insertrec tag group and set substituteYN to YES, the character format of the variable is based on the <TYPE> tag setting. For example, if the <TYPE> tag is set to M[ETACODE], the variable should be in ASCII format.

In-line variables should match the Enrichment platform and type of data you are using. On UNIX, Linux, and Windows, in-line variables are affected by the <RECORD> tag. PTX TCU variables can be affected by the <TYPE> tag.

Inline Variable Formats by Platform

The table below lists the format of the in-line variable based on print stream type and Enrichment platform.


Print Stream Type	Format of In-line Variable on Mainframe	Format of In-line Variable on UNIX, Linux, and Windows
I, D, AFPL	EBCDIC	ASCII (set by the <RECORD> tag)
AFPM line data	EBCDIC	ASCII (set by the <RECORD> tag)
AFPDS and AFPM PTX TCU data	EBCDIC (set by the <TYPE> tag `charset` parameter)	EBCDIC (set by the <TYPE> tag `charset` parameter)
Metacode	ASCII	ASCII (set by the <RECORD> tag)
PCL	N/A	ASCII (set by the <RECORD> tag)

Tag Groups

Syntax

<SUBSTITUTE> substituteYN


Parameter	Description		Default
`substituteYN`	One of the following: Y[ES] — Find variable names in-line within the print stream and substitute variables for their names. N[O] — Do not substitute variables for in-line variable names. The variable names will print in the output.		NO