[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 DBRECALL()
 Reinstate a record marked for deletion
------------------------------------------------------------------------------
 Syntax

     DBRECALL() --> NIL

 Returns

     DBRECALL() always returns NIL.

 Description

     DBRECALL() causes the current record to be reinstated if it is marked
     for deletion.

     DBRECALL() performs the same function as the RECALL command.  For more
     information, refer to the DELETE and RECALL commands.

 Notes

     .  Logical records: Reinstating a deleted record affects the
        record's logical visibility if the global _SET_DELETED status is true
        (.T.).  For more information, refer to the DBDELETE() function and
        the DELETE and RECALL commands.

     .  Network environment: For a shared database on a network,
        DBRECALL() requires the current record to be locked.  For more
        information, refer to the "Network Programming" chapter in the
        Programming and Utilities Guide.

 Examples

     .  The following example recalls a record if it is deleted and
        attempts to lock the record if successful:

        cLast := "Winston"
        DBUSEAREA( .T., "DBFNTX", "Sales", "Sales", .T. )
        DBSETINDEX( "LASTNAME" )
        //
        IF ( Sales->(DBSEEK(cLast)) )
           IF Sales->( DELETED() )
              IF Sales( RLOCK() )
                 Sales( DBRECALL() )
                 ? "Record recalled"
              ELSE
                 "Unable to lock record..."
              ENDIF
           ENDIF
        ELSE
           ? "Not found"
        ENDIF

 Files   Library is CLIPPER.LIB.


See Also: DBDELETE() DELETE RECALL
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson