copy [From=]infile [To=]outfile [option]*
(+|-)All (-) (+|-)CHeck (+) (+|-)CreateCatalogs (-) (+|-)Equivalent (+) (+|-)New (+) (+|-)Old (+) (+|-)Stop (+) (+|-)Verbose(+) Size=number indeX=filename
copy .h another/.h <-- copies your .h to another/.h copy .h another/ <-- copies your .h to another/.h copy another from=.h <-- copies your .h to file another copy another/.h / <-- copies another/.h to your /.h
compared N llinks of text
infile1 outfile1 infile2 user/cat/outfile2 +cc +v infile3 outfile3 s=30
If you specify an index file for a COPY command, the command line itself may not contain "[From=]infile" or "[To=]outfile". Any other options on the command line are taken as defaults for all copy operations specified by the index file; individual lines in the index file may specify options to override the defaults on the command line.
COPY copies "infile" into "outfile"; "infile" is not disturbed. COPY attempts to determine the contents of the file and to copy the actual amount used. COPY recognizes GFRC files, Hstar files, and Ranedit libraries. For all other file formats, the full file contents are copied.
You can copy a selected portion of a file using the Size= option. If you want to copy GFRC files with multiple EOF marks, specify +All; otherwise only the data up to the first EOF mark will be copied.
If "outfile" is the name of a catalog rather than a file, or if "outfile" ends in a "/" (for cases where it could be ambiguous), COPY places the output under that catalog in a file with the same name as "infile". For example,
copy cat1/abc cat2/
creates "cat2/abc".
By default, if "outfile" already exists, COPY overwrites the current contents; if the file doesn't already exist, COPY creates one. In other words, the default is "+Old +New". Using -Old tells COPY not to overwrite old files, and using -New tells COPY not to create a new file if an old one doesn't exist. +New automatically changes the default for the Old option to -Old. Similarly, +Old changes the default for the New option to -New.
If the output file does not already exist and +New is in effect, COPY creates a file of the given name. If this is a permanent file, COPY will create it with the usual general read permission, and read-while-write access mode.
Due to a design flaw in TSS, COPY cannot create an output temporary file of the same name as an input permanent file. If you want to copy a permanent file to a temporary file of the same name, create the temporary file before calling COPY.
Using an index file is generally much faster than executing the same copy operations as separate COPY commands.
Copyright © 1996, Thinkage Ltd.