VS_PushDbf()         Save all the information about a work area

Description:

  VS_PushDbf() will preserve the status of a work area.

Syntax:     

  VS_PushDbf( [c_Alias] )

Pass:       

  c_Alias is an optional character expression that should contain
  the ALIAS() name of the work area to PUSH onto the stack.  If
  c_Alias is not specified, it will default to the ALIAS() name for
  the current work area.

Return:     

  VS_PushDbf() always returns NIL

Notes:      


Example:    

  VS_PushDbf()
     SELECT SOME_ALIAS
     DO SOME_WORK
     ...
  VS_PopDbf()

Usage:      

  VS_PushDbf() allows your programs to not worry about what records were
  current in a given work area.  This allows you to put things back the
  way they were when your function was called.  VS_PushDbf() must be
  used in conjunction with VS_PopDbf().