Troubleshooting commands

To determine which replica masters a branch or branch type:

• Use the cleartool describe command. For example:

  cleartool describe –fmt "%[master]p\n" file1.txt@@\main
  boston_hub@\dev
  

  cleartool describe –fmt "%[master]p\n" brtype:main@/vobs/doc
  boston_hub@/vobs/doc
  

• (Windows®) Display properties of the branch or branch type and click the Mastership tab.

To determine whether a mastership request will succeed:

• Use reqmaster –list (see Status messages for descriptions of the output):

  multitool reqmaster –nc –list file1.txt@@/main
  multitool: Error: The following errors will be encountered
  multitool: Error: file1.txt@@/main
  Request Mastership remote "reqmaster" operation (host "taronga") would fail:
  You do not have permission to request mastership from the sibling replica.
  

• (Windows®) In the Request Mastership window, click Preview Request for Mastership.

To list the event history of a branch or branch type and determine who has requested its mastership, use the lshistory –minor –fmt command:

cleartool lshistory –min –fmt "%n\t%o\n%c" file.fm@@/main
file.fm@@/main chmaster
Reqmaster changed master replica from "boston_hub" to "buenosaires".
Requester: user "PURPLEDOC\fangio" in domain "PURPLEDOC" on host "mardelplata"
file.fm@@/main chmaster
Reqmaster changed master replica from "tokyo" to "boston_hub".
Requester: user "PURPLEDOC\susan" in domain "PURPLEDOC" on host "minuteman"
file.fm@@/main chmaster
Reqmaster changed master replica from "bangalore" to "tokyo".
Requester: user "PURPLEDOC\masako" in domain "PURPLEDOC" on host "shinjuku"
file.fm@@/main chmaster
Reqmaster changed master replica from "sanfran_hub" to "bangalore".
Requester: user "PURPLEDOC\kumar" in domain "PURPLEDOC" on host "ramohalli"
...

cleartool lshistory –min –fmt "%n\t%o\n%c" brtype:main@/vobs/doc
main chmaster
Reqmaster changed master replica from "sanfran_hub" to "boston_hub".
Requester: user "PURPLEDOC\susan" in domain "PURPLEDOC" on host "minuteman"
main chmaster
Reqmaster changed master replica from "tokyo" to "sanfran_hub".
Requester: user "PURPLEDOC\jcole" in domain "PURPLEDOC" on host "goldengate"
main chmaster
Reqmaster changed master replica from "bangalore" to "tokyo".
Requester: user "PURPLEDOC\masako" in domain "PURPLEDOC" on host "shinjuku"
...