[<<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