Lock Business Object

A business object can be locked using either the Lock command or the Checkout command.

The Checkout command is used to copy files from an object (for more information, see Checkout Business Object). The Lock command is used for general locking purposes.

If locking is enforced in the policy, the lock must be part of the checkout command. Attempts to use the lock command will fail.

The Lock command places a lock on a business object:

lock businessobject OBJECTID;

  • OBJECTID is the OID or Type Name Revision of the business object.

When this command is used, MQL checks to see if you have locking privileges and if there is an existing lock on the object. If you have privileges and there is no existing lock, a lock is applied to the object. (Otherwise, an error results.) After the lock is applied, only you or someone operating in your context can edit the object contents.

For example, the following commands restrict to Barbara the editing of the “Box Design” object “Bran Cereal:”

set context user Barbara password “Van Gogh”;
lock businessobject “Box Design” “Bran Cereal” A;

The first command sets the context and identifies the person placing the lock. The second command applies the lock to the object. Unless Barbara or someone with unlocking privileges removes the lock, no one else can alter the object’s contents.