Locking and Unlocking an Item

Before downloading a file or editing item properties, you can exclusively lock the file or item to inform other team members that you intend to make changes. You can lock or unlock items manually, as described below, or set lock status options globally in the Options dialog box.

Exclusively locking an item prevents others from creating new revisions of it before the lock has been released. If an item is exclusively locked by someone else, you can review its properties but cannot change them. The Item Editor title bar will include the words Read Only and the name of the user who has locked the item.

To lock or unlock an item, perform the following steps:

  1. Browse to the item.
  2. In the Item Table, select the item record.
  3. Click Lock/Unlock... (GUID-703B469E-192A-4594-A268-8B26EF5913EF-low.png) on the Item Table toolbar. A dialog box opens.
  4. Select a lock status option:
    Unlocked
    Removes your exclusive or non-exclusive lock on the selected item.
    Exclusive
    Prevents others from creating new revisions of this item until you release the lock or another person breaks your lock.
    Non-exclusive
    Indicates that you are working on the item and may possibly make changes. This option is not recommended for items other than files.
    Break existing lock
    Breaks another team member's lock on the item. If email is enabled, StarTeam will send an automatic notification to the team member whose lock has been broken.
    Note: You must be granted the appropriate privileges to be able to break another person's locks.
  5. Click OK.