COPYTHEM: masked copy utility

Description

Masked copy utility. Files or libraries can be selected using "wild card" characters. All files are combined onto a single disk volume.

Categories

Disk Management
System Operation

Related files

COPYTHEM: Object file for the program.

COPY: The Wang COPY utility is called by the program to copy files.

User Instructions

'Wild-card' copy utility. Like the FIND subroutine and its derivatives (such as FILEDISP), COPYTHEM allows the use of the '?' characters to indicate unknown elements in a file, library, or volume name. All files meeting the name criteria are copied onto a single output volume; optionally, prior copies on the destination volume can be scratched before the copy.

The files to be copied are specified using any combination of known and unknown values. As with other programs using the FIND subroutine, the question mark ('?') represents any combination of characters (or no characters) and the asterisk ('*') represents any single unknown character. COPYTHEM will find all files meeting these specifications and attempt to copy them to the output volume.

After the file name specification is made, a screen display shows the number of files meeting the requirements and which is currently being copied. If no files meet the requirements an appropriate screen message will appear. When the copy is complete, the user may choose to run again or exit the program.

Programmer Instructions

The input screen is the only GETPARM in the program, and can be run under program control. Due to use of the screen for run statistics, COPYTHEM cannot be used in non-interactive (background) procedures.

INPUT       Press (RETURN) to continue or PF(16) to exit the
            program.

  FILE      (blank)     The names and locations of files to
  LIBRARY   (blank)     be copied.  May contain masking
  VOLUME    (blank)     characters similar to those used by
                        FIND.

  OUTVOL    [outvol]    The output volume for the copy.  Note
                        that file and library names will be
                        retained.

  SCRATCH   NO          Set to YES to scratch conflicting
                        files on the output volume.

Example of use

This program will gather files from any part of the system by name or name root. Could be used for system installations or other purposes where multiple files are to be consolidated.

Comments

Good general-purpose copy utility. Use FILEDISP to predict the files that will be copied and check your file name specifications.