Automation Engine Script Guide > Ordered by Function > Script Structure and Processing > :JCL_CONCAT_CHAR

:JCL_CONCAT_CHAR

Script Statement: Forms JCL lines to a size of up to 2 KB.

Syntax

:JCL_CONCAT_CHAR [Character]

Syntax

Description/Format

Character

An individual character that serves as a connector to the subsequent JCL line.
Format: script literal or script variable

Comments

This script statement can be used to connect several scripting lines that contain JCL to one single JCL line. This is done while the job is being generated. There is no limitation for JCL lines. The maximum length of individual scripting lines is limited to 1024 characters.

Scripting lines that should be integrated in one JCL line end with the specified character. This character connects the relevant scripting lines with each other at this position. The last scripting line of the JCL line ends without this character.

The character itself is not included in the JCL line. Blanks that are used in the scripting line right before the character will also be used in the JCL line. Blanks that are used at the beginning of scripting lines will be deleted. By doing so, you can Doing so makes it possible to indent individual JCL statements which increases the script's readability.

You can build several JCL lines in succession. Using this script statement again without any parameters ends the processing of scripting lines.

Using this script element without specifying a character has the effect that you cannot connect several JCL lines. In this case, the script statement has no functionality.

Note that you cannot combine several commands. This script element can only connect lines that belong to one command.

This script element automatically splits JCL lines that are inserted using the Forms tab of SAP, JMX, PeopleSoft and databaseA database is an organized collection of data including relevant data structures. jobs and that have a certain length in several lines. AE does not recommend inserting this script element manually in the Process tab of these jobs if you use the Forms tab because this might cause problems.

Examples

The following example uses a * as the character that connects the individual scripting lines. An MS SQL Server utility is called with several parameters. The parameter EXIT that contains an SQL statement is written in a new scripting line. The SQL statement itself is split to several scripting lines.

:JCL_CONCAT_CHAR "*" 
ISQL.EXE /U SA /P /S BUNTWS02 /t 10 /d UC4 /Q *
"EXIT(UPDATE OH SET OH_EXPKZ = 1 *
WHERE OH_MANDANT = 01 *
AND (OH_OTYP_TYP <> 'FOLD') *
AND OH_LOEKZ = 0)"

:
JCL_CONCAT_CHAR  

 

See also:

Script element Description

:JCL_SUBSTITUTE

Replaces a string in the JCL with another string.

Script Elements - Script Structure and Processing

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by Function