VS_Append()          Add a new record

Description:

  VS_Append() adds a new record to the database associated with the
  currently selected work area.  If successfully added, each field in
  the record is set to the empty value for its data type and the new
  record becomes the current record.

Syntax:     

  l_Success = VS_Append()

Pass:       

  Nothing

Return:     

  l_Success is a logical expression that will be set to .T. if
  VS_Append() was able to successfully add a new record to the database
  otherwise l_Success will be set to .F.

Notes:      

  .   Logical Records:  VS_Append() does not respect logical
  visibility.  That is, if the record is successfully added, it becomes
  the current record regardless of any index or filter condition.

  .   Network Environment:  For a shared database on a network,
  VS_Append() automatically places a record lock on the new record.  If
  the record cannot be loced, it is not added and VS_Append() will set
  l_Success to .F.

Example:    

  BEGIN SEQUENCE

     IF .NOT. CUST->( VS_Append() )
        BREAK
     ENDIF
     ...

  END SEQUENCE

Usage:      

  VS_Append() will try to append a blank record to the currently
  selected file.  If it is unsuccessful, a non-screen destructive
  message stating "Waiting for busy network.  Press any key to abort."
  will appear on the screen and VS_Append() will endlessly attempt to
  append a blank record to the currently selected database.  If the user
  aborts the operation by pressing a key, VS_Append() will return a
  logical value of false, it's your job as the programmer to abort the
  operation and recover properly.