Automatically locking specific file types

You can automatically lock specific file types when they are edited by associating one or more file patterns with a stream. The deliver, suspend, resume, discard and undo operations can release or acquire locks. The preferences for these operations can be set to prompt for action, release locks, or hold locks.

About this task

After you specify file patterns to automatically lock in a particular stream, any workspaces that specify that stream as their default flow target require the files that match the pattern to be locked before they can be edited. When you edit a file for the first time, you are prompted to acquire the lock on that file. If the file is locked by someone else, you receive a message that the lock was not obtained, but you can continue to edit the file.
Note: The automatic locking may not work for file types that require a third-party editor.


  1. In the Team Artifacts view, navigate to your project area; right-click Source Control, and click Open.
  2. In the Stream editor, in the Auto-lock files area, type the file name patterns for files that are automatically locked.
  3. Click Save.
  4. Optional: To configure prompting preferences for automatically locked files:
    1. From the main menu bar, click Window > Preferences.
    2. Expand the Team entry, expand Jazz Source Control, and click Notification Dialogs.
    3. On the Notification Dialogs page, select the applicable actions for locked resources and click OK.