1 GSR
  Global Search and Replace will search for a character string in a
  user specified set of files and replace with a character string.
  When any strings are replaced in a file, a new version of the file
  will be created, with the exception of when a Quit is entered in 
  VERIFY mode.

  Format:

    GSR search-and-replace-file-spec search-string replace-string

2 Parameters
 search-and-replace-file-spec
  Specifies the file(s) to be searched for string.  If strings are found
  and replaced a new version of the file will be created.

 search-string
  Specifies the character string to be searched for.  If the string is
  entered without quotes, the string will be translated to uppercase for
  the search.  If entered with quotes the string will be used as is.

 replace-string
  Specifies the character string to replace the search string.  If the 
  string is entered without quotes, the string will be translated to 
  uppercase for the search.  If entered with quotes the string will be 
  used as is.

2 Command_Qualifiers
/VERIFY
 /NOVERIFY default

  When specified, the user will be prompted at each whenever the search
  string is located, before the replacement occurs.
  The user is prompted:
        Replace Yes, No, All, End, or Quit [Y]:

        Replying 'Y' to the prompt will force the replacement and continue
        the search.

        Replying 'N' will skip the replacement and continue the search.

        Replying 'A' will force the replacement and turn VERIFY off for
        the duration of the Search and Replace process, allowing all
        occurences of the search string to be replaced.

        Replying 'E' will skip the replacement for the rest of the 
        current file and continue the search on the next file.

        Replying 'Q' will skip the replacement for this file, not write
        a new version of this file (regardless of changes) and discontinue
        the search process.

/LOG
 /NOLOG default

  When specified, the filename of each file found with the string are 
  displayed, with the original version of each line containing the search
  string.
  /LOG has no effect when /VERIFY is specified.

/OUTPUT
 /OUTPUT=output-file-spec

  When specified the same information displayed when using the /LOG
  qualifier is written to the output-file-spec.

2 Examples
     1.  GSR/LOG [...]FILE*.DAT IS WAS

        ==> $2$DUA0:[TEMPDIR]FILE1.DAT;2

        THIS IS THE A TEST.
        THIS WAS A FINE FILE BEFORE THE SEARCH AND REPLACE.

        ==> $2$DUA0:[TEMPDIR.SUBDIR]FILE2.DAT;23

        THIS IS THE ANOTHER TEST.
   
        Searches all the files matching the FILE*.DAT wildcard 
        specification in the current directory and all subdirectories 
        for the string IS and replaces it with the string WAS.

     2.  GSR/VERIFY/OUTPUT=TEMP.OUT *.COM uppercase "lowercase"

        ==> $2$DUA0:[TEMPDIR]MYCOM.COM;5
   
        THIS IS UPPERCASE THIS IS NOT uppercase.  UPPERCASE TEST.
                ^
        Replace Yes, No, All, End, or Quit [Y]:Y
   
        THIS IS lowercase THIS IS NOT uppercase.  UPPERCASE TEST.
                                                  ^
        Replace Yes, No, All, End, or Quit [Y]:A
   
        Searches all .COM files in the current directory for the 
        string UPPERCASE (notice the translation to uppercase because 
        of no quotes).  The user is prompted and enters 'Y'.  On the 
        same line notice that UPPERCASE was changed to lowercase.  When 
        'A' is entered at the next prompt the replacement occurs, 
        VERIFY is turned off, and the search process continues.

2 Author
    Version 1.0 

    Original version by David Bryant (Ford Aerospace).

    COPYRIGHT (C) 1989.
