Retro1.org codex

CHANGE                                                      CMS EDIT subcommand

Use the CHANGE subcommand to change a specified group of characters to another
group of characters of the same or a different length.  You may use the CHANGE
subcommand to change more than one line at a time.  The format of the CHANGE
subcommand is:
+----------+------------------------------------------------------------------+
| Change   | [/string1] [/string2 [/ [1|*|n [G|*]]]]                          |
+----------+------------------------------------------------------------------+
where:


/ (diagonal)
         signifies any unique delimiting character that does not appear in the
         character strings involved in the change.

string1  specifies a group of characters to be changed (old data).  string1 may
         be a null string.

string2  specifies the group of characters that are to replace string1 (new
         data).  string2 may be a null string; if omitted, it is assumed null.

n or *   indicates the number of lines to be searched, starting at the current
         line.  If * is entered, the search is performed until the end of the
         file is reached.  If this option is omitted, then only one line is
         searched.

G or *   requests the editor to change every occurrence of string1 in the lines
         specified.  If G or * is not specified, only the first occurrence of
         string1 in each line specified is changed.  If string1 is null, G or *
         may not be specified.


Usage Notes:

1.  The first nonblank character following the CHANGE subcommand (or any of its
    truncations) is considered the delimiter.  For example:
       c.VM/370.CMS.*
    changes the first occurrence of VM/370 to CMS on every line from the
    current line to the end of the file.

2.  If string2 is omitted, it is assumed to be a null string.  For example:
       THIS ISN THE LINE.
       change /n
       THIS IS THE LINE.
    A null string causes a character deletion.  If string1 is null, characters
    are inserted at the beginning of the line.  For example:
       THIS IS THE LINE.
       change //SO /
       SO THIS IS THE LINE.

3.  To change multiple occurrences of the same string on one line, enter:
       change/string1/string2/ 1 *

4.  The CHANGE subcommand can be used on typewriter terminals to display,
    without changing, any lines that contain the information specified in
    string1.  Enter:
       change /string1/string1/ * *

5.  Use the ZONE subcommand to indicate which columns are to be searched for
    string1.  If string1 is wider than the current zone, you receive the
    message:
       ZONE ERROR
    and you should either reenter the CHANGE subcommand or change the zone
    setting.

6.  If the character string inserted causes the data line to extend beyond the
    truncation column or the zone column, any excess characters are truncated.
    (See the description of the TRUNC subcommand for additional information on
    truncation.)

7.  You should use the ALTER subcommand when you want to change a single
    character to some special character (one that is not available on your
    keyboard).

Responses:

When verification is on, every line that is changed is displayed.

Display Mode Considerations

If you issue the CHANGE subcommand without operands at a 3270 display terminal
in display mode, the following occurs:

1.  The record pointed to by the current line pointer appears in the user input
    area of the display.  If the line is longer than the current truncation
    setting, it is truncated.

2.  You can then alter the record in the user input area by retyping part or
    all of the line, or by using the Insert, Delete, or Erase EOF keys to
    insert or delete characters.

3.  When the line is modified, press the Enter key.  This causes the record in
    the user input area to replace the old record at the current line in the
    output display area.

If you bring a line down to the user input area and decide not to change it,
press the Erase Input key and then the Enter key, and the line is not changed.

When a line is moved to the user input area, all nonprintable characters
(including tabs, backspaces, control characters, and so on) are stripped from
the line.  Also, any characters currently assigned to VM/370 logical line
editing symbols (#, @, cent, ") are reinterpreted when the line is reentered.
You should issue an explicit CHANGE subcommand to change lines containing
special characters.

The CHANGE subcommand is treated as an invalid subcommand if it is issued
without operands at a typewriter terminal or at a 3270 display terminal that is
not in display mode.

When you request a global change on a 3270 terminal, the display is changed
only once, to reflect the final position of the current line pointer.  The
editor displays, in the message area of the display screen:
   {nnnn|NO}  LINE(S) CHANGED
to indicate the number of lines that were updated.  If the change request
resulted in the truncation of any lines, the message is displayed as:
   nnnn LINE(S) CHANGED nnnn LINE(S) TRUNCATED
If the change request moves the current line pointer beyond the end of the
file, the word EOF: is displayed on the current line, preceded by the last
records of the file.  The rest of the output area is blank.