COPYFILE [ HPTOOLSET XL Reference Manual ] MPE/iX 5.0 Documentation
HPTOOLSET XL Reference Manual
COPYFILE
Copies a named TSAM file into a new TSAM file in the current Workspace.
Syntax
COPYF[ILE] [filename1[version range][|TO|filename2[N[EWVERSION]]]
Parameters
Filename1 Name of the file to be copied.
Version Range Indicates the range of versions of filename1 which you
want to copy. By default, all versions of filename1
will be copied. Unless versions have been purged from
the old file, it is faster to COPYFILE all versions than
it is to copy a range of versions. Takes the form:
#n[/#n] where n is an integer, L[ATEST], or R[EFERENCE].
Filename2 Name of the file into which you want to copy. It must
be a new file. If a file already exists with this name,
you will be asked if it is OK to purge it.
NEWVERSION Is an optional parameter that renumbers the active
versions in filename2 sequentially, starting with
version 1.
Description
You can copy specific versions of a file or the entire file. If you copy
the entire file, identical versions will exist at both the source and
destination locations.
The COPYFILE command is a way of establishing ownership of a file that
belongs to another workspace. It puts a copy of the file in your
workspace, thus allowing you to own that file. Any file that is copied
must be in TSAM format.
Example
>>COPYFILE OLDFILES#5 TO NEWFILE NEWV
Copies the contents of version 5 of OLDFILE to a new file named NEWFILE.
The new file has one active version. It is version #1 because the
NEWVERSION parameter is specified.
MPE/iX 5.0 Documentation