LockExpression allows you to control locking on the new record and may take one of the following values:

• 0 The last record is selected and no lock is applied.
• 1 The last record is selected and locked (if not already locked by another user).
• 2 Equinox selects the last record that is not already locked by another user and locks it.

If LockExpression is omitted, it defaults to zero.

Note that you only need to lock a record if you intend to edit its fields. If you only want to read values, it is not necessary to lock it.

Also note that an applied lock is automatically released when a new record is selected. However, if required, you may manually release the lock before changing records, using the Unlock statement.

After the statement is executed, the SysError system workarea is set to one of the following values:

• 0 The statement was executed successfully.
• 1 An error occurred.
• 2 This value is returned if LockExpression was set to 1, but the last record was already locked, ie the lock failed.