OpenVMS DCL command files for download
---------------------------------------------------------------------------
You can visit Yezerski Roper's home page or our download page for some
other free VMS goodies

DCL COMMAND FILES

(Note, for the sake of painless downloads, these files are named with .txt
extensions, you should rename them to .COM (obviously))

Available from this site:-

        * DCLWILD.COM. Processes wildcard RENAMEs etc.
        * MASS_EDIT.COM. Executes bulk interactive or automated edits"
        * MASS_REPLACE.COM. Executes bulk find-and -replace edits"

These DCL command files are made available freely by Yezerski Roper. You
are welcome to take copies and distribute them provided you leave all
references to YRL in the headers intact.

These files are provided "as is", that is Yezerski Roper cannot accept any
responsibility for any problems you may experience. That said, we welcome
any feedback or suggestions for improvements. Send all such comments to
jaf@yrl.co.uk.

DCLWILD

     Get a copy of DCLWILD.TXT by viewing then using file save on this
     link.

     This command file performs wildcard operations on DCL commands
     that require an input filespec and output filespec as the first
     two arguments. In practice this is usually COPY and RENAME.

     The syntax is

          DCLWILD <dcl-command> <in-spec> <out-spec> <
          qualifiers>

     Examples

          DCLWILD RENAME *1*2*3*4*.* *4*3*2*1*.* /confirm

          DCLWILD COPY *OLD.DAT *NEW.DAT /log

     Arguments

          dcl-command

               The DCL command to be used. Usually RENAME or
               COPY

          in-spec

               The input filespec. Wildcards using * are
               supported whilst those using % are not.

          out-spec

               The output filespec. If this isn't broadly
               similar to the input spec (in terms of number
               and location of '*'s) unexpected results may
               occur

          qualifiers

               Qualifiers to be added to the DCL command. We
               reccomend /CONFIRM whilst you're learning how
               to use the command.

               Make sure you leave white space between this
               and the out_spec, since these are being
               passed into a DCL command file.

     This command file makes use of two subroutines which you may wish
     to extract separately, namely

          CHANGE_WILD <In_wildcard> <out_wildcard> <input_string>
          <symbol_name>

     and

          MATCH_WILD <wildcard> <Test_string> <symbol_name>

     both use global symbols to return values to the calling command
     file.

MASS_EDIT

     Get a copy of MASS_EDIT.TXT by viewing then using file save on
     this link.

     Command file that invokes an edit session for each file in a
     filespec it turn. Only really useful for automated edits, or for
     when you want to edit a number of files and don't want to have to
     keep doing a DIR to see where you're up to.

     The global symbol DEFAULT_EDIT defines the editor that will be
     invoked, this defaults to "EDIT/EDT" if not defined.

     Arguments

          Filespec or @filename

               The filespec of the files to be edited, or
               the name of a file containing the list of
               files to be edited (one per line).

               This last can be useful if you want to edit
               all files containing a particular string.
               Simply use SEARCH/OUT and tidy up the output
               file

          command file

               (optional) The name of an EDT command file to
               be used. Only useful if your DEFAULT_EDIT
               command is EDT.

          PROMPT

               (optional) Should you be prompted before each
               file. The prompt will offer Y/N/A/Q options.

          RECOVER

               (optional) is a RECOVER edit wanted. This
               isn't fully tested and probably shouldn't be
               used.

MASS_REPLACE

     Get a copy of MASS_REPLACE.TXT by viewing then using file save on
     this link.

     MASS_REPLACE performs bulk find and replace edits. It does this
     by using SEARCH to locate files containing the strings you want,
     creating an EDT command file, and then executing the MASS_EDIT
     subroutine to perform the changes.

     Arguments

     When run the command file prompts you for the following:

          Filespec

               The set of files to be searched

          Omit filespec

               Any files to be left unchanged. .EXEs etc are
               naturally excluded.

          Delimiter

               The delimiter to be used in the EDT SUBS
               command. This should not be contained in any
               of the search strings. In the future this may
               be automatically selected.

          Search string

               The string to be replaced

          Replacement string

               The...er... replacement string.

     These last two questions will be repeated until you hit RETURN on
     the search string. This allows multiple replaces to be done at
     the same time.

     MASS_REPLACE will prompt you before it performs each edit.

---------------------------------------------------------------------------
Visit Yezerski Roper's home page or our download page for some other free
VMS goodies
Last modified: 24-Nov-1997