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: You must load a solution before you can automatically lock files that you open from the Sandbox Explorer window.
Note: In the Engineering Workflow Management Shell, you cannot automatically lock files or receive auto-lock notifications when you edit or save files.


  1. In the Team Artifacts window, 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 Tools > Options.
    2. Navigate to Source Control > Jazz Source Control and click Auto-locking.
    3. On the Auto-locking page, select the applicable actions for locking and click OK.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki