# RLOCK()

Lock a record in a work area

Syntax

  RLOCK() --> lSuccess

Arguments

  None

Returns

  RLOCK() True (.T.) if record lock is successful; otherwise, it returns false (.F.).

Description

  This function returns a logical true (.T.) if an attempt to lock a specific record in a selected or designated work area is successful. It will yield a false (.F.) if either the file or the desired record is currently locked. A record that is locked remains locked until another RLOCK() is issued or until an UNLOCK command is executed. On a Network enviroment the follow command need that the record is locked:
  @...GET
  DELETE (single record)
  RECALL (single record)
  REPLACE (single record)

Examples

          nId:=10
          USE TestId INDEX TestId NEW
          IF TestId->(DBSEEK(nId))
             IF TestId->(RLOCK())
                DBDELETE()
             ENDIF
          ENDIF
          USE

Status

  Ready

Compliance

  This function is Ca-Clipper compliant

Files

  Library is rdd

See Also

- FLOCK()