:JCL_SUBSTITUTE

ScriptEigener Objekttyp in der Automation Engine Statement: Replaces a string in the JCL with another string

Syntax

:JCL_SUBSTITUTE [Old String, New String]

Syntax

Description/Format

Old String

String to be replaced
Format: script literal or script variable

New String

String to replace the Old String
Format: script literal or script variable

Comments

This script statement replaces any string in the JCL (Job Control Language"Abkürzung für ""Job Control Language"". Damit sind Anweisungen gemeint, die Verarbeitungsschritte bilden und auf Rechnern ausgeführt werden.") during the generation of a job. The number of characters in the Old String and the New String can vary. It is also possible to replace a single character.

This script statement is used, for example, to handle special requirements of the z/OS JCL. The character "&" is required there. Because this character is used for definitions of script variables in AE, problems can occur.

The specified strings are replaced just after the line with the script statement. They are replaced up to the line of the script in which the script statement is recalled with or without parameters. 

Example

In the example, the character "$" is replaced with the character "&".

:JCL_SUBSTITUTE "$", "&" 
REPORTS=($REP)
SORT=TIME

:
JCL_SUBSTITUTE 
RANGE=$RAN

The generated job then contains the following lines:

REPORTS=(&REP)
SORT=TIME
RANGE=$RAN

See also:

Script element Description

:JCL_CONCAT_CHAR

Forms JCL lines to a size of up to 2 KB

Script Elements - Script Structure and Processing

About Scripts
Script Elements - Alphabetical Listing

Script-Elements - Ordered by Function