CDD/Plus CDO COPY — VMS CDD+_4.1A
Copies an object and the relationships it owns from one CDO directory
to another or from one physical dictionary to another. You can also
use this command to copy an object and its relationships within the
same directory.
COPY ────┬─> source-name ──┬────────> destination-name ─────────>
└────── , <───────┘
Additional information available:
source-namedestination-namewildcard tableExamples
source-name
The name of the object to be copied. The source name can be a path name, directory name, or a name with wildcard characters. Wildcard characters can be used in either the source name or the destination name. See the subtopic "wildcard_table" for more information on using wildcards with COPY.
destination-name
The destination to which the object will be copied. The destination-name can consist of a path name, directory name, or a name with one wildcard character. If you specify only the asterisk(*) wildcard, the object is copied into your current default CDO directory and keeps the same name. If you specify a directory name only, the object is copied into that CDO directory and keeps the same name. If you specify a directory name and a new name for the object, the object is copied into that directory and is given the name you specified. See the subtopic "wildcard_table" for more information on using wildcards with COPY.
wildcard table
The following table shows how to use wildcard characters correctly in
the source name and destination name when using the COPY command. The
left column entitled "If Source Name Includes" shows the five types of
valid source names. The other four columns under "The Destination Name
Can Include" header show the four types of valid destination names. To
use the table, find the type of source name you are using in the left
column, then go across that row in the table to determine the valid
destination names for that type of source name. A "T" in the table
means that the type of destination name is valid for the source name,
while an "F" means that the type of destination name is illegal for the
source name.
For example, if your source name contains one asterisk, look under the
"If Source Name Includes" column for the row entitled "Asterisk(*)".
In the "Asterisk(*)" row, two of the four columns under "The
Destination Name Can Include" have a "T", meaning that these are valid
destination names for a source name that has one asterisk. In this
example, the "T" in the "One Asterisk" column and the "Ellipsis" column
means that for a source name with one asterisk, using one asterisk or
an ellipsis is legal in the destination name. The "F" under the "More
Than One Asterisk" column and the "No Wildcard Characters" column means
that for a source name with one asterisk, using more than one asterisk
or no wildcard characters is illegal in the destination name.
If Source Name Includes: The Destination Name Can Include:
One More Than No Wildcard
Asterisk One Asterisk Ellipsis Characters
Asterisk(*) T F T F
More Than One Asterisk T F T F
Percent(%) T F T F
Ellipsis(...) T F T F
No Wildcard Characters T F T T
In addition to the information in this table, the following rules apply
to the use of wildcards in the COPY command:
o If you use a wildcard character in the source name, then you must
use a wildcard character in the destination name.
o You can use only one wildcard character in the destination name.
o You can use only one ellipsis in the source or destination name.
o You can only use multiple asterisks(*) in the source name.
o You can only use the percent sign(%) in the source name.
Examples
The following command copies the record definition BADGE_NUMBER into the current default directory: CDO> COPY DISK1:[JONES.DICT]CORPORATE.BADGE_NUMBER * CDO> The following command copies the field definitions LAST_NAME and FIRST_NAME into the [JONES.DICT]PERSONNEL directory: CDO> COPY DISK1:[JONES.DICT]CORPORATE.LAST_NAME, FIRST_NAME cont> DISK1:[JONES.DICT]PERSONNEL.* CDO> The following command copies the record definition ADDRESS into the [BOB.DICT]PERSONNEL directory and gives it a new name, EMPLOYEE_ADDRESS: CDO> COPY CORPORATE.ADDRESS [BOB.DICT]PERSONNEL.EMPLOYEE_ADDRESS CDO> The following command copies the field definition LAST_NAME from the DISK1:[JONES.DICT]PERSONNEL directory to the DISK2:[BOB.SHOP]WORKERS directory: CDO> COPY DISK1:[JONES.DICT]PERSONNEL.LAST_NAME cont> DISK2:[BOB.SHOP]WORKERS.LAST_NAME CDO>