Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

source-name

destination-name

wildcard table

Examples

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>

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026