# NETERR()

Tests the success of a network function

Syntax

  NETERR([<lNewError>]) --> lError

Arguments

  <lNewError> Is a logical Expression.

Returns

  <lError> A value based on the success of a network operation or function.

Description

  This function return a logical true (.T.) is a USE,APPEND BLANK, or a USE...EXCLUSIVE command is issue and fails in a network enviroment. In the case of USE and USE...EXCLUSIVE commands,a NETERR() value of .T. would be returned if another node of the network has the exclusive use of a file.And the case of the APPEND BLANK command, NETERR() will return a logical true (.T.) if the file or record is locked by another node or the value of LASTREC() has been advanced The value of NETERR() may be changed via the value of <lNewError>. This allow the run-time error-handling system to control the way certains errors are handled.

Examples

          USE TEST NEW Index Test
          If !NetErr()
              Seek Test->Name="HARBOUR"
              If Found()
                 ? Test->Name
              Endif
          Endif
          USE

Status

  Ready

Compliance

  This function is CA Clipper compliant

Files

  Library is rdd

See Also

- FLOCK()
- RLOCK()