DSPINSTL will not automatically copy an older version of a file over a newer version when the Date/Time of the file to be copied is less recent than the Date/Time of the file to be replaced. Instead, it prompts the user to decide whether to replace the newer version of a file with the older one.

The :FILES command line is followed by one or more lines that name the files to be copied from the source directory and also the destination directory to which they are to be copied. The format of these lines is as follows:

<source file name> <destination directory pathname>

where:

<source file name> is the name of a file within the source directory that contains the DSP file. A source file can be packed or unpacked.

<destination directory pathname> can include a logical drive letter specification. The optional logical drive letter specification is always overridden by the system's startup drive. The destination directory path name is not a complete file name. This means that the source file is never renamed when it is copied.

Note: The special term %BOOTDRIVE% can be used to replace the startup drive letter in all DSPINSTL commands that allow path names to be specified. %BOOTDRIVE% is a special drive designator that indicates the drive letter on which the OS/2 system was started.

If a destination directory is provided, the file is copied to that directory. If no destination directory is provided and the source file is a packed file, the file is copied to the directory that is specified in the source file's pack header. If there is no corresponding directory on the drive, the directory is created. If no destination directory is provided and the source file is an unpacked file, then the file is copied to the current working directory.

The following examples illustrate DSP file command lines that can follow the :FILES keyword command line:

    :FILES   :MODE=PRIMARY
    IBMVGA32.DL@ %BOOTDRIVE%:\OS2\DLL
    BVHVGA.DLL %BOOTDRIVE%:\OS2|DLL


    :FILES  :MODE=PRIMARY  :MODE=DOS
    VVGA.SY@ %BOOTDRIVE%:\OS2\MDOS

Note: The @ sign (at sign) at the end of some of the source file names indicates that these are packed files (packed by the OS/2 PACK utility program).