Dear CA-Clipper 5.2 Developer,
The CA-Clipper 5.2d/ExoSpace 1.0f upgrade described in this file
contains latest fixes for CA-Clipper and CA-Clipper/ExoSpace.
This includes an updated version of the DBFMDX driver revised to
be compatible with the CA-Clipper/Compiler Kit. The DBFCDX driver
has not been changed. We are currently working on a separate patch
for it. It will be published as soon as it is ready.
If you have any questions, please contact your CA-Clipper
Level-1 Technical Support representative at 310-348-4400.
This file contains:
A. The instructions for applying the CA-Clipper 5.2d upgrade to any
North American version of CA-Clipper 5.2 including: 5.20, 5.2a,
5.2b or 5.2c.
It also contains instructions for applying the CA-Clipper 5.2d/
ExoSpace 1.0f upgrade. This is needed ONLY if you have a previous
version of ExoSpace installed on your system.
If you DO NOT have ExoSpace already installed, please answer NO
to the question "Do you have ExoSpace installed" during
the upgrade process and only the Clipper files will be updated.
Please review the file list below and the UPDATE PROCESS
instructions carefully before applying the upgrade.
B. The list of problems resolved by CA-Clipper 5.2d.
=============================================================================
A. Instructions for upgrading Clipper 5.2 (any rev.) to 5.2d (rev. 215) and
ExoSpace (any installed version) to 1.0f version.
REQUIRED FILE FOR PERFORMING UPDATE:
52DUSX.EXE A self extracting ZIP file that may be
downloaded from the CLIPPER forum (library 0)
on CompuServe. (GO CLIPPER).
CONTENTS OF 52DUSX.EXE:
INSTALL.DAT Installation script file.
INSTALL.EXE Installation engine required for performing the
CA-Clipper 5.2d upgrade.
PATCH.EXE Updating engine required for use with all the
*.RTPs. This file is also in Library 0 of the
CLIPPER CompuServe forum.
DISK.ID Installation identification file.
52DINC.LIF Compressed update file for CLIPPER5\INCLUDE
52DOBJ.LIF Compressed update file for CLIPPER5\OBJ
52DDBU.LIF Compressed update file for CLIPPER5\SOURCE\DBU
52DRL.LIF Compressed update file for CLIPPER5\SOURCE\RL
52DSAMPL.LIF Compressed update file for CLIPPER5\SOURCE\SAMPLE
52DSYS.LIF Compressed update file for CLIPPER5\SOURCE\SYS
52DERROR.LIF Compressed update file for CLIPPER5\SOURCE\ERROR
52DFISYS.LIF Compressed update file for CLIPPER5\SOURCE\FILESYS
52DITEM.LIF Compressed update file for CLIPPER5\SOURCE\ITEM
52DSDX.LIF Compressed update file for CLIPPER5\SOURCE\SDX
52DVM.LIF Compressed update file for CLIPPER5\SOURCE\VM
CLP52BIN.RTP Update file for CLIPPER5\BIN
CLP52LIB.RTP Update file for CLIPPER5\LIB
CLP52NG.RTP Update file for NG
52DUSX.TXT Instructions for upgrading to
CA-Clipper 5.2d/ExoSpace 1.0f and the list of
problem resolutions (This file).
THE FOLLOWING FILES ARE FOR PERFORMING EXOSPACE UPDATE:
EXO10F.RTP Update file for ExoSpace
EXNG-10F.RTP Update file for ExoSpace NG
UPDATE PROCESS:
1. Move to your CA-Clipper 5.2 directory.
EXAMPLE: C:\> CD\CLIPPER5
2. Backup your current version of CA-Clipper.
Do the same for ExoSpace IF you already have it installed.
3. If you have Clipper 5.2, 5.2a, 5.2b or 5.2c AND have any problems
installing the upgrade, please reinstall Clipper from the original
disks and reapply the upgrade.
To determine the version of Clipper that you currently have.
At the DOS prompt type
Clipper then press return
At the top of the screen, there will be the copyright header with
the version number.
4. Execute the installation program and follow the instructions.
EXAMPLE: A:\> INSTALL
- or -
EXAMPLE: C:\> A:INSTALL
NOTE: All the files that are upgraded must be on the same drive.
5. After the installation program has run successfully compare the
date and time stamps of the updated files against the
LIST OF UPDATED FILES section.
6. If you have applied the CA-Clipper 5.2d upgrade in a directory
other than the one into which you installed the original
CA-Clipper 5.2 version, you must make sure that your
PATH, INCLUDE, OBJ, and LIB environment variables have been
correctly set to point to the updated version of CA-Clipper.
Example:
(Scenario: You installed CA-Clipper 5.2 in C:\CLIPPER5
and later renamed the directory (or moved the files)
to C:\CLIP52D.)
A:\ SET PATH=C:\CLIP52D\BIN
A:\ SET INCLUDE=C:\CLIP52D\INCLUDE
A:\ SET OBJ=C:\CLIP52D\OBJ
A:\ SET LIB=C:\CLIP52D\LIB
NOTE: You should also change these settings in your AUTOEXEC.BAT file.
7. Move to your DBU directory, define RTLINK's behavior and
re-compile DBU.
EXAMPLE:
A:\> C:
C:\> CD \CLIPPER5\SOURCE\DBU
C:\CLIPPER5\SOURCE\DBU> SET RTLINKCMD=
C:\CLIPPER5\SOURCE\DBU> SET CLIPPERCMD=
C:\CLIPPER5\SOURCE\DBU> RMAKE DBU /F
Copy DBU.EXE to your BIN directory.
EXAMPLE:
C:\CLIPPER5\SOURCE\DBU> COPY DBU.EXE C:\CLIPPER5\BIN
8. Move to your RL directory, re-compile RL.
EXAMPLE:
C:\CLIPPER5\SOURCE\DBU> CD \CLIPPER5\SOURCE\RL
C:\CLIPPER5\SOURCE\RL> RMAKE RL /F
Copy RL.EXE to your BIN directory.
EXAMPLE:
C:\CLIPPER5\SOURCE\RL> COPY RL.EXE C:\CLIPPER5\BIN
9. Move to your PE directory, re-compile PE.
EXAMPLE:
C:\CLIPPER5\SOURCE\RL> CD \CLIPPER5\SOURCE\PE
C:\CLIPPER5\SOURCE\PE> RMAKE PE /F
Copy PE.EXE to your BIN directory.
EXAMPLE:
C:\CLIPPER5\SOURCE\PE> COPY PE.EXE C:\CLIPPER5\BIN
10. Move to your PLL directory, rebuild BASE52.PLL and BASE52.PLT.
EXAMPLE:
C:\CLIPPER5\SOURCE\PE> CD \CLIPPER5\PLL
C:\CLIPPER5\PLL> RTLINK @BASE52
Do not become alarmed if the message: "Undefined Symbols...
should be resolved at EXE generation" appears during this
step.
11. The update process is now complete.
LIST OF UPDATED FILES:
This is a list of all files that have changed since the
release CA-Clipper 5.2.
CA-Clipper 5.2d upgrade marks all CA-Clipper files with a
date stamp of 03-25-94 and a time stamp of 5:24am.
ExoSpace upgrade IF APPLIED marks TWO files listed below with
a date stamp of 4-21-94 and a time stamp of 1:06am.
Now it is easy to check if the upgrade applied properly.
The exception are files from \PLL and \SOURCE\PE subdirectories.
They have never been changed and have a date stamp of 02-15-93
and a time stamp of 5:20am.
The files DBU.EXE, RL.EXE, PE.EXE, BASE52.PLL and BASE52.PLT
will have the date and time stamp of when they were most
recently rebuilt.
The following subdirectories are created (if they do not exist)
under the SOURCE directory for API sample files.
SDX, ERROR, FILESYS, ITEM and VM.
Directory of C:\CLIPPER5\BIN
CLD HLP 19677
CLD EXE 54415
CLIPPER EXE 198968
Directory of C:\CLIPPER5\INCLUDE
ACHOICE CH 951
CLIPDEFS H 1703
EXTEND H 238
INKEY CH 8579
RDDSYS CH 342
STD CH 51453
Following files are added for API
ERROR API 2090 Error System API header file
EXTEND API 2194 Extend System API header file
FILESYS API 2652 File System API header file
FM API 811 Fixed Memory API header file
GT API 2734 General Terminal API header file
ITEM API 1802 Item API header file
RDD API 27716 RDD API header file
RULES RMK 2312 Common RMAKE dependencies file
VM API 1093 Virtual Memory API header file
Directory of C:\CLIPPER5\LIB
ANSITERM LIB 12321
CLD LIB 80719
CLIPPER LIB 516769
DBFCDX LIB 107993
DBFMDX LIB 90757
DBFNDX LIB 27175
DBFNTX LIB 38977
EXTEND LIB 127931
NOVTERM LIB 13857
PCBIOS LIB 14369
SAMPLES LIB 53891
TERMINAL LIB 14369
Directory of C:\CLIPPER5\OBJ
CDXLOCK OBJ 6679
CT2PATCH OBJ 4703
NTXLOCK2 OBJ 302
Directory of C:\CLIPPER5\SOURCE\DBU
DBU PRG 24063
DBUCOPY PRG 17556
DBUEDIT PRG 22484
DBUNET PRG 8931
DBUVIEW PRG 67609
Directory of C:\CLIPPER5\SOURCE\RL
RL RMK 436
RLBACK PRG 40489
RLDIALG PRG 10626
RLFRONT PRG 40165
Directory of C:\CLIPPER5\SOURCE\SAMPLE
BROWSE PRG 10294
STUFF C 2982
TBDEMO PRG 12398
Directory of C:\CLIPPER5\SOURCE\SYS
FRMBACK PRG 17716
FRMRUN PRG 28257
LBLRUN PRG 7192
Directory of C:\CLIPPER5\SOURCE\SDX:
README SDX 13564 RDD API Sample code
SDX C 43468 " "
SDX H 3876 " "
SDX RMK 951 " "
SDXDYN ASM 1944 " "
SDXINIT PRG 300 " "
SDXINTER C 7781 " "
Directory of C:\CLIPPER5\SOURCE\ERROR:
FILEOPEN C 2714 Error API Sample code
Directory of C:\CLIPPER5\SOURCE\FILESYS:
FILEOPEN C 2714 Filesys API Sample code
Directory of C:\CLIPPER5\SOURCE\ITEM:
CC C 1410 Item API Sample code
CCTST PRG 641 " "
CCTST RMK 436 " "
DFUNC C 1356 " "
DFUNCTST PRG 584 " "
DFUNCTST RMK 428 " "
ISDBL C 609 " "
ISDBLTST PRG 1229 " "
ISDBLTST RMK 475 " "
TESTBED PRG 854 " "
UACLN C 1888 " "
UACLNTST PRG 1274 " "
UACLNTST RMK 435 " "
UARRY C 1863 " "
UARRYTST PRG 1180 " "
UARRYTST RMK 443 " "
UEVAL C 893 " "
UEVALTST PRG 2121 " "
UEVALTST RMK 479 " "
YESNO C 837 " "
Directory of C:\CLIPPER5\SOURCE\VM:
BOOTREAD PRG 603 VM API Sample code
BOOTREAD RMK 245 " "
BOOTSEC C 1996 " "
CCVM C 1372 " "
CCVMTST PRG 661 " "
CCVMTST RMK 440 " "
HEXAMP C 1122 " "
TESTBED PRG 854 " "
VCOPYTST PRG 863 " "
VCOPYTST RMK 462 " "
VMCOPY C 12498 " "
ExoSpace files (if installed)
EXOSPACE EXE 642835
EXOSPACE NG 110905
=============================================================================
B. Problems resolved by CA-Clipper 5.2d:
1. Fixed a VMIF in the Object Memory Manager. This occurred in low memory
situations when the OMM took space from the VM segment that it was
attempting to expand.
2. Fixed a GPF/VMIF in the Object Memory Manager's garbage collector that
occurred when there were a large number of static variables.
3. Fixed the FIELDPOS() function so that it no longer returns misleading
results when passed an invalid argument.
4. Fixed bug in oStrDup() where an incorrect number of bytes were being
copied to an incorrect location for dedicated VM segments.
5. Fixed a VMIF in the Object Memory Manager that occurred when performing
an incremental garbage collection on an array that had just satisfied
the requirement for occupying its own dedicated VM segment.
6. Fixed a GPF that occurred when growing the class/dictionary table.
This happens when instantiating a class or creating a dictionary
when the dictionary/class table is full.
7. Fixed the RDD manager so it does not become corrupted when the VMM
swaps its data to disk. This occurred only in a very low memory
situation.
8. Panning right in a TBROWSE containing a single frozen column no
longer causes TBROWSE to go into an infinite loop when trying to
redisplay.
9. Fixed a GPF in TbrowseNew() and TbrowseDB() in certain memory
configurations.
10. Fixed a GPF in the function ALIAS([<nWorkArea>]) when
nWorkArea > 255.
11. Fixed the GPF caused by function ORDKEY() with an invalid
<cOrderName>.
12. Fixed the SET DELETED ON command so that it does not affect record
visibility on a network.
13. Fixed the SORT command so that it deallocates the memory it allocated
before returning control to its caller.
14. Fixed internal errors 650, 775 and 999 that occurred when the compiler
did not produce correct code for statements that contained an extra
set of parentheses.
EXAMPLE: (( Test() ))
15. Fixed C3039 PHASE ERROR in the compiler that occurred when a .PRG
source file contained several static variables that were inline
initialized to a codeblock.
EXAMPLE: static Var1 := { | x | func1( x ) }
static Var2 := { | x | func2( x ) }
static Var3 := { | x | func3( x ) }
16. Fixed a lockup in the compiler that occurred when a .PRG had a large
number of STATIC variables.
17. Fixed the compiler so that /Z switch has effect on expressions that
contain constants.
18. Fixed the compiler so it will not produce the "C3050 Something
terrible has happened" error when it encounters a user defined
function whose argument is being negated.
Example: MyUDF( -X )
19. Fixed a problem in the compiler that allowed it to accept illegal
comment blocks.
EXAMPLE: /**/*/
20. Fixed the compiler so it now generates an error when it encounters
one of the following incorrect control blocks:
IF...ELSE...ELSE...ENDIF
IF...ELSE...ELSEIF...ENDIF
21. Fixed the compiler to generate an error when it encounters the
following statement: Alias->Alias-><field>
22. Fixed the compiler so it does not generate an error when it
encounters an expression containing multiple NOTs.
EXAMPLE: iff( ! ! .t., .t., .f. )
23. Fixed the compiler so it does not generate an error when it
encounters a statement in which an aliased expression contains extra
parenthesis: (MyFunc())->DBFfield
or: ? (MyFunc())[x]
24. Fixed the compiler so it will not produce the "C2005 Statement not
recognized match failed at: '&'" error when it encounters the
following:
@ nCol, nRow SAY "string" + &(macro_expression)
25. Fixed evaluating a macro that contains an alias caused a syntax
error in the next macro evaluation.
EXAMPLE:
? &( "aTest[1]" ) // <value>
? &( "test->( RECNO() )" )
? &( "aTest[1]" ) // Syntax error - &
26. Fixed a lockup that occurred when a memvar was created within a
macro. The scope of that memvar was incorrect, it expanded to the
upper lever procedure.
EXAMPLE: &("MEMVAR->dummy") := 666
27. Fixed a lockup that occurred when using a macro to expand an
expression, that contains an alias.
EXAMPLE: &(alias(1))->( Recno() )
28. Fixed SELECT() so it now returns 0 when passed an invalid parameter.
29. Fixed DBCREATE() so it generates a run-time error when it is passed
an unknown RDD name instead of hanging the system.
30. Fixed The USE command so it does not upper-case convert the
contents of the variable which is used in VIA clause.
31. Fixed DBCREATE() so it generates a run-time error when there is not
enough space on a drive.
32. Fixed the database/index synchronization as in the following example:
SET ORDER TO <order>
REPLACE <not a keyfield>
SKIP()
SET ORDER TO <another order>
SKIP(-1)
? RECNO()
33. Fixed the 'INDEX ON <exp> TO <file> WHILE <exp>' command so it
does not create only one record in the scoped index (regardless
how many meet the WHILE condition) when the current index order
was used, and the most recent DBF movement was not an index
movement (SKIP, SEEK).
34. Fixed the updating of the conditional .NTX file when a field,
that was not in the key expression, was updated.
35. Fixed index file update failure on complex key expression when
the multiple fields were being concatenated as a key and the key
field(s) value(s) were subsequently changed.
36. Fixed the 'REPLACE <memo_field> WITH' command so it will not cause
a program to lock up if it attempts to write memo information to
disk with insufficient space.
37. Fixed the following commands:
COPY TO...SDF, COPY TO...DELIMITED
APPEND FROM...SDF, APPEND FROM...DELIMITED
so they do not hang the system when the DEFAULT option is chosen
from the 'cannot open/create file' error message.
38. Fixed the COPY TO [ SDF | DELIMITED ] command so it does not close
the current workarea when the DEFAULT option is chosen from the
'cannot open/create file' error message.
39. Fixed the COPY TO command when the current database is the child of
a relation and there is a pending seek.
40. Fixed CREATE FROM & COPY STRUCTURE so they work when the target is a
disk drive designator and file name without a backslash.
EXAMPLE: C:FileName
41. Fixed the APPEND FROM SDF command so it would ignore null-characters
when it reads SDF-file.
42. Fixed TBrowse so that 'hitBottom' would report .T. if an attempt
was made to go past the end of the available data when there are
not enough records to completely fill the TBrowse display and
refreshAll() is invoked prior to stabilization.
43. The decimal portion of the field definition for date, logical and
memo fields is now initialized.
44. Fixed the function ORDSETFOCUS() to ignore an invalid <cOrderName>
as per documentation.
45. Fixed the function ORDSETFOCUS() to return an empty string when a
database has no controlling order and the DBFNDX driver is used.
46. Fixed the function INDEXKEY() to return an empty string when there
was no database opened in a workarea.
47. Fixed the functions ORDBAGNAME(), ORDNAME(), ORDNUMBER(), ORDKEY(),
ORDFOR() to provide an argument type checking. The following
run-time errors are generated when one or more of the arguments are
of the wrong type:
Error DBCMD/1021 Argument error: ORDBAGNAME
Error DBCMD/1022 Argument error: ORDFOR
Error DBCMD/1023 Argument error: ORDKEY
Error DBCMD/1024 Argument error: ORDNAME
Error DBCMD/1025 Argument error: ORDNUMBER
48. Fixed the inconsistency between OrdSetFocus("") and OrdSetFocus(0).
Now OrdSetFocus("") also restores the natural order.
49. Fixed OrdNumber("") so that it returns zero rather than the number of
orders for the workarea when DBFNDX driver is used.
50. Fixed the GO <n> command when DBFNDX driver is used and the data
type of <n> was DOUBLE, not LONG.
51. Fixed the OrdName(0) so it would return the name of the
current controlling order when DBFNDX driver is used.
52. Fixed the OrdNumber(<cOrdName>) when DBFNDX driver is used and
there is no <cOrdName> in the Order List.
53. Major revisions have been made to the DBFMDX driver to rectify
the problems in the previous versions.
54. Fixed SET ALTERNATE so it generates a run-time error when there
is no space available on the disk.
55. Fixed the STRTRAN() function so it no longer goes into an infinite
loop when the cSearch parameter is a zero length string.
56. Fixed ALLTRIM() so it generates an error when given an argument
of the wrong type.
57. Fixed the function DIRECTORY (, "V") so it does not pad the
volume name with garbage, if its length is exactly 8 characters
long.
58. All commas contained in a GET's PICTURE clause are now copied into
the GET's edit buffer.
59. When a GET's PICTURE clause contains an '@R', the number of
editable positions in its edit buffer is now calculated
correctly.
60. When a GET's PICTURE clause contains an '@R', non-picture characters
beyond the last editable position are now displayed.
61. When a GET's PICTURE clause contains a paren, a leading paren in its
edit buffer now causes the value to be parsed as a negative number.
62. A bug was fixed in which GETs that had a PICTURE clause containing a
leading '$' would sometimes display negative values with multiple
'$' characters.
63. The size of a GET's edit buffer no longer increases if its PICTURE
clause contains a paren, and a negative value is entered into its
edit buffer.
64. In the #command for GET, the smart stringify result marker was
replaced by a normal stringify result marker. The previous use of
the smart stringify marker had caused parsing problems whenever an
aliased variable was used in a GET command.
65. The ALERT() function now updates the LASTKEY status.
66. Fixed ALERT() so that it no longer exhibits occasional problems
when fewer than four option strings are used.
67. Fixed FSEEK() so that it rejects requests that would cause the
resulting absolute file position to become negative. In such
cases the current file position is left unchanged and an error
flag is set; the value of this flag can be retrieved by calling
the FERROR() function.
68. Fixed the 'SET FUNCTION <nnn> TO' command so that it will now
accept strings that contain only white space.
69. The SET DATE FORMAT code was modified so that the format string
must contain non-numeric delimiters between the month, day, and
year portions.
70. Fixed the DEVPOS() function so that it now immediately responds
to an error condition.
71. Fixed STUFF() so it will generate a run-time error when there is
insufficient virtual memory to create it's data buffer.
72. Fixed VAL("-.nnnn") so it does not return "******" now.
73. Fixed DBU so it does not go to an endless loop if there is a
filter set on a field and if GOTO is used and a record number is
given that is not one of the records matching the filter.
74. Fixed DBU to respond to the <ENTER> key when BROWSEing a
database in which none of the records match the filter condition.
75. Fixed DBU so it does not go to an endless loop if, when VIEWing
an empty database, the user presses any character key.
76. Fixed DBU to update and reopen indexes after PACKing or ZAPing
a database.
77. Fixed DBU so that BROWSE reflects the filter condition after
PACKing or ZAPing a database.
78. Fixed the REPORT FORM command's sub-grouping feature when the
name of the last subgroup in a group was the same as the name
of the next group.
79. Fixed the REPORT FORM command without the TO PRINT clause so it
produces the printer output if SET PRINT ON command was
previously issued.
80. The multi-lines per record using ";" - method is now implemented.
81. Fixed the number of lines on the first REPORT page to be the same
as the number of lines on the following pages.
82. Fixed the REPORT FORM command not to do page eject after subgroup
if page eject after group flag was set to TRUE.
83. Fixed the REPORT FORM heading not to be truncated when page width
is set to 61 or more characters.
84. Fixed the CA-Clipper Debugger so it does not display garbage in
the last line of the Monitor Window when <PgDn> was pressed.
85. Fixed RLOCK() and DBRLOCK() so that it would not fail if the database
was the child of a relation and there was a pending seek.
86. Fixed the failure of the RLOCK() function when invoked after a
successful FLOCK() on an open shared database.
=============================================================================
=============================================================================