Click above to get retro games delivered to your door ever month!

 AX_UserLockID()
 Returns the connection number of the station that has a record locked
------------------------------------------------------------------------------

 Syntax

     AX_UserLockID( [<nRecordNumber>] ) -> numeric

     <nRecordNumber>  An optional record number to obtain the connection
     number.  If no record number is given, the current record number is
     used.

 Returns

     Returns a numeric value representing the NetWare connection number
     of the workstation which has a record locked with Advantage.

 Description

     AX_UserLockID() is used to return the NetWare connection number of
     the client workstation that has the optionally specified
     <nRecordNumber> locked by an Advantage user in the current work area.
     If the record is not locked by an Advantage user, -1 is returned.

     If an Advantage user has a file lock, this implies that the record is
     locked, and the appropriate NetWare connection number is returned.

     If AXS LOCKING is turned OFF, this function will not see locks by
     other third party applications, such as CA-Clipper or FoxPro.  For
     instance, if a CA-Clipper application has a record locked in a
     table that Advantage has open, AX_UserLockID() will return
     a -1 for that record in the Advantage application.

     Note:  AX_UserLockID() does not work with the Advantage Database
     Server for Windows NT.  Since Windows NT does not have the concept of
     connection numbers associated with users who are accessing the server,
     no connection number is available to be returned from this function.

 Example

     USE test VIA "DBFNTXAX" NEW SHARED

     IF ( Rlock() )
        ? "Connection with record locked is", AX_UserLockID()
     ENDIF