Last modified: December 2013

URL: https://cxc.cfa.harvard.edu/chips/ahelp/unlock.html
Jump to: Description · Example · Bugs · See Also


AHELP for CIAO 4.11 ChIPS v1

unlock

Context: server

Synopsis

Removes the lock on a server so that other clients may access it.

Syntax

unlock()

Description

ChIPS allows multiple clients to connect to a single server so that several different processes may share a single plot. Clients may lock the server to allow a series of commands to be issued without being interspersed with commands from other clients. When a client is finished issuing commands, it needs to release the lock on the server. This is done by issuing an unlock command from the client containing the lock.

The locking mechanism is a blocking lock: other clients which issue commands while the server is locked will hang until the lock is released. When the lock is released, the commands of the blocked clients are executed. If the client terminates (i.e. the user quits the application or shell), the lock is automatically released.


Example

chips> lock()
chips> limits(X_AXIS, 100, 150)
chips> unlock()

A lock command is issued by the server to prevent other clients from interrupting the sequence of commands issued by this client. The unlock command is then called to release the server for access by other clients.


Bugs

See the bugs pages on the ChIPS website for an up-to-date listing of known bugs.

See Also

server
check_server_exists, connect, create_server, disconnect, get_server_cwd, get_server_id, list_servers, lock