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

 C_SETHANDLES()

 DESCRIPTION

 C_SETHANDLES() sets the number of DOS file handles allowed in the
 current program.  By increasing the number of file handles,
 additional files such as databases, indexes, etc. can be opened by
 the program.

 NOTES

 To set additional handles, the computer must be running DOS version
 3.30 or greater.  The C_SETHANDLES() function makes no attempt to
 check the DOS version.  Use the C_DOSVER() function to check the
 version number before calling this function.

 When the program begins, the default file handle number is 20
 provided that the FILES entry in config.sys is 20 or greater and
 the Clipper environmental variable SET CLIPPER is not used.  The
 number of file handles allowed in the program can be obtained by
 the C_MAXHANDLES() function.

 The number of file handles allowed in a program can be 1 to 255,
 but can not be greater than the file specification entry (FILES) in
 the config.sys file.  If the FILES entry is 30 (FILES=30), then the
 maximum file handles allowed in the program is 30.

 SYNTAX

 C_SETHANDLES(handles)

 PARAMETERS

 handles (N) is the desired number (1 - 255) of DOS file handles to allow.

 RETURNS

 C_SETHANDLES() returns true (.T.) if the handles were successfully
 set, or false (.F.) indicating an error occurred.

 EXAMPLES

 if c_dosver() > 3.30
   c_sethandles(30)        && Set file handles to 30
 endif