Category : Alternate Operating Systems - Quarterdeck DesqView, CP/M, etc
Archive   : QWAUG92.ZIP
Filename : CLIPPER5.TEC

ID:C5 Clipper API library & Clipper 5.0
Quarterdeck Technical Note #181
by API Technical Support Team

Re: Upgrading the API Library for Clipper to Clipper 5.0
To: Clipper API developers

Quarterdeck has definite plans to upgrade the DESQview API Library for Clipper
to provide full support for Clipper 5.0. No release date has been set.

The current API LIbrary version 1.01 (designed to support Clipper Summer '87)
can be easily modified to support Clipper 5.0. All you need to do is modify
the DVAPI.LIB library file. Perform the following general steps:

Install the Clipper UDFs onto your hard disk.
Recompile all the Clipper UDFs with Clipper 5.0 to create
new OBJ files.
Create a response file for the LIB.EXE library manager.
Use LIB.EXE to remove EXTOR.OBJ from DVAPI.LIB and replace
the old UDFs within DVAPI.LIB with the new 5.0 OBJs.

Note that the "C" and Assembler UDFs within DVAPI.LIB require no changes.

Take the following steps to convert the DVAPI.LIB library file to work with
Clipper 5.0:

1. If not already done, install the library's Clipper source files (*.PRG)
from the "Clipper Source" disk:

Create a C:\DVAPI\PRG subdirectory under C:\DVAPI.
Log onto that subdirectory.
Insert the "Clipper Source" disk into drive A:.
Execute the self-extracting PRG.EXE PKUNZIP file:

a:prg.exe

This will unzip all the PRG files into C:\DVAPI\PRG.

2. Recompile all the PRG files with Clipper 5.0. Create and run the
following batch file MKOBJS.BAT containing:

for %%f in (p_*.prg) do clipper %%f -m

This will create a P_*.OBJ file for each P_*.PRG file.

3. Log onto C:\DVAPI where DVAPI.LIB should reside and create a DVAPIPRG.RSP
response file for Microsoft's LIB.EXE containing:

DVAPI
-c\EXTOR&
-+prg\P_APPRUN&
-+prg\P_FLDATG&
-+prg\P_FLDATP&
-+prg\P_FLDATS&
-+prg\P_KEYACC&
-+prg\P_KEYCLE&
-+prg\P_KEYINK&
-+prg\P_KEYINP&
-+prg\P_KEYKEY&
-+prg\P_KEYLAS&
-+prg\P_KEYNEX&
-+prg\P_KEYREA&
-+prg\P_KEYSET&
-+prg\P_KEYWAI&
-+prg\P_QRYFTA&
-+prg\P_WINACH&
-+prg\P_WINATB&
-+prg\P_WINATC&
-+prg\P_WINATG&
-+prg\P_WINATP&
-+prg\P_WINATS&
-+prg\P_WINATT&
-+prg\P_WINBRO&
-+prg\P_WINCCO&
-+prg\P_WINCLE&
-+prg\P_WINCLG&
-+prg\P_WINCSC&
-+prg\P_WINDAT&
-+prg\P_WINDBE&
-+prg\P_WINMAR&
-+prg\P_WINMEN&
-+prg\P_WINREA&
-+prg\P_WINRES&
-+prg\P_WINSAV&
-+prg\P_WINSET
NUL
DVAPI

4. Remove EXTOR.OBJ from DVAPI.LIB (with Clipper 5.0 it has been added to
CLIPPER.LIB) and replace the old Summer '87 P_*.OBJ files within
DVAPI.LIB with the new 5.0 P_*.OBJ files:

Execute LIB.EXE with the DVAPIPRG.RSP response file:

lib @dvapiprg.rsp

This creates a new DVAPI.LIB file which supports 5.0. You may now recompile
your source programs with Clipper 5.0 and relink with RTLink for Clipper 5.0.

Beware! The initial release of Clipper 5.0 has some major bugs due mostly to
its VMM. So, don't call Quarterdeck if you have problems executing Clipper
5.0 programs linked with your new DVAPI.LIB.

For further information, contact:

API Technical Support
Quarterdeck Office Systems
(310) 392-9701 Phone
(310) 314-3217 Fax

************************************************************************
*This technical note may be copied and distributed freely as long as it*
*is distributed in its entirety and it is not distributed for profit. *
* Copyright (C) 1990-2 by Quarterdeck Office Systems *
************************ E N D O F F I L E *************************