[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 DBAPPEND()
 Append a new record to the database open in the current work area
------------------------------------------------------------------------------
 Syntax

     DBAPPEND([<lReleaseRecLocks>]) --> NIL

 Arguments

     <lReleaseRecLocks>  is a logical data type that if  true (.T.),
     clears all pending record locks, then appends the next record.  If
     <lReleaseRecLocks> is false (.F.), all pending record locks are
     maintained and the new record is added to the end of the Lock List.  The
     default value of <lReleaseRecLocks> is true (.T.).

 Returns

     DBAPPEND() always returns NIL.

 Description

     DBAPPEND() is a database function that lets you add records to the
     current database.  The enhancement to this function lets you maintain
     multiple record locks during an append.

     DBAPPEND() without a parameter as in earlier versions of CA-Clipper,
     clears all pending record locks prior to an append.  This is the same as
     DBAPPEND(.T.).

 Examples

     .  This example appends a blank record to the database, Sales,
        without releasing the record locks in the current Lock List, and then
        checks for a network error:

        USE Sales NEW
        SET INDEX TO Sales
        DBAPPEND(.F.)
        IF NETERR()
           ? "A network error has occurred!"
        ENDIF


See Also: APPEND BLANK
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson