To check out the branch using the command line before mastership is transferred

About this task

If you can merge versions of the element you need to check out, you can work on the file while you wait for mastership to be transferred to your replica.

Windows tip: You can also check out the branch before mastership is transferred using the graphical interface.

Procedure

  1. Enter a reqmaster command for the branch you need to check out.
    • On the UNIX system and Linux:
      
cleartool reqmaster -c "fix bug #28386" prog.c@@/main/integ 

prog.c@@/main/integ: Change of mastership at sibling replica 
"lib_lex" was successful.
Mastership is in transit to the new master replica.
    • On Windows systems:
      
cleartool reqmaster -c "fix bug #28386" prog.c@@\main\integ 

prog.c@@\main\integ: Change of mastership at sibling replica 
"lib_lex" was successful.
Mastership is in transit to the new master replica.
  2. Use cleartool checkout -unreserved -nmaster to perform a nonmastered checkout.
    • On the UNIX system and Linux:
      
cleartool checkout -c "fix bug #28386" -unreserved -nmaster \
prog.c@@/main/integ
    • On Windows systems:
      
cleartool checkout -c "fix bug #28386" -unreserved -nmaster ^

More? prog.c@@\main\integ
  3. Make changes to the element.
  4. Wait for mastership to be transferred to your current replica. To list the master replica of a branch, use the describe command:
    • On the UNIX system and Linux:
      
cleartool describe /vobs/lib/prog.c@@/main 

branch "/vobs/lib/prog.c@@/main"
  created 15-May-99.13:32:05 by nlg.user
  branch type: main
  master replica: lib_london@/vobs/lib
...
    • On Windows systems:
      
cleartool describe \lib\prog.c@@\main 

branch "\lib\prog.c@@\main"
  created 15-May-99.13:32:05 by nlg.user
  branch type: main
  master replica: lib_london@\lib
...
  5. Check in the element. If the checkin succeeds, you are finished.
    • On the UNIX system and Linux:
      
cleartool checkin -nc prog.c 
Checked in "prog.c" version "/main/65".
    • On Windows systems:
      
cleartool checkin -nc prog.c 
Checked in "prog.c" version "\main\65".
    If the checkin fails because you have to perform a merge, proceed to Step 6:
    • On the UNIX system and Linux:
      
cleartool checkin -nc prog.c 

cleartool: Error: The most recent version on branch "/main" is not 
the predecessor of this version.
cleartool: Error: Unable to check in "prog.c".
    • On Windows systems:
      
cleartool checkin -nc prog.c 

cleartool: Error: The most recent version on branch "\main" is not 
the predecessor of this version.
cleartool: Error: Unable to check in "prog.c".
  6. Merge from the latest version on the branch to your checked-out version.
    • On the UNIX system and Linux:
      
cleartool merge -to prog.c -version /main/LATEST 

(if necessary, you are prompted to resolve conflicts) 
Moved contributor "prog.c" to "prog.c.contrib".
Output of merge is in "prog.c".
Recorded merge of "prog.c".
    • On Windows systems:
      
cleartool merge -to prog.c -version \main\LATEST 

(if necessary, you are prompted to resolve conflicts) 
Moved contributor "prog.c" to "prog.c.contrib".
Output of merge is in "prog.c".
Recorded merge of "prog.c".
  7. Check in the element.