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

 SET RIGHTS CHECKING
 Sets security method used to open or create files
------------------------------------------------------------------------------

 Syntax

     SET RIGHTS CHECKING ON | off

     CHECKING ON sets security based on access file/directory rights.
     This is the default.

     CHECKING OFF sets security based on Advantage application access.

     Note: If rights checking is set OFF, you may need to specify the
     directory where the semaphore connection file will be located. See your
     Advantage server guide for more information.

 Description

     SET RIGHTS CHECKING ON causes any newly opened work areas to use
     the network OS file/directory rights form of security. That is,
     Advantage will verify that the user has the necessary rights
     before allowing the user to create or open the specified file.
     This is the default.

     SET RIGHTS CHECKING OFF causes any newly opened work areas to
     access files through the Advantage server without checking
     file/directory access rights. This allows the network administrator
     to "hide" Xbase data files from users that are not accessing data
     through an Advantage application. The Xbase data is secure by
     removing all the appropriate rights to the directories in which
     the data files are located. Only Advantage applications using this
     security method may access the data files. The Advantage server
     will create, open, and/or update these "hidden" files with its
     server "administrator" privileges.

     Note: A change in the SET RIGHTS CHECKING setting only affects
     those work areas opened or created after the SET RIGHTS CHECKING
     setting is changed. Therefore, the method of security can be on a
     per-work area basis.

     Note: CA-Clipper functions such as FILE(), FOPEN(), and
     FERASE() are not RDD functions. Thus, they will not be able to take
     advantage of the Advantage Database Server's "administrator" privileges.
     So, if the system administrator has taken away network rights from a
     directory, non-RDD functions such as FILE(), FOPEN(), and FERASE() may
     not work as expected.

     Note: SET PATH will not be obeyed with the "rights checking off"
     form of Advantage security.  If no path is specified with a file name
     to be created or opened, and a SET PATH path(s) has been specified, the
     path(s) specified in the SET PATH command will NOT be searched when
     the file is attempted to be opened with "rights checking off".  The
     SET PATH path(s) will be searched when a file is attempted to be
     opened/created with "rights checking on" but will NOT be searched
     with "rights checking off".

 Example

     // Assume user does not have network READ and WRITE rights to the
     //  X:\NORIGHTS directory but has sufficient network rights to the
     //  X:\HASRIGHT directory.

     // Obey network rights
     SET RIGHTS CHECKING ON

     USE X:\HASRIGHT\FILE1.DBF VIA "DBFNTX"     // Will succeed
     USE X:\HASRIGHT\FILE2.DBF VIA "DBFNTXAX"   // Will succeed
     USE X:\NORIGHTS\FILE3.DBF VIA "DBFNTX"     // Will fail
     USE X:\NORIGHTS\FILE4.DBF VIA "DBFNTXAX"   // Will fail
     CLOSE ALL

     // Ignore network rights. Effectively hides files from non-Advantage
     // work areas
     SET RIGHTS CHECKING OFF

     USE X:\HASRIGHT\FILE1.DBF VIA "DBFNTX"     // Will succeed
     USE X:\HASRIGHT\FILE2.DBF VIA "DBFNTXAX"   // Will succeed
     USE X:\NORIGHTS\FILE3.DBF VIA "DBFNTX"     // Will fail
     USE X:\NORIGHTS\FILE4.DBF VIA "DBFNTXAX"   // WILL SUCCEED!
     CLOSE ALL