Click above to get retro games delivered to your door ever month!

DBUSEAREA()

Opens a work area and uses a database file.
---------------------------------------------------------------------------------

 Syntax

        DBUSEAREA( [<lNewArea>], [<cDriver>], <cName>, [<xcAlias>],  
        [<lShared>], [<lReadonly>]) --> NIL  

 Arguments

        <lNewArea>    A optional logical expression for the new work 
                  area

        <cDriver>     Database driver name      

        <cName>       File Name      

        <xcAlias>     Alias name      

        <lShared>     Shared/exclusive status flag      

        <lReadonly>   Read-write status flag.    

 Returns

        DBUSEAREA()   always returns NIL.    

 Description

      This function opens an existing database named <cName> in the current
      work area. If <lNewArea> is set to a logical true (.T.) value,
      then  the database <cName> will be opened in the next available and
      unused  work area. The default value of <lNewArea> is a logical
      false (.F.).  If used, <cDriver> is the name of the database driver
      associated with  the file <cName> that is opened. The default for
      this will be the value  of DBSETDRlVER().

      IF used, <xcAlias> contains the alias name for that work area, If not
      specified, the root name of the database specified in <cName> will
      be  used.

      If <lShared> is set to a logical true (.T.) value, the database that
      is specified in <cName> will be opened by the user EXCLUSIVELY.
      Thus  locking it from all other nodes or users on the network. If
      <lShared> is  set to a logical false (.F.) value, then the database
      will be in SHARED  mode. If <lShared> is not passed, then the
      function will turn to the  internal setting of SET EXCLUSIVE to
      determine a setting.

      If <lReadOnly> is specified, the file will be set to READ ONLY mode.
      If it is not specified, the file will he opened in normal
      read-write  mode.

 Examples

      DBUSEAREA(.T.,,"Tests")

Status

      Ready

 Compliance

      This function is CA-Clipper compliant

 Files

      Library is rdd