HP 3000 Manuals

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