[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 FN_LOGFILE()
 Log file (ASCIIZ)
------------------------------------------------------------------------------
 Syntax
 
      fn_logFile( cFn, nLockDir, nTimeout ) -> nRes
 
 Arguments

     <cFn>        - File path (full path and name of file)
                    Maximum length is 254 characters

     <nLockDir>   - Locking directive:

                        0 = Log File.  This only logs the record
                            in the table; it does not lock the file.
                        1 = Log and Lock File

                    The default is 0.

     <nTimeout>   - Amount of time to wait for a file to
                    become available, in ticks (1 tick =
                    1/18th of a second).  0 (the default) =
                    no wait.

     The <nLockDir> and <nTimeOut> parameters are only supported
     in "extended lock mode" (see FN_GETLMOD()) and will be
     ignored if you are currently in "compatibility mode."

 Returns

     <nRes>, a numeric, as follows:

         If you're in extended lock mode:

                 0   =  Success
               150   =  Server out of memory
               254   =  Timeout failure
               255   =  Hardware failure

         If you're in compatibility mode:

                 0   =  No error
               255   =  Failure

 Description

      This is the first call you use to do file locks.  You use this
      call to place the name of the file in a log table the server
      maintains for each workstation, and optionally lock the file.

      You can log more files if you need to and lock them later with
      fn_lkFiSet().

 Examples


 Source: N:\SRC\SYNCHRO\LOGFILE.PRG

 Author: Glenn Scott

See Also: FN_GETLMOD() FN_SETLMOD()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson