[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 UNLOCK
 Release file/record locks set by the current user
------------------------------------------------------------------------------
 Syntax

     UNLOCK [ALL]

 Arguments

     ALL releases all current locks in all work areas.  If not specified,
     only the lock in the current work area is released.

 Description

     UNLOCK is a network command that releases file or record locks set by
     the current user.  Use it when you want to release the current lock
     without setting a new lock.  Both FLOCK() and RLOCK() release the
     current lock before setting a new one.

     After an UNLOCK, an update to a shared database file and associated
     index and memo files becomes visible to DOS and other applications, but
     is not guaranteed to appear on disk until you perform a COMMIT or close
     the file.

     Refer to the "Network Programming" chapter in the Programming and
     Utilities Guide for more information on the principles of locking and
     update visibility.

 Notes

     .  SET RELATION: UNLOCK does not automatically release a record
        lock along a RELATION chain unless you UNLOCK ALL.

 Examples

     .  This example attempts an update operation that requires a
        record lock.  If the RLOCK() is successful, the record is updated
        with a user-defined function and the RLOCK() is released with UNLOCK:

        USE Sales INDEX Salesman SHARED NEW
        IF RLOCK()
           UpdateRecord()
           UNLOCK
        ELSE
           ? "Record update failed"
           BREAK
        ENDIF

 Files   Library is CLIPPER.LIB.


See Also: DBUNLOCK() DBUNLOCKALL() FLOCK() RLOCK() SET RELATION
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson