CLIST Editing Commands › Primary Commands › CHANGE Command

CHANGE Command

       ┌/       \┐ ┌/        \┐ ┌/                    \┐┌/      \┐
CHANGE │< ALL   >│ │< string >│ │< replacement-string >││[lb[rb]]│< X  >│
       └\ FIRST /┘ └\ *      /┘ └\ *                  /┘└\ NX   /┘

where:

string-specifies the string of characters to find and replace by replacement-string.

replacement-string-specifies the string of characters used to replace string.

* (asterisk)-specifies the string value from the last FIND or CHANGE command entered.

ALL-specifies that all occurrences of a string are to be replaced in scanned lines.

lb rb-specifies left and right bounds (column positions) for the find. If specifying just the left bound, the string can be found anywhere within those bounds.

X-specifies only excluded lines are to be scanned.

NX-specifies only non-excluded lines are to be scanned.

Use the CHANGE command to search for and change the next occurrence of a string in the module. The Editor begins searching at the position of the cursor when you enter the command, and it searches downward until the string is found. If the cursor is on the COMMAND line when you enter the command, the editor begins searching at the top line displayed. If the string is not found, it is changed to the replacement string.

This command is available in Edit Mode.

Change Command Rules

• ALL, FIRST, and the 'lb rb' can appear in any order, but the replacement-string must follow string.
• If a string has embedded blanks, enclose the string in either single or double quotes. For example:

  CHANGE 'program nmae' 'program name'
  CHANGE 'program nmae' 'program name'
  

• If a string has a single asterisk (*), number, ALL, or FIRST, enclose string in quotation marks:

  CHANGE '*' 'comments'
  

• If a string has leading quotation mark (single or double), enclose the string in quotation marks of the opposite kind. For example:

  CHANGE '"t' t
  

• If CAPS Mode is OFF, enter the string as it appears in the text and the replacement-string as it should appear in the text. If CAPS Mode is ON, all lowercase characters are translated to uppercase characters.