DCLIP.SYS File.......dCLIP Configuration File
! | INTERP =.........Interpret a command
#INCLUDE =...........Load a Command Set from a .CH or .OBJ file
AUTOINDEX =..........Automatically open index files
AUTOLOCK =...........Disable/Enable Automatic Record Locking
BATCH =..............Create psuedo-command for running a .DCB batch file
CANCEL =.............Enable/Disable program to be cancelled with the ALT-C key
CHRKEY =.............Define the key assignment for the ASCII-table pick-list
CLIPOPT =............Define default compiler options
CLIPPATH =...........Define the location of the Clipper.exe compiler
CLOAK =..............Enable/Disable 'Cloaking' of the Compiler copyright message
COLOR =..............Enable/Disable the color system for monochrome displays
COMMAND =............Create a Dot-prompt psuedo-command to run a DOS program
DCLIP =..............Set the directory to use for dCLIP data-dictionary files
DEBUG =..............Define a file name to save debugging information
DEFA =...............Define default directory for database/index/report files
DO =.................Automatic execution of a procedure or expression at startup
DOSKEY =.............Set Clipper command stack operation to Dos-Key emulation
DOTSTACK =...........Establish the size of the Dot-prompt command stack
EDITOR =.............Define the default editor for the IDE system
EXPLODE =............Toggle activation of Exploding Windows
EXPMEM =.............Enable/Disable use of Expanded memory for swapping
FLDKEY =.............Define the key assignment for the field pick-list
FLUSH =..............Set the amount of reserve to keep in the dynamic-link pool
HISTORY =............Define a file name to save the dot-prompt command stack
INDEXKEY =...........Define the key assignment for the index-builder
KEYLOAD =............Load function keys and set keys from a data file
LIB =................Load a dynamic library
MAP =................Load map file to locate .OBJ to link when a UDF is called
MAXROW =.............Set the maximum number of display rows
OBJ =................Dynamic-link an .OBJ file
ODIR =...............Define the default directory for object files
ODPERCENT =..........Set numeric value for progress indicator percentage of update
PATH =...............Define the search path for data files
PDIR =...............Define the default directory for source files
PEXT =...............Define the default extension of source code files
PROC =...............Create psuedo-command to run procedure or function
PROMPT =.............Define the prompt preceding the dot
QUERYKEY =...........Define the key assignment to pop-up the query builder
RDD =................Set Default Database Driver
REEDIT =.............Enable/Disable re-editing of source code after compile error
SET =................Change the default setting of any SET environment variable
SLASH =..............Define the name of the source file to edit with the / key
START =..............Set the default startup mode
STEPKEY =............Define the key assignment for the source-level debugger
STICKYBROWSE =.......Set Sticky Browse Default Mode
SWAP =...............Define the Swap Directory for creating memory image files
TRACESIZE =..........Set Maximum size of Trace File
TURBO =..............Define the default TURBO editor for the IDE system
USEEXCLDATA =........Force Exclusive Use of Application Databases
USEEXCLDICT =........Force Exclusive Use of Dictionary Databases
DCLIP.SYS File
dCLIP Configuration File
Syntax:
Description:
A DCLIP.SYS file must exist either in the current directory or
in the directory designated by the SET DCLIP=(drive/directory)
command to configure the commands which you wish to run from
the dot prompt. This file contains a set of commands which are
loaded into runtime arrays at the start of the program. Some
of the commands in the DCLIP.SYS file allow "mapping" of DOS
calls, procedure calls or running of batch files simply by
typing a configurable "command" at the DOT prompt.
If a DCLIP.SYS file does not exist in the current directory
when you start dCLIP, then dCLIP will load the the DCLIP.SYS
file which exists in the SET DCLIP= directory.
! | INTERP =
Interpret a command
Syntax:
Arguments:
(xcCommand) is any command string, with arguments, that is
supported in the dCLIP command set or in any command set that
has been loaded with the INCLUDE command.
Description:
! or INTERP = is used to interpret any command via the dCLIP
command pre-processor.
Examples:
-- Example 1 --
#INCLUDE = \MYAPPS\MYCMDS.CH
INTERP = SET STATUS OFF
INTERP = SET DELETED ON
INTERP = LOGIN AS JAMES
INTERP = SET RDD TO DBFMDX
-- Example 2 --
!USE CUSTOMER
!GO TOP
!BROWSE
Source/Library:
_DCINIT.PRG/.OBJ, DCLIP.LIB
See Also:
dc_interpret()
dc_program()
#INCLUDE =
Load a Command Set from a .CH or .OBJ file
Syntax:
Arguments:
(cFileName)[.CH] is the name of a file that contains pre-
processor directives. If no path is given then the current
directory and all directories in the SET INCLUDE=(path)
command will be searched.
(cFilename).OBJ is the name of a Clipper-compiled object file.
The original source code for this file is created by using the
dot-prompt command:
. INCLUDE (cFileName)[.CH] TO (cPrgName)
The (cPrgName).PRG file is then compiled to an .OBJ file.
This .OBJ file may be linked into the DCLIP.EXE engine by just
including it in your link script. If the .OBJ is linked into
the engine, then the #INCLUDE = comand in DCLIP.SYS will only
activate the command set. If the .OBJ is not linked into the
engine, then the #INCLUDE = command will dynamic-link the .OBJ
file, then activate the command set.
Description:
#INCLUDE = is used to load a command set from a .CH file with
pre-processor directives or an .OBJ file that was compiled from
a .CH file which was converted to a .PRG file by dCLIP.
Examples:
#INCLUDE=MYCMDS
#INCLUDE=TEST.OBJ
See Also:
INCLUDE
INCLUDE DEFAULT
dc_preinclude()
AUTOINDEX =
Automatically open index files
Syntax:
Arguments:
ON will automatically open indexes.
OFF will disable the automatic index-open feature.
Description:
AUTOINDEX is used to automatically open index files when using
the DBFNTX driver in the same way that a production index in
automatically opened when using the COMIX, DBFCDX or SIXCDX driver.
A new system setup variable name AUTOINDEX has been added. The
default is OFF. When set to ON then index files with the same
prefix as the Alias() and containing an index key that matches the
alias will automatically be opened with the USE command.
Examples:
Let's say the following files exist in the Default directory:
DM004.DBF
DM0041.NTX
DM0042.NTX
DM0043.NTX
They will all be opened with the following commands:
SET AUTOINDEX ON
USE DM004
or
USE DM004 AUTOINDEX
See Also:
USE
AUTOLOCK =
Disable/Enable Automatic Record Locking
Syntax:
Arguments:
ON will automatically lock and unlock the current record or
file whenever a dot-prompt command is issued that requires a
lock (DEFAULT).
OFF will disable the automatic record-locking feature.
Description:
AUTOLOCK is used to enable or disable the automatic
record-locking feature of dCLIP when using certain dot prompt
commands. Many Clipper commands will require a record lock
whenever the command modifies data in the current work area.
If AUTOLOCK is ON, then the record lock is issued
automatically. If AUTOLOCK is OFF, then the RLOCK() function
or LOCK command must be issued at the dot-prompt otherwise a
"lock required" error may be displayed.
AUTOLOCK will not affect any application code or any dCLIP
menus, only commands issued at the dot prompt.
See Also:
SET AUTOLOCK
dc_reclock()
BATCH =
Create psuedo-command for running a .DCB batch file
Syntax:
Arguments:
(cCommandVerb) is the command to type at the DOT prompt.
(cBatchFile) is the name of the dCLIP BATCH file to execute
when the command is entered.
Description:
BATCH = is used to create a psuedo-command for executing a
batch file from the dot-prompt. This is a handy command when
you wish to invoke a commonly-used set of commands from a
single command verb.
Examples:
BATCH = SHUTDOWN, F:\MYPROGS\SHUTDOWN.DCB
See Also:
SET BATCH
dc_batch()
CANCEL =
Enable/Disable program to be cancelled with the ALT-C key
Syntax:
Arguments:
ON will enable cancelling of the application with the ALT-C. -
DEFAULT.
OFF will disable cancel.
Description:
CANCEL = ON enables the dCLIP program or your application to be
aborted with the ALT-C key. Since the dCLIP main processor and
most dCLIP functions are written in Clipper, the ALT-C key will
abort dCLIP in the same manner as it will abort your
application. This may also be accomplished by using the
function SETCANCEL(.t.) at the dot prompt or in your
applications. The default cancel mode is OFF or the same as
SETCANCEL(.f.).
Examples:
CANCEL = ON
CHRKEY =
Define the key assignment for the ASCII-table pick-list
Syntax:
Arguments:
(nInkey) is the same as the INKEY() value for the desired key
to press to invoke the field pick-list.
Description:
The ALT-G key is the default key to invoke the Ascii-Table
pick-list for selecting an ascii character to insert into
the command line editor at the current cursor location.
If you wish to reassign this key to prevent conflict with
other hot-keys, then use this command.
Examples:
// Define ALT-P as the field list key
FLDKEY = 281
See Also:
SET CHRKEY
CHR
dc_chrsel()
CLIPOPT =
Define default compiler options
Syntax:
Arguments:
(cOptions) is a list of default options to send to the
CLIPPER.EXE compiler when compiling with the CLIPPER option
at the dot prompt.
Description:
CLIPOPT= can be used to establish a default set of options to
pass to the compiler when using the CLIPPER command at the
dot-prompt. It is not necessary to use these options on the
command-line if they are specified here.
Examples:
CLIPOPT = /n/w/i\CLIPPER5\INCLUDE
See Also:
SET CLIPOPT
CLIPPER
/
dc_turbedit()
CLIPPATH =
Define the location of the Clipper.exe compiler
Syntax:
Arguments:
(cPathSpec) is the drive and directory to search for the
CLIPPER.EXE compiler.
Description:
CLIPPATH= is used to define the location of the Clipper.exe
compiler if it is not located in your DOS path.
Examples:
CLIPPATH = F:\CLIPPER5\BIN
See Also:
SET CLIPPATH
CLIPPER
/
dc_turbedit()
CLOAK =
Enable/Disable 'Cloaking' of the Compiler copyright message
Syntax:
Arguments:
ON will enable cloaking.
OFF will disable cloaking. - DEFAULT
Description:
A CLIPPER.EXE "cloaking device" is included to suppress the
Clipper copyright messages when using the
"turbo-edit-compile-link" mode with '/' key. To use the
"cloaking" feature you must make sure that CLOAK.EXE is
installed in the same directory as your CLIPPER.EXE program.
Examples:
// (drive/directory of CLIPPER.EXE and CLOAK.EXE)
CLIPPATH = \CLIPPER5\BIN
CLOAK = ON
See Also:
SET CLOAK
COLOR =
Enable/Disable the color system for monochrome displays
Syntax:
Arguments:
OFF will disable color mode.
(nPalette) will enable the selected palette. If (nPalette) is
an invalid number, then a pick-list of available palette
descriptions will be displayed.
Description:
If you are running dCLIP on a portable computer with an LCD
display, you may have difficulty reading menus due to color
incompatability. If this happens, enter the command COLOR=OFF
in your DCLIP.SYS file or set the memory variable COLOR_MON to
.F. at the main dot prompt.
Examples:
COLOR=OFF
See Also:
dc_color()
COMMAND =
Create a Dot-prompt psuedo-command to run a DOS program
Syntax:
Arguments:
(cCommandVerb) is the name of command to type at DOT prompt.
(DOS program name) is the name of .COM, .EXE, or .BAT to run
(nMemorySwap) is the amount of memory to release and save to
disk to run the executable program. Default is (K). Enter 0
to release all memory except shell.
(cPathSpec) is the name of primary and secondary Disk Drive /
Directory to save the memory image. A temporary file is
created on the first drive if space is available. If no space
is left on the first drive/directory then the temporary file
is created on the second specified drive/directory.
The RUN options is used if you do not want to swap any memory
to disk but simply wish to RUN the program in the available
memory. This is used for resident dos commands or pre-loaded
TSR's. If you use the RUN option, the (memory swap size)
parameter is ignored.
Description:
COMMAND= is used to create single-verb psuedo-commands to run
other DOS programs via the dCLIP gateway system. This allows
you to create dot-prompt commands which are similar or
equivalent to commands that would be used at the DOS prompt.
Examples:
COMMAND = TOOLS, PCTOOLS, 400, D:
COMMAND = Q, QEDIT, 256, D:;F:\PUBLIC
COMMAND = D, DIR, 50, RUN
See Also:
SET COMMAND
DCLIP =
Set the directory to use for dCLIP data-dictionary files
Syntax:
Arguments:
(pathspec) is any valid directory which may also include a
drive letter.
Description:
DCLIP = is used to establish the directory which will be
searched for creating dCLIP DC*.DBF databases and indexes.
If the files do not exist in this directory then they will be
created. dCLIP establishes the default for this value in the
following order:
1. Uses the value in any SET DCLIP=(directory) statement in
the DOS environment.
2. Uses the directory in which the .EXEcutable program
resides.
See Also:
SET DCLIP
dc_setdclip()
DEBUG =
Define a file name to save debugging information
Syntax:
Arguments:
(cDebugFile) is the name of the file to create. If no
extension is given, then .AR is assumed. This is an "array"
file which is used to restore the debug information arrays.
A second file is created with the same prefix name but with the
.DCB extension. This file is a text file that contains the
commands from the command stack.
Description:
DEBUG= is use to define the name of a file to create for saving
and restoring the Interactive debugger command stack, step
points, and watch points each time the debugger is exited and
reinvoked.
Examples:
DEBUG = C:\MYAPPS\DBGSAVE
See Also:
SET DEBUG
DEFA =
Define default directory for database/index/report files
Syntax:
Arguments:
(cPathSpec) is the directory to open data files and create new
data files. All new database files, report files and index
files will be created in the DEFAULT directory if a directory
path is not specified when creating the file.
Description:
DEFA = is equivalent to the SET DEFAULT command. Use this
command to establish the directory path to use when creating
new data files, index files, report/label files, etc.
Examples:
DEFA = G:\MAILLIST
See Also:
SET DEFAULT
dc_setdefa
dc_setdclip
DO =
Automatic execution of a procedure or expression at startup
Syntax:
Arguments:
(expression) is any valid expression or UDF() to evaluate.
Description:
DO= is used to evaluate an expression at startup of the
program. Use this command to automatically run a UDF such as a
menu system. You may include as many DO= commands as you wish.
They will be evaluated in the order they are listed.
Examples:
OBJ=\MYUDFS\MYUDFS
DO=MYPATH("\MYAPPS")
DO=MAINMENU()
See Also:
dc_do()
DOSKEY =
Set Clipper command stack operation to Dos-Key emulation
Syntax:
Description:
DOSKEY is used to set the behavior of the dot-prompt
command stack navigator to emulate that of DOS command
stack navigators like Dos-Key or OS/2.
The normal behavior allows commands to be reissued in
sequence and expedite processes that are used again and
again. Dos-Key emulation automatically copies the selected
command to the bottom of the stack after execution and
creates a blank command line for input.
Examples:
DOSKEY=ON
Source/Library:
DCLIP.SYS
See Also:
dc_dotdoskey()
SET DOSKEY
dc_dot()
DOTSTACK =
Establish the size of the Dot-prompt command stack
Syntax:
Arguments:
(nSize) is a number from 100 to 4000.
Description:
DOTSTACK is used to increase the length of the Dot-Prompt
command stack array to a value greater than the default value
of 100 commands. This is desirable in the event that it is
necessary to save and restore more than the last 100 commands
with the HISTORY=(file) command in your DCLIP.SYS.
Examples:
DOTSTACK = 500
Source/Library:
DCLIP.SYS
See Also:
dc_dotsize()
SET DOTSTACK
dc_dot()
EDITOR =
Define the default editor for the IDE system
Syntax:
Arguments:
(cFileName) is the name of the editor .COM, .BAT or .EXE
file to run when using the EDIT command.
(nMemorySwap) is the amount of memory to release and save to
disk to run the program. The default is (K). Enter 0 to
release all memory except shell.
(cPathSpec) is the name of primary and secondary Disk
Drive/Directory (separated by a semicolon) to save the memory
image.
A temporary file is created on the first drive if space is
available. If no space is left on the first drive/directory
then the remainder of the memory image is created on the second
specified drive/directory. The temporary file is erased
returning from your editor.
Optional: [H] - Set High Resolution mode (43/50 lines)
[L] - Set Low Resolution mode (25 lines)
Description:
EDITOR= is used to define the name and path of the default
editor you wish to use when using the IDE
(integrated-development-environment) features of dCLIP, such as
the EDIT command and re-editing after compiler errors.
Examples:
EDITOR = QEDIT,256,D:;F:\PUBLIC,/H
See Also:
SET EDIT
dc_turbedit()
dc_editprg()
EDIT PRG
EXPLODE =
Toggle activation of Exploding Windows
Syntax:
Arguments:
ON will enable Exploding windows - DEFAULT
OFF will disable Exploding windows.
Description:
EXPLODE= is used to enable or disable the "exploding" feature
of dCLIP windows. Turn EXPLODE OFF to improve the speed of
painting windows on slower computers.
See Also:
SET EXPLODE
dc_explode()
dc_expl()
dc_explmode()
EXPMEM =
Enable/Disable use of Expanded memory for swapping
Syntax:
Arguments:
ON will enable use of Expanded memory for swapping.
OFF will disable Expanded memory. - DEFAULT
Description:
EXPMEM=ON is used to enable the use of Expanded memory to save
the memory image when shelling to dos through the gateway
system.
FLDKEY =
Define the key assignment for the field pick-list
Syntax:
Arguments:
(nInkey) is the same as the INKEY() value for the desired key
to press to invoke the field pick-list.
Description:
The ALT-F key is the default key to invoke the Field List
window for selecting a field from the currently selected
database and/or relational databases. If you wish to reassign
this key to prevent conflict with other hot-keys, then use this
command.
Examples:
// Define ALT-P as the field list key
FLDKEY = 281
See Also:
SET FLDKEY
dc_fields()
dc_dot()
FLUSH =
Set the amount of reserve to keep in the dynamic-link pool
Syntax:
Arguments:
(nMemory) is the amount of reserve memory (in K) - Default is
0k.
Description:
FLUSH is used to control how much reserved memory you wish to
keep in the OBJECT POOL for linking of objects. If you get
OBJECT TOO BIG or MODULE TOO BIG errors often, sometimes this
is caused by fragmentation of the OBJECT POOL due to the way
your program is structured. Try running your program first
with FLUSH=0 (default), then try increasing it by 10 each time
to help keep the object pool from fragmenting.
Examples:
FLUSH = 10
See Also:
OBJ LOAD
dc_objload()
dc_objmem()
dc_conmem()
HISTORY =
Define a file name to save the dot-prompt command stack
Syntax:
Arguments:
(cHistFile) is the name of a history file to create. If no
extension is given then .AR is assumed. The .AR file is an
"array" file which is used for restoring the command stack
array.
A second file is created with the same prefix name but with the
.DCB extension. This file is a text file that contains the
commands from the command stack.
Description:
HISTORY= is used to define the name of a file to create for
saving and restoring the Dot-prompt command stack each dCLIP is
quit and started again. Only the last 100 commands entered
will be saved.
Examples:
HISTORY = C:\MYAPPS\HISTORY.AR
INDEXKEY =
Define the key assignment for the index-builder
Syntax:
Arguments:
(nInkey) is the same as the INKEY() value for the desired key
to press to invoke the field pick-list.
Description:
The ALT-I key is the default key to invoke the Index Builder
for creating index expressions from field pick-lists when
entering INDEX ON commands at the command line.
If you wish to reassign this key to prevent conflict with
other hot-keys, then use this command.
Examples:
// Define ALT-P as the field list key
FLDKEY = 281
See Also:
SET INDEXKEY
dc_index()
KEYLOAD =
Load function keys and set keys from a data file
Syntax:
Arguments:
(cKeyFile) is the name of the database file for loading the 40
function keys and specific SET KEYs at the start of the
program. If no (cKeyName) is given then the keys will be
loaded from the DCKEY.DBF database. Any datafile name may be
used provided that the datafile has the same structure and
number of records as the DCKEY.DBF data file. See the KEY LOAD
command for more information about this feature.
Description:
KEYLOAD= is used to load function keys and SET KEYS from a
database of strings, macros and procedure calls.
Examples:
KEYLOAD = C:\DCLIP\DATA\MYKEYS.DBF
See Also:
KEY LOAD
dc_keyload()
dc_keyedit()
LIB =
Load a dynamic library
Syntax:
Arguments:
(cLibName) is the name of the dynamic library (.DLB) file to
load.
Description:
LIB = is equivalent to the LIB LOAD dot-prompt command and is
used for loading default dynamic libraries. Up to 10 LIB =
commands can be used.
Examples:
LIB = G:\MYAPPS\MYPROCS
LIB = G:\MYAPPS\MAILLIST
See Also:
LIB LOAD
dc_libload()
MAP =
Load map file to locate .OBJ to link when a UDF is called
Syntax:
Arguments:
(cMapFile) is the name of the map file to load. If no
extension is given, then .LST is assumed.
Description:
MAP= is used to load a map file (.LST) into memory. A map file
is an ASCII file with a listing of functions that are
cross-referenced to the source file name so the .OBJ can be
found to link into memory when the function is called.
Notes:
MAP= is equivalent to the MAP LOAD command.
Examples:
MAP = C:\MYAPPS\MYAPP.LST
See Also:
MAP LOAD
dc_mapload()
OBJ LOAD
dc_objfind()
WHERE
MAXROW =
Set the maximum number of display rows
Syntax:
Arguments:
(nRows) is the number of rows to assign to the display.
Default is 25. Only 25, 43, or 50 are allowed.
Description:
MAXROW = is used to establish the number of display rows on
the screen.
Examples:
MAXROW = 50
OBJ =
Dynamic-link an .OBJ file
Syntax:
Arguments:
(cObjFile) is the name of the Clipper-compiled .OBJ file to
link into memory.
Description:
OBJ = is used to "dynamic-link" a Clipper-compiled .OBJ file
into memory. The .OBJ must be compiled by the 5.01 version of
Clipper. Up to 10 OBJ= commands may be included provided that
there is sufficient memory allocated to the dynamic-link pool.
The "X" parameter of the SET CLIPPER environment command is
used to allocate the dynamic-link pool.
Examples:
OBJ = C:\MYAPPS\OBJ\MAIN
OBJ = C:\MYAPPS\OBJ\FUNCS
See Also:
OBJ LOAD
dc_objload()
SET ODIR
ODIR =
Define the default directory for object files
Syntax:
Arguments:
(cPathSpec) is the name of the drive and directory which your
.OBJ are located for the current project. If not specified,
then dCLIP will search the directory which was current at the
time you started up dCLIP. You may also use the DOS APPEND
command to specify a path specification to search for .OBJ
files. dCLIP will search the ODIR directory followed by the
DOS APPEND path for .OBJ files anytime an object needs to be
linked into memory.
Description:
ODIR= is used to define the directory to search for .OBJ files
when the dynamic-linker is trying to link a file. ODIR= also
defines the directory where .OBJs will be created when they are
compiled with the CLIPPER command at the dot-prompt.
Examples:
ODIR = C:\MYAPPS\OBJS
See Also:
SET ODIR
dc_objload()
OBJ LOAD
ODPERCENT =
Set numeric value for progress indicator percentage of update
Syntax:
Arguments:
(nPercent) is a numeric value for the percentage of update
you want on the progress odometer. If you have very large
files and want to see progress more often, then it is
recommended you lower this number from the default of 5
percent.
Description:
DC_ODPERCENT() sets how often to update the progress
indicator odometer when using DC_ODOMETER() or
DC_ODBLOCK().
Examples:
ODPERCENT = 20
See Also:
SET ODPERCENT
dc_odpercent()
dc_odometer()
dc_odblock()
PATH =
Define the search path for data files
Syntax:
Arguments:
(cPathSpec) is the directory path to search for data files.
Description:
PATH = is equivalent to the SET PATH command. Use this command
to establish the directory path to search when opening data
files, index files, report/label files, etc.
Examples:
PATH = F:\DCLIP\DATA;G:\MAILLIST
See Also:
SET PATH
dc_pathfound()
dc_ispath()
SET DEFAULT
dc_setdefa
PDIR =
Define the default directory for source files
Syntax:
Arguments:
(cPathSpec) is the name of the drive and directory which your
.PRG files are located for the current project. If not
specified, then dCLIP will search the directory which was
current at the time you started up dCLIP. You may also use the
DOS APPEND command to specify a path specification to search
for .OBJ files. dCLIP will search the PDIR directory followed
by the DOS APPEND path for .PRG files anytime a source file
needs to be accessed by the source-level debugger, the EDIT
command or the CLIPPER command.
Description:
PDIR= is used to define the directory to search for .PRG files
when using the source-level debugger, the EDIT command, or the
CLIPPER command.
Examples:
PDIR = C:\MYAPPS\SOURCE
See Also:
SET PDIR
EDIT PRG
/
dc_turbedit()
dc_editprg()
PEXT =
Define the default extension of source code files
Syntax:
Arguments:
(cExtension) is the file extension to use as the default for
source code files.
Description:
The source-level debugger will open a source code file with the
PEXT extension before opening a file with the .PRG extension.
This allows you to see the actual pre-processed code during
source-level debugging. If you place the command PEXT=.PPO
into your DCLIP.SYS file and compile with the /p option, then
you will see the .PPO file output during source-level debugging
rather that the .PRG file.
Examples:
PEXT = .PPO
See Also:
SET PEXT
SET STEP
dc_setstep()
PROC =
Create psuedo-command to run procedure or function
Syntax:
Arguments:
(cCommandVerb) is the name of the command to type at the DOT
prompt.
(idProcedure) is the name of a procedure or expression to
execute. All procedures or UDF's called by this expression must
be resident in memory by loading with OBJ=, must be resident in
a dynamic library which has been loaded with LIB=, or
referenced in a map file which has been loaded with MAP=.
Description:
PROC= is used to create a single command verb to initiate the
evaluation of complex expressions. This is handy if you wish
to execute a function and pass it a set of default parameters
each time you type a one-word command.
Examples:
PROC = SCHEDULE, CALENDAR(DATE())
See Also:
SET PROCEDURE
PROMPT =
Define the prompt preceding the dot
Syntax:
Arguments:
DOS will display the current DOS directory determined by the CD
command.
DEFA will display the DEFAULT directory determined by the SET
DEFAULT or DEFA= command.
OFF will display no prompt at all.
(cExpression) will display the results of any expression that
returns a character string.
NO argument will display a dot-prompt only with nothing
preceding.
Description:
PROMPT= is used to determined the Prompt to be displayed before
the dot (.) command line interpreter.
Examples:
PROMPT = DEFA
PROMPT = DTOC(DATE)+' '+TIME()
See Also:
SET PROMPT
dc_dot()
QUERYKEY =
Define the key assignment to pop-up the query builder
Syntax:
Arguments:
(nInkey) is the same as the INKEY() value for the desired key
to press to invoke the field pick-list.
Description:
The ALT-Q key is the default key to invoke the Query Builder
for creating or choosing FOR/WHILE expressions to insert at
the current cursor location in the command line editor.
If you wish to reassign this key to prevent conflict with
other hot-keys, then use this command.
Examples:
// Define ALT-P as the field list key
FLDKEY = 281
See Also:
SET QUERYKEY
dc_query()
QUERY
RDD =
Set Default Database Driver
Syntax:
Arguments:
(cRddName) is the name of the Replaceable Database driver.
Description:
RDD = is used to establish the default Replaceable Database
Driver.
Examples:
RDD=DBFSIX
See Also:
SET RDD
dc_setrdd()
dc_superrdd()
dc_rddsel()
REEDIT =
Enable/Disable re-editing of source code after compile error
Syntax:
Arguments:
ON will enable reediting. - DEFAULT
OFF will disable reediting.
Description:
The dCLIP Integrated Development environment will automatically
jump to the line of code in your source that errors at compile
time when using the CLIPPER command at the dot prompt. REEDIT=
is used to enable or disable automatic re-editing after a
compile error.
SET =
Change the default setting of any SET environment variable
Syntax:
Arguments:
(cSetName) is the mnemonic id of the set variable to change.
For example, to set the Alternate output file to a value use
ALTF as the set identifier.
(xValue) is the value to assign to the set variable.
Examples:
SET = ALTF, C:\DCLIP\ALTFILE.TXT
SET = CONS, OFF
SET = DELI, OFF
See Also:
dc_sett()
dc_setedit()
SLASH =
Define the name of the source file to edit with the / key
Syntax:
Arguments:
(cFileName) is the name of the file to edit when using the /
key. Do not include an extension. The source file will require
the .PRG extension which will be compiled to a file with an
.OBJ extension.
Description:
SLASH is used to establish the name of the file to edit when
using turbo editor via the / (slash) command. The default
value is DC_CLIP, ie. the / command will edit a file named
DC_CLIP.PRG and compile it to a file named DC_CLIP.OBJ.
Examples:
SLASH=TEST
See Also:
SET SLASH
/
dc_turbedit()
SLASH =
START =
Set the default startup mode
Syntax:
Arguments:
(cMenu) may be one of the following:
DOT - Start at dot-prompt (DEFAULT)
TURBO - Start in the Turbo IDE (Integrated environment)
ASSIST - Start in the Database Management Assistant
Description:
START= is used to define the dCLIP startup mode of operation.
The options are Dot-prompt, IDE mode, or Database Assistant.
Examples:
START = ASSIST
See Also:
TURBO
dc_dot()
ASSIST
dc_assist()
dc_turbo()
STEPKEY =
Define the key assignment for the source-level debugger
Syntax:
Arguments:
(nInkey) is the same as the INKEY() value for the desired key
to press to invoke the source-level debugger.
Description:
The ALT-S key is the default key to invoke the SET STEP ON mode
for viewing source code while debugging a program. If you wish
to reassign this key to prevent conflicts with your application
or TSR's, you may assign any other key number.
Examples:
// Use ALT-J for the source-level debugger
STEPKEY = 292
See Also:
SET STEP
STICKYBROWSE =
Set Sticky Browse Default Mode
Syntax:
Arguments:
ON will enable Sticky Browse Mode.
OFF will disable Sticky Browse Mode. - ( Default )
Description:
STICKYBROWSE = ON is used to establish the Default mode for
database browsing to maintain the configuration of browse
windows after they are created with the BROWSE commands. If
Sticky Browse mode is ON, if the user exits browse mode and
then enters the BROWSE command again, the previous browse
window will be re-displayed.
See Also:
BROWSE
dc_browsedb()
SET STICKYBROW
SWAP =
Define the Swap Directory for creating memory image files
Syntax:
Arguments:
(cPathSpec) is the name of the primary Disk Drive/Directory to
save memory image. A temporary file is created on the drive if
space is available.
If no space is left on the (cPathSpec) drive then the
remainder of the memory image is created on the (cAltPath)
Drive/Directory.
Description:
SWAP = is used to define the drive and directory to create
temporary memory image files when using commands or functions
that utilize the dCLIP DOS gateway system, such as DOS,
CLIPPER, dc_compile(), etc.
Notes:
For maximum performance when swapping out memory, it is
recommended use define a Ram Drive as the swapping device.
Examples:
SWAP = D:;F:\PUBLIC
See Also:
SET SWAP
dc_gateway()
DOS
RUN
TRACESIZE =
Set Maximum size of Trace File
Syntax:
Arguments:
(nSize) is the maximum size of the Trace File (in Bytes).
The default is 100000.
Description:
TRACESIZE is used to establish the maximum size of the
DCTRACE file that gets created in TRACE MODE. This setting
prevents the disk from being filled up in the event that the
TRACE MODE is inadvertenly left on.
Examples:
TRACESIZE = 500000
Source/Library:
_DCDBG.PRG/.OBJ, DCLIP.LIB
See Also:
dc_tracesize()
SET TRACESIZE
TURBO =
Define the default TURBO editor for the IDE system
Syntax:
Arguments:
(cFileName) is the name of the editor .COM, .BAT or .EXE file
to run when using the / command.
(nMemorySwap) is the amount of memory to release and save to
disk to run the program. The default is (K). Enter 0 to
release all memory except shell.
(cPathSpec) is the name of primary and secondary Disk
Drive/Directory (separated by a semicolon) to save the memory
image.
A temporary file is created on the first drive if space is
available. If no space is left on the first drive/directory
then the remainder of the memory image is created on the second
specified drive/directory. The temporary file is erased
returning from your editor.
Optional: [H] - Set High Resolution mode (43/50 lines)
[L] - Set Low Resolution mode (25 lines)
Description:
TURBO = is used to define the name and path of the default
editor you wish to use when using the
turbo-edit-compile-execute features of dCLIP, such as the /
command or DC_TURBEDIT() function.
Examples:
EDITOR = QEDIT,256,D:;F:\PUBLIC,H
See Also:
dc_turbedit()
dc_turbconfig()
USEEXCLDATA =
Force Exclusive Use of Application Databases
Syntax:
Arguments:
ON will force databases that are opened by the dCLIP USE
command, DC_UseArea() function, DC_WorkRestore(), DC_Dbfile(),
or any other dCLIP function or command that opens databases
to be opened EXCLUSIVE regardless of how parameters are
passed to these functions or the setting of the SET EXCLUSIVE
system flag.
OFF will insure that databases are opened by the default
method for each function.
Description:
USEEXCLDATA is used to override any default settings for
opening databases and insure that they are always opened in
EXCLUSIVE mode only. This flag should be used when using
dCLIP in "design" mode. Design mode means that the user or
programmer is designing Browse and Data-Entry screens and/or
Field Definitions. When adding or changing database fields
or packing files, they must be opened in "Exclusive" mode.
Notes:
When designing a system it is recommended that you place the
following commands in your DCLIP.SYS file:
USEEXCLDATA=ON
USEEXCLDICT=OFF
or type the following commands at the dot prompt:
SET USEEXCLDATA ON
SET USEEXCLDICT OFF
See Also:
USEEXCLDATA
SET USEEXCLDICT
SET USEEXCLDATA
USEEXCLDICT =
Force Exclusive Use of Dictionary Databases
Syntax:
Arguments:
ON will force the dCLIP DC* databases that are opened by the
dCLIP USE command, DC_UseArea() function, DC_WorkRestore(),
DC_Dbfile(), or any other dCLIP function or command that opens
dictionary databases to be opened EXCLUSIVE regardless of how
parameters are passed to these functions or the setting of the
SET EXCLUSIVE system flag.
OFF will insure that dictionary databases are opened by the
default method, i.e., EXCLUSIVE when the SET EXCLUSIVE ON
flag is set or SHARED when the SET EXCLUSIVE OFF flag is set.
Description:
USEEXCLDICT is used to override any default settings for
opening dCLIP dictionary databases and insure that they are
always opened in EXCLUSIVE mode only. This flag should be
used only in the rare occurrence that the structure of a
dCLIP DC* database file must be modified or the database
must be reindexed or packed.
Notes:
When designing a system it is recommended that you place the
following commands in your DCLIP.SYS file:
USEEXCLDATA=ON
USEEXCLDICT=OFF
or type the following commands at the dot prompt:
SET USEEXCLDATA ON
SET USEEXCLDICT OFF
See Also:
USEEXCLDATA
SET USEEXCLDATA
SET USEEXCLDICT