DBGOTOP()
 Move to the first logical record
------------------------------------------------------------------------------
 Syntax

     DBGOTOP() --> NIL

 Returns

     DBGOTOP() always returns NIL.

 Description

     DBGOTOP() moves to the first logical record in the current work area.

     DBGOTOP() performs the same function as the standard GO TOP command.
     For more information, refer to the GO TOP command.

 Notes

     .  Logical records: DBGOTOP() operates on logical records.  If
        there is an active index, DBGOTOP() moves to the first record in
        indexed order.  If a filter is set, only records which meet the
        filter condition are considered.

     .  Controlling order: If more than one index is active in the
        work area, the operation is performed using the controlling order as
        set by DBSETORDER() or the SET ORDER command.  For more information,
        refer to the SET ORDER command.

     .  Network environment: For a shared file on a network, moving to
        a different record may cause updates to the current record to become
        visible to other processes.  For more information, refer to the
        "Network Programming" chapter in the Programming and Utilities Guide.
        This function will not affect the locked status of any record.

 Examples

     .  This example demonstrates the typical use of DBGOTOP():

        DBGOTOP()
        WHILE ( !EOF() )
           ? FIELD->Name
           DBSKIP()
        END

 Files   Library is CLIPPER.LIB.

See Also: BOF() DBGOBOTTOM() DBSEEK() DBSKIP() EOF() GO