Makes a copy of an existing type object.
ClearCase (cleartool subcommand), Attache (command)
The cptype command creates a new type object (for example, a label type or attribute type) that is a copy of an existing type object. The existing and new objects can be in the same VOB, or in different VOBs. The copy can have the same name as the original only if you are making the copy in a different VOB.
The original and copy do not retain any connection after you execute cptype. They are merely two objects with the same properties, and perhaps even the same name.
EXCEPTION: Global types are handled differently. For more information, see Administering ClearCase.
When you copy an ordinary type object to a VOB that is part of an AdminVOB hierarchy, ClearCase determines whether the new type name is already defined as a global type in the administrative VOB of the copy's destination VOB. If it is, cptype fails with an explanatory message. When this is the case, you can do one of the following things:
The cptype command recursively copies the supertypes of the original type to the copy's destination VOB.
When you copy a type, the cptype command fires any mktype triggers attached to the destination VOB.
When you copy a type from one VOB replica to another, using the same name as that of the original type, the replica where the original type resides must master that type; otherwise, cptype fails with an explanatory message. This behavior ensures that mastership of the type is consistent throughout replicas in the VOB family.
Permissions Checking: Creating a copy of an existing type object requires the same permissions as are required to create the original type object. Refer to the descriptions of the type-object creation commands (mklbtype, mkattype, and the like) and the permissions reference page.
Locks: An error occurs if the VOB of the new object is locked. With the -replace option, an error occurs if the type object being replaced is locked.
EVENT RECORDS AND COMMENTS. Default: Creates one or more event records, preserving the comment associated with the original type. Any new comment you specify is appended to the preserved comment. (The file .clearcase_profile defines default commenting behavior; you can also edit comments using chevent.)
REPLACING AN EXISTING TYPE OBJECT. Default: An error occurs if new-type-selector already exists.
SPECIFYING THE EXISTING AND NEW TYPE OBJECTS. Default: None.
type-kind | One of | |
type-name | Name of the type object See the Object Names section in the cleartool reference page for rules about composing names. | |
vob-selector | VOB specifier Specify vob-selector in the form [vob:]pname-in-vob | |
pname-in-vob | Pathname of the VOB-tag (whether or not the VOB is mounted) or of any file-system object within the VOB (if the VOB is mounted) | |
Examples including wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents the command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.
cmd-context cptype lbtype:RE1.3 REL1.4
cmd-context cptype -c "copied from source VOB" ^
brtype:proj_test3.7@\projsrc proj_test3.7@\projtest
cmd-context cptype -replace trtype:label_it@\stage label_it@\dev
describe, lstype, mkhltype, profile_ccase, type_object
|
Feedback on the documentation in this site? We welcome any comments!
Copyright © 1999 by Rational Software Corporation. All rights reserved. |