[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 DSETQFILE()
 Creates a protocol file when the program ends normally
------------------------------------------------------------------------------
 Syntax

     DSETQFILE([<lNewQuitMode>]) --> lOldQuitMode

 Argument

     <lNewQuitMode>  Designates whether the automatic QUIT file is
     created (.T.) or not (.F.).  The default value (.F.) does not create an
     automatic QUIT file.

 Returns

     When called without parameter, the function returns the current
     DSETQFILE() setting.  If a parameter is passed, it returns the previous
     setting.

 Description

     This function allows for the creation of a QUIT file.  This file can be
     used to determine if an application has been terminated normally or not
     (i.e.  Ctrl-Alt-Del).  When the program ends, the contents of the
     keyboard buffer are written to a file.  This allows you to determine
     what keyboard input the user made, which can be used to trace errors and
     reconstruct files.  The size of the QUIT file corresponds to the size of
     the keyboard buffer.  To save more than the 16 default characters, you
     must increase the keyboard buffer size with SET TYPEAHEAD.  (The maximum
     buffer size 32768 keystrokes.)

     The name for the QUIT file is normally constructed from the name of the
     .EXE file with a .Q extension.  SETQNAME() lets you use any file name
     you choose.

 Notes

     .  The keyboard data appears in KEYREAD() format in the QUIT file
        (see Appendix A: Key Codes/ CTSCAN.CH).

     .  Only those keyboard inputs already processed by the program
        are written to the QUIT file.

     .  An existing QUIT file is overwritten automatically if it has
        the same name as the QUIT file that is currently being written.

 Examples

     .  This statement causes the program to create a standard QUIT
        file when you exit the program:

        DSETQFILE(.T.)       // QUIT file will be created

     .  Select the name of the QUIT file:

        SETQNAME("C:\LOGS\PROTO.LOG")
        DSETQFILE(.T.)       // QUIT file will be created
                             // with an alternate name


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