:JCL_CONCAT_CHAR

Use the JCL_CONCAT_CHAR script statement to connect two or more script lines that contain JCL to form a single JCL line of up to 2 KB in size. The concatenation is carried out when the Job is generated. You can reuse this script statement in a script to build several JCL lines in succession. For more information about JCL, see Data Lines and Job Control Language.

Syntax

:JCL_CONCAT_CHAR [Character]

[JCL lines]

:JCL_CONCAT_CHAR

  • JCL_CONCAT_CHAR
    Concatenates script lines to a single JCL line

  • Character
    Connector character that connects lines
    Format: script literal or script variable

  • JCL lines
    Script lines to concatenate

End each script line that you want to integrate into a single JCL line with the character that you specify as the connector in the parameter of the script statement. This character connects the relevant script lines with each other at the position of the character. The character itself is not included in the resulting JCL line. End the last script line that you want to include in the resulting JCL line without this character, and use the script statement again after the last line that you want to concatenate, without a parameter.

Notes:

  • Make sure that the character you define as a connector is not used in any of the lines that you are concatenating.
  • If you do not specify a connector character, the script statement has no effect and the lines are not connected.
  • Blanks in the script line right before the character are also be used in the resulting JCL line.
  • Blanks at the beginning of script lines are deleted. This makes it possible to indent individual JCL lines to increase legibility.
  • There is no limitation for JCL lines. The maximum length of individual scripting lines is 1024 characters.
  • You cannot combine multiple commands. This script statement can only connect lines that belong to one command.

Warnings:

  • Do not write any characters after the connector character in a given line. Writing any additional characters after the connector character in the line will cause the Job to fail.
  • This script element automatically splits JCL lines that are inserted using the Forms page of SAP, JMX, PeopleSoft and database jobs and that have a certain length in several lines. Manually inserting this script statement in the Process page of these jobs if you use the Forms page may cause problems. For more information about forms, see Process Pages.

Examples

The following example uses an asterisk (*) as the character that connects the individual script lines. The script calls an MS SQL Server utility with several parameters. The EXIT parameter that contains an SQL statement is written in a new script line. The SQL statement itself is split to several scripting lines. When the job is generated, the JCL_CONCAT_CHAR script statement concatenates these lines to form a single JCL line.

: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: