RemoveLock

(Control Lock Manager)

Description: Removes a Control Lock from a tag.
Warning This statement is recommended for advanced users only.
Returns: Nothing
Usage: Script Only.
Function Groups:

(Control Lock Manager)

Related to:

AddLock | CanAddLock | CanControl (Control Lock Manager) | CanRemoveLock | GetLockLevel | RemoveLock |

Format: \ControlLockManager.RemoveLock(TagID, LockGUID[, Note, Custom, Timestamp, SessionID, AccountID, MachineID, Device, Auto])
Parameters:  
TagID
Required text. The unique ID of tag from which to remove the lock.
LockGUID

Required text. The lock record GUID of the lock.

To find the lock record use a statement such as AlarmManager.GetAlarmList(...). RemoveLock is not not designed to be user-friendly. Most users should use the 'Remove' button in the Alarm List widget.

Note
Optional text. A note to log following the release operation.
Custom
Optional. A structure of custom fields to log.
Timestamp
Optional timestamp. UTC timestamp of this event. Defaults to current time.
SessionID
Optional text. The ID of the session where this function was called. Defaults to the current security session.
AccountID
Optional text. The AccountID of the user removing the lock. Defaults to the user signed in at the station where this function is called.
MachineID
Optional text. The workstation's MachineID. Defaults to the workstation from which this function is called.
Device
Optional text. The name of the client device.
Auto
Optional Boolean. Set true for automatic lock removal.
Comments:

None

Example:

None available.