Continuing statements - IBM-JCL

1.Continuing JCL Statements
When the total length of the fields on a control statement exceeds 71 columns, continue the fields onto one or more card images.

The following are JCL statements that you cannot continue. While you cannot continue these statements, you can code as many separate statements as you need.

  • JCL Command statement
  • Comment statement
  • Delimiter statement
  • Null statement

For all other JCL statements, you can continue the parameter field or the comments field on the JCL statement. If you continue both the parameter field and the comments field on the same card image, the system ignores the indication to continue the comment. How you continue a parameter field depends on whether or not the parameter is enclosed in apostrophes.

Continuing the Parameter Field

  1. Interrupt the field after a complete parameter or subparameter, including the comma that follows it, at or before column 71.
  2. Code // in columns 1 and 2 of the following statement.
  3. Code a blank character in column 3 of the following statement. If column 3 contains anything but a blank or an asterisk, the system assumes the following statement is a new statement. The system issues an error message indicating that no continuation is found and fails the job.
  4. Continue the interrupted parameter or field beginning in any column from 4 through 16.

Continuing Parameter Fields Enclosed in Apostrophes
To continue a parameter that is enclosed in apostrophes:

  1. Extend the parameter to column 71.
  2. Do not code an apostrophe in column 71 of a JCL statement that is continued. The system interprets the apostrophe in column 71 as the final character in the statement and ignores the continuation. See the following example:

    To correct this problem, split the statement in a different way. For example, start COMMAND in a later column or interchange non-positional parameters in the statement.

  3. Code // in columns 1 and 2 of the following statement.
  4. Continue the parameter in column 16 of the following statement even if this splits the parameter. Trailing blanks or commas within the apostrophes do not indicate a continued statement; the system treats them as part of the parameter.

Continuing the Comments Field
Include comments by following an interrupted parameter field with at least one blank. To continue a comment:

  1. Interrupt the comment at a convenient place before column 72, up to and including column 71.
  2. Code a nonblank character in column 72.
  3. Code // in columns 1 and 2 of the following statement.
  4. Code a blank character in column 3 of the following statement.
  5. Continue the comments field beginning in any column after column 3. You can use JCL comment statements as an alternative way to imbed comments in the JCL stream.

Examples of Continued Statements

Example

This example shows continuation of the parameter field. The parameter field is continued from the first card image to the second card image.

Example

This example shows continuation of the parameter field. The parameter field is continued from the first card image to the second card image. The comment on the first card image is not continued to the next card image.

Example

This example shows continuation of the parameter field and the comments field. The parameter field is continued from the first card image to the second and third card images. The comments field is continued from the third card image to the fourth and fifth card images.

Example

This example shows continuation of a parameter field when a parameter is enclosed in apostrophes. The parameter field is continued from column 71 of the first card image to column 16 of the second.

Continuing JES2 Control Statements
The only JES2 control statement that you can continue is the /*OUTPUT statement. For all other JES2 control statements, code the statement as many times as needed.

Continuing JES3 Control Statements
Continue JES3 statements, except the command statement or //*NETACCT statement, by:

  1. Coding a comma as the last character of the first statement.
  2. Coding //* in columns 1 through 3 of the continuation statement.
  3. Resuming the code in column 4 of the continuation statement.

On the JES3 //*NET statement, each parameter must appear entirely on one statement; a subparameter cannot be continued after a comma, except for the RELEASE parameter. To continue the RELEASE parameter, end the statement with the comma following a job name and continue the next statement with the next job name. The left parenthesis appears at the beginning of the jobname list and the right parenthesis appears at the end of the list. For example:

If the parameters on a //*NETACCT statement cannot fit on one statement, code more than one //*NETACCT statement.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM-JCL Topics