Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Why Process Commander locks work objects

Updated on September 13, 2021


A developer asks: While testing our application, I opened a work object , but the display indicated that the work object was locked. Why?

Suggested Approach

Whenever you open a work object in a modifiable mode, such as the Perform form, your requestor acquires a system lock so that no one else can alter the work object until you are done with it. If you lose your session while such a form is presented, for instance by closing the browser window, or if your session times out from inactivity, the lock is later released, normally one hour after the time the lock was established.

Locking can arise from three sources:

  • The most common reason a work object is locked is that someone else is working on it. The Lock form indicates who has the object locked.
  • The next most common reason is that you were working on this work object earlier, but then your session timed out or you lost the browser -- and the time since this occurred is still within the one hour that the lock is held. In this case, you can click the Release Lock button at the bottom of the form.
  • Rarely and briefly, a work object is locked by the operator System. This occurs when an assignment on that work object has reached its goal, deadline, or late time, and the Pega-ProCom agent locks the work object for a short time to process the service level event. If you receive such an indication that a work object is locked by the system, just close the Lock form and try again.


Pega Platform 7.1.1 - 8.3.1 System Architect Lead System Architect Business Architect Experience Designer Pega Delivery Leader System/Cloud Ops Administrator Case Management Financial Services Healthcare and Life Sciences Insurance Communications and Media Government Healthcare and Life Sciences Consumer Services

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us