Displaying Mastership Information for VOB Objects


The following sections describe how to list the master replica of an object, list all objects mastered by a particular replica, list the mastership changes for an object, and display settings for mastership requests.

Listing an Object’s Master Replica

To list an object’s master replica, use one of the following methods:

Method
Description
Mastership page in the Properties Browser (Windows)
This page lists the object’s master replica.
cleartool describe object-selector
This command lists general information about the object, including its master replica.
cleartool describe –fmt "%[master]p\n" object-selector
This command lists only the master replica of the object. For more information about the –fmt option, see the fmt_ccase reference page in the Command Reference.

Command examples:

Listing Objects Mastered by a Replica

The lsmaster command lists the objects mastered by a VOB replica. The command uses the information at your current replica unless you use the –inreplicas option, which retrieves information from sibling replicas.

For more information and examples, see the lsmaster reference page.

Listing the History of Mastership Changes for an Object

The lshistory –minor command and the History Browser (with the Include minor events toolbar icon selected) list mastership changes for an object. For example, to list the history of a replica:

cleartool lshistory –minor replica:bangalore@/vobs/dev 
20-Sep.17:43   susan      change master to "bangalore" of replica 
"bangalore"
"Changed master replica from "boston_hub" to "bangalore"."
...

Displaying Mastership Request Settings

The settings for mastership requests controls whether developers at other replicas can request mastership of branches or branch types mastered by the replica. The describe command and (on Windows) the Mastership page in the Properties Browser display mastership request settings for replicas, branch types, and branches. For more information about mastership requests, see Implementing Requests for Mastership.