IBM Support

Finding the master replica name for a ClearCase element

Question & Answer


Question

How do I identify the IBM® Rational® ClearCase MultiSite® mastership information for an element?

Answer

You can find the Master Replica Name using the following command:

cleartool describe -fmt "%[master]p %n"



Be sure you are specific about what object you are requesting mastership for as not all objects have mastership information.

You must use the @@ (version extended pathname symbols) after the file name so that the ClearCase process checks against the element object itself and ignores the version selected by the version extended pathname of the config spec.

Review the ClearCase Developing Software manual on the topic of About element object and version references for more information.


Correct syntax:

Example:


M:\General_View\General_Test>cleartool describe -fmt "%[master]p %n" file1.txt@@
Vob_replica@\General_Test file1.txt@@

Note: The output correctly lists a VOB. This VOB is the Master Replica of the element.


Incorrect syntax:

If you do not specify the element with the @@ in the command, the output will be incorrect.

Example:
M:\Test_view\gui>cleartool describe -fmt "%[master]p %n" makefile.txt
makefile.txt@@\main\GUI_Stirling_Integration\3    

Note: This is clearly not the name of the Master Replica. There is no Master Replica information for file versions, only for elements or branches.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Mastership","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.0.1;7.0;2003.06.16;2002.05.00","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21289563