To request mastership of a branch and wait for the transfer

At a command prompt, enter a cleartool reqmaster command for the branch you need to check out.

On the UNIX system or Linux:

cleartool reqmaster -c "add info re new operating systems" \
read_me_first.doc@@/main 
read_me_first.doc@@/main: Change of mastership at sibling replica 
"sanfran_hub" was successful.
Mastership is in transit to the new master replica.

On a Windows system:

cleartool reqmaster -c "add info re new operating systems" ^
More? read_me_first.doc@@\main
read_me_first.doc@@\main: Change of mastership at sibling replica 
"sanfran_hub" was successful. 
Mastership is in transit to the new master replica.

Wait for mastership to be transferred to your current replica. To list the master replica of a branch, use describe:
On a UNIX system or Linux:
```
cleartool describe read_me_first.doc@@/main 
branch "read_me_first.doc@@/main"
  created 15-May-99.13:32:05 by sg.user
  branch type: main
  master replica: boston_hub@/doc
...
```
On a Windows system:
```
cleartool describe read_me_first.doc@@\main 
branch "read_me_first.doc@@\main"
  created 15-May-99.13:32:05 by sg.user
  branch type: main
  master replica: boston_hub@\doc
...
```
In this example, your current replica is boston_hub in the VOB family \doc (on a UNIX system or Linux) or /doc (on a Windows system). The output of the describe command shows that boston_hub is the master replica of the branch, which means that you can check out the branch as reserved.
Perform a reserved checkout, edit the file, and check in your work.

Windows tip: Detailed information about requesting mastership from the graphical interface is available. You can request mastership from the Find Checkouts window, the Merge Manager, or the Version Tree Browser.

Parent topic: About sharing control of a branch with developers at other sites

To check out the branch using the graphical interface before mastership is transferred (Windows)

To request mastership after the checkout (Windows)

To set the default for nonmastered checkouts (Windows)

To set the default mastership assignment in the User Options window (Windows)

To troubleshoot requests for mastership

Feedback