CHANGE Clause

Purpose

Modifies copied and inline code, as follows:

The report number of report-specific CA Culprit parameters can be changed.
Character strings can be replaced.

Syntax

►►─┬────────────────────────────────────────────────────────────────────────┬─►◄
   │         ┌────────────────────────── AND ─────────────────────────────┐ │
   └ CHange ─▼─┬ Rptno TO report-number ─────────────────────────────────┬┴─┘
               └ 'string1' ┬──────────────────────────────┬ TO 'string2' ┘
                           └─ begin-column ┬─────────────┬┘
                                           └ /end-column ┘

Syntax Rules

CHANGE

Identifies a CHANGE clause. One or more CHANGE clauses can be coded for each USE parameter.

RPTNO TO report-number

Specifies a new report number for all report-specific parameters. Report-number must be a number in the range 0 through 99. The report number coded in columns 2 and 3 of all report-specific parameters changes to the number specified by report-number.

Only one CHANGE clause associated with a USE parameter can specify RPTNO TO.

string-1 TO string-2

Replaces a character string within a specified column range.

If a range of columns is specified on a CHANGE clause that modifies a character string, the changes apply only to the first line of a CA Culprit parameter and not to associated continuation lines. Otherwise, the changes apply to all lines associated with the CA Culprit parameter.

string-1

Specifies an alphanumeric character string that is to be changed. string-1 is a 1- to 70-character value, enclosed in quotation marks.

begin-column

Identifies the starting column of a range. Begin-column must be a number in the range 1 through 72; the default is 1.

If begin-column is specified, character string changes occur only within the specified range of columns.

end-column

Specifies the last column of a range. End-column must be a number in the range 1 through 72; the default is 72. The value specified for end-column must be equal to or greater than the value specified for begin-column. If specified, begin-column and end-column must be separated by a slash.

string-2

Specifies an alphanumeric expression that replaces the original string. String-2 is a 1- to 70-character value, enclosed in quotation marks.

If the replacement string is a different length than the original string, the record length is adjusted to accommodate the length of the new string. If the adjusted record length exceeds 72 characters, one or more continuation lines, with a maximum of 256 characters can be created to accommodate the new string. The entire replacement string must appear on one line.

AND

Signals the end of one CHANGE action and the start of another as in the following example:

CHANGE 'CAT' TO 'DOG' AND 'MOUSE' 4/10 TO 'COW'