=TITLE SUBSTITUTE
 Replaces occurrences of one text string with another.

 Format

     SUBSTITUTE   search-string

                  replace-string

Additional information available:

QualifiersParameters

=TITLE Qualifiers

Additional information available:

/ALL/CASE_MATCHING/CONFIRM/DIALOG/PATTERN/SINGLE

 Specifies that all occurrences of the search string are
 to be replaced with the replace string. Specifying
 the /ALL qualifier causes LSE to perform all the
 indicated substitutions without prompting you for
 further instructions.

    /CASE_MATCHING
    /NOCASE_MATCHING (D)

 Specifies whether LSE uses the case of words in the
 search string to determine the case for the replacement
 string. The four conditions are: uppercase, lowercase,
 capitalized, or undetermined. For example, if a word
 in the search string is all uppercase, all the letters
 of the corresponding word in the replacement string
 become uppercase. If a word in the search string does
 not match the criteria for uppercase, lowercase, or
 capitalization, or there are no alphabetic characters
 in the search string word, its case is undetermined and
 LSE does not modify the case of the corresponding word
 in the replacement string.

 If the replacement string contains more than one word,
 LSE respectively matches the case of words in the
 replacement string with the case of the corresponding
 words in the search string. If the search string
 contains fewer words than the replacement string,
 LSE matches the case of the additional words of the
 replacement string with the case of the last word in
 the search string.

 Specifying the /NOCASE_MATCHING qualifier causes LSE
 not to modify the case of the replacement string to
 match that of the search string.

    /CONFIRM (D)

 Instructs LSE to prompt you for a confirmation at each
 occurrence before performing a substitution. If you
 specify the /CONFIRM qualifier, LSE highlights each
 occurrence of the search string located by the search
 and prompts you for an action.

 o  YES instructs LSE to replace this occurrence.

 o  NO instructs LSE not to replace this occurrence but
    to proceed with the command.

 o  QUIT ends the command without replacing this
    occurrence and stops the SUBSTITUTE operation.

 o  ALL replaces this occurrence and all remaining
    occurrences without further prompting.

    /DIALOG
    /NODIALOG (D)

 Instructs LSE to use a dialog box to prompt you for
 parameters and qualifier values. If you specify this
 qualifier, the command parameters are optional. If
 you supply command parameters and qualifiers with
 the /DIALOG qualifier, LSE uses those parameters and
 qualifiers to set the initial state of the dialog box.

 The Substitute dialog box has the same fields as the
 Search dialog box, plus a button for case-matching
 replacement and a text field for the replacement
 string.

    /PATTERN
    /NOPATTERN (D)

 Enables or disables special interpretation of wildcard
 characters and a quoting character in the search-string
 parameter. You can use the SET SEARCH command to set
 the syntax for specifying a pattern to either VMS style
 or ULTRIX style. For listing of VMS- and ULTRIX-style
 wildcards, see the /PATTERN qualifier on the SEARCH
 command.

 When the /NOPATTERN qualifier is specified (or is
 the default), special interpretation of the asterisk,
 percent sign, and backslash characters is disabled.

 Specifies that only one occurrence of the search
 string is to be replaced with the replacement string.
 Specifying the /SINGLE qualifier causes LSE to perform
 a single substitution without prompting you for an
 action.

=TITLE Parameters

search-string
 Specifies the string for which to search.

replace-string
 Specifies the string to substitute.