Lotus Domino Designer 8.5 Help - Locking documents and design elements

LOTUSSCRIPT/COM/OLE CLASSES

Locking documents and design elements
Locks permit you to synchronize multi-user access to documents and the following design elements: agents, forms, and views.

To permit locking in a database:

The database must have an administration (master lock) server. You can set and check the administration server with NotesACL.AdministrationServer.
Locking must be enabled. You can set and check locking through:

The following properties and methods manipulate locks:

NotesDocument	NotesAgent	NotesForm	NotesView
LockHolders	LockHolders	LockHolders	LockHolders
Lock	Lock	Lock	Lock
LockProvisional	LockProvisional	LockProvisional	LockProvisional
UnLock	UnLock	UnLock	UnLock

To apply a lock, call Lock or LockProvisional. The first parameter specifies the lock holder or holders, and defaults to the effective user. The LockHolders property returns the current lock holders.

A lock is:

Persistent if the administration server is available and Lock is called. If the administration server is not available and provisional locks are not permitted (second parameter to Lock is False), an error is raised.
Provisional if the administration server is not available, Lock is called, and the second parameter is True; or LockProvisional is called.

To serialize or otherwise limit access to a document or design element, apply Lock or LockProvisional and examine the return status:

True means either:
False means a lock is in effect and the effective user is not one of the lock holders.

The typical protocol is to proceed on True, and to exit or wait on False.

Locks are not supported in Web applications.

See Also

Accessing sessions

Glossary

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Glossary