OpenEdge Data Management: Database Administration

Reference : Other Database Administration Utilities : PROCOPY utility

PROCOPY utility
Copies an existing database.

Syntax
procopysourcedbnametargetdbname[newinstance][silent]

Parameters
sourcedbname
Speci es the database you want to copy. You cannot copy the database if you have a server running on it.
targetdbname
Speci es the structure le or the new database. If you specify a directory without a lename, PROCOPY
returns an error.
The value you specify can be any combination of letters and numbers, starting with a letter. Do not use ABL
keywords or special characters, such as commas or semicolons. The maximum length of targetdbname
varies depending on the underlying operating system. For speci c limits, see your operating system
documentation.
newinstance
Speci es that a new GUID be created for the target database.
silent
Suppresses the output of work-in-progress messages.
PROCOPY copies a source database to a target database. If the target database exists, it must contain at a
minimum the same type and number of storage areas and same extent types as the source database. However, the
number of extents in the storage areas of the target database do not need to match the number of extents in the
source database. PROCOPY will extend the existing extents in the target database to accommodate the possible
increase in size.
If a target database does not exist, PROCOPY creates one using an existing .st le in the target database
directory. If a .st le does not exist, PROCOPY creates the target database using the structure of the source
database and places all of the extents in the same directory as the target database .db le, even when the source
database resides in multiple directories.

Notes
If you do not supply the .db extension for databases, PROCOPY automatically appends it.
A target database must contain the same physical structure as the source. For example, it must have the same
number of storage areas, records, blocks, blocksize, and cluster size.
PROCOPY supports the use of internationalization startup parameters such as cpinternalcodepage
and cpstreamcodepage. See Database Startup Parameters for a description of each database-related
internationalization startup parameter.
Databases supplied in the install directory for this release, contain the eld for a database GUID, but the eld
contains the Unknownvalue(?) rather than a valid GUID. When PROCOPY is used to copy one of these
databases, the GUID eld of the target database is automatically set.
Copyright2015ProgressSoftwareCorporation.AllrightsReserved.
ProgressOpenEdgeRelease11.6