Download VERY LARGE TELESCOPE

68
HOS/Sequencer User Manual - 3
VLT-MAN-ESO-17220-0737
seq_dbLockPoint(n)
NAME
seq_dbLockPoint, seq_dbUnlockPoint - lock/unlock a database point
SYNOPSIS
seq_dbLockPoint <pointName> ?<timeout>?
seq_dbUnlockPoint <pointName>
DESCRIPTION
seq_dbLockPoint:
will lock a single point in the database.
<pointName> : symbolic name or alias of the point to lock
<timeout>
: number of seconds the point will be locked (range: 3 to
60); default: 3
The point will remain locked for <timeout> seconds, unless a
seq_dbUnlockPoint command is given before the timeout expires
seq_dbUnlockPoint:
will unlock a locked database point.
ENVIRONMENT
no environment nor Tcl variables are read nor set
RETURNVALUES
OK return if no errors occurred. The result string is empty.
ERROR return if one of the following conditions is met (with corresponding
error message here between quotes):
- "wrong # args : should be "seq_dbLockPoint <pointName> ?<timeout>?":
the command was given with the wrong number of arguments;
- "wrong # args : should be "seq_dbUnlockPoint <pointName>": the command
was given with the wrong number of arguments;
- error message left by Tcl_GetInt applied on <timeout>;
- "cannot lock point "<pointName>": dbLockPoint returned an error for
this argument
- "cannot unlock point "<pointName>": dbUnlockPoint returned an error
CAUTIONS
If the point is already locked, this command will hang until the point
has been released.
EXAMPLES
(For clarity's sake, the example is for an interactive session with
input typed by the user coming after the "seqWish>" prompt, and all
replies on a new line)
.....
seqWish>seq_dbLockPoint "<alias>eric"
seqWish>seq_dbread "<alias>eric.my scalar"
199.5
seqWish>seq_dbUnlockPoint "<alias>eric"
seqWish>.....