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

##############################################################################
###+-----+####################################################################
#+-| USE |------------------------------------------------+###################
#| +-----+ The USE command opens and/or closes a database |###################
#|         and its associated index and memo files        |###################
#+--------------------------------------------------------+###################
##############################################################################
##############################################################################
#+--| Syntax |------------------------------------------------+###############
#|     USE [[<C-exp> ALIAS] <Alias> [INDEX <Index-list>]]     |###############
#|     [SHARED || EXCLUSIVE] [INDEX <Index-list>]]            |###############
#+------------------------------------------------------------+###############
##############################################################################
##############################################################################
#########+---| Description |----------------------------------------+#########
#########| USE opens the specified database and index files and any |#########
#########| associated memo file and assigns the <Alias> to the      |#########
#########| database.  USE closes files associated with the current  |#########
#########| work area.  USE is not recommended because of its link   |#########
#########| to the SELECT command; the OPEN command is preferred.    |#########
#########| -------------------------------------------------------- |#########
#########| Ten work areas are available to USE.  To move among work |#########
#########| areas, use the SELECT command.                           |#########
#########| -------------------------------------------------------- |#########
#########| If only USE is specified, then all files associated with |#########
#########| the current alias - database, index and memo - are       |#########
#########| closed.  The ORDER for the alias is set to 1 and the     |#########
#########| relation and filter list for the alias is set to NULL.   |#########
#########| -------------------------------------------------------- |#########
#########| [<C-exp> ALIAS] <Alias>                                  |#########
#########|                                                          |#########
#########| <C-exp> defines the file to be used.  If <C-exp> is not  |#########
#########| defined, then USE will try to open the file set by the   |#########
#########| most recent SET ALIAS.                                   |#########
#########| -------------------------------------------------------- |#########
#########| INDEX <Index-list>                                       |#########
#########|                                                          |#########
#########| The first file specified in the index list will be the   |#########
#########| master index file.  The order of the index files is set  |#########
#########| to 1.                                                    |#########
#########| -------------------------------------------------------- |#########
#########| [SHARED || EXCLUSIVE]                                    |#########
#########|                                                          |#########
#########| The keywords SHARED and EXCLUSIVE specify the access     |#########
#########| rights to a database file and its associated index and   |#########
#########| memo files.  SHARED allows the database file to be used  |#########
#########| by several users on a network.  EXCLUSIVE specifies that |#########
#########| the database file should be used by one person.  the     |#########
#########| status of SET EXCLUSIVE serves as the default.  The      |#########
#########| default status for SET EXCLUSIVE is ON.                  |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########|                                                          |#########
#########| USE "one.dbf"               && Open database in current  |#########
#########|                             &&  work area.               |#########
#########|                                                          |#########
#########| USE                         && Close database and index  |#########
#########|                             &&  files, and release all   |#########
#########|                             &&  filters and relations    |#########
#########|                             &&  in current work area.    |#########
#########|                                                          |#########
#########| SET ALIAS one_dbf TO "b:\database.dbf"                   |#########
#########| SET ALIAS one_index TO "b:\database.fdx"                 |#########
#########| SET ALIAS two_index TO "b:\database.fd2"                 |#########
#########|                                                          |#########
#########| USE one_dbf INDEX one_index, two_index                   |#########
#########|                             && Open an alias that has    |#########
#########|                             &&  been assigned a          |#########
#########|                             &&  database name through    |#########
#########|                             &&  the SET ALIAS command.   |#########
#########|                                                          |#########
#########| USE "abc.dbf" ALIAS aaa                                  |#########
#########| SELECT 2                    && Use the SELECT command    |#########
#########|                             &&  to change work area.     |#########
#########| USE "def.dbf" ALIAS bbb                                  |#########
#########+----------------------------------------------------------+#########
##############################################################################