Topspeed_JPI/TS-V3/MODBASE/readme.txt

Dear Customer:

Repertoire and ModBase are now a dual-mode library. The same 
ModBase or Repertoire library  can be linked with OS/2's 
DOSCALLS.LIB to produce an OS/2 protected mode executable. If 
you are developing for DOS under OS/2, the benefit is that you 
can do all your debugging in protected mode; Since you don't 
have to recompile for DOS, you eliminate a large source of 
potential errors.  You also eliminate the version control 
problems inherent in maintaining a set of files for OS/2 and a 
parallel set for DOS.

If you are still developing entirely under DOS, you have greater 
assurances of reliability; You know that the REPERTOIRE object 
code you are linking in is free of pointer problems because it 
works in protected mode.

Users of both OS/2 and the DOS versions of STONY BROOK'S ,JPI's 
or LOGITECH professional compilers can use the same copy of 
Repertoire or ModBase libraries to generate a real-mode (DOS) 
executable, simply link your application with RPRTOIRE.LIB and 
FAPI.LIB to generate a protected mode (OS/2) executable, link 
OS/2's DOSCALLS.LIB instead of FAPI.LIB, and be sure to link in 
our OS/2INIT.OBJ with the rest of your OBJ files; OS2INIT.OBJ 
will prevent you from getting messages from the linker that 
"__api__init" is unresolved.

Recently it was discovered that limitations in FAPI.lib 
make it impossible to exceed the DOS file limit with maxfiles.  
This is not a problem under OS/2 and should not be a problem 
with jpi's DOS extender that you would link just as it was an 
OS/2 program.  This will be taken care of but it will require a 
major rework of fapi.lib that was planed anyway. The database 
demo pmi.exe in database.zip was developed under OS/2  and uses 
25 files. It only opens its files as it needs them but it may 
eventually fail due to the lack of handles. You can explore all 
areas by exiting after checking out each part of the program. 
You should find it useful. If you wish to use it as a basis an 
application there should be some part of it you will not need. 
If it was to be run under DOS with all of the files currently 
used just closing all the index files after exiting each section 
would take care of the problem. Index files are automatically 
opened as needed. Just make sure you don't close an index file 
while it is being used to sequence through a datafile. 

The demo pmi.exe in database.zip is based on an in use  multiuser
application for a ballon and novelty bussiness.  Any quirks are
most likely caused by a quick conversion from one compiler to
another and then to dos.

Here is what is on the disks:
README.TXT      This file
DATABASE.ZIP    Relational order entry and inventory            
		program see comments above.
 
DBGEN.ZIP       Single table database generator program.        
		No documemtation. Build table, create           
		dbf files and indexes, makes edt file                   
		and using 'tpl' template        files                           
		generates code for program. Was used to                         
		get head start writing the database                     
		program above. Both by Ed Ross.

FAPI.ZIP        FAPI.LIB os2init.obj os2init.lib os2init        
		contains a dummy procedure for the                      
		initialization call for FAPI.LIB which                  
		is not used under os/2.

MB3SB.ZIP       Modbase library for Stony Brook. Built  
		under DOS but can use LIB under os/2.

MB3TS.ZIP       ModBase objs for TS 3.0.

MBDEMO.ZIP      Test and demo programs.

MBSRC.ZIP       ModBase Defs and Mods.

SBREPOBJ.ZIP    Stony Brook Libray for Repertoire.

TSREPOBJ.ZIP    Top Speed 3 Library for Repertoire also 
		Defs.

PKUNZIP.EXE     Unarchiving program. All have sub               
		directories in them. Type Pkunzip -d            
		<name>. Type pkunzip <return> for help.

REPMODS.ZIP     Mod files for parts of Repertoire used by ModBase.

REPLOG1.ZIP     Repertoire Syms for Logitech 4.0 

REPLOG2.ZIP     Logitech 4.0 stuff. Rest of compiler dependent parts and
                library for Repertoire.

For Top Speed 3 you can use the project files os2.pr or dos.pr
all librarys are compiles as mutithreaded.
	
You need to link the following under dos:
ModBase objs
rt_rep.lib   
FAPI.lib

You need to link the following under os/2:
ModBase objs
rt_rep.lib   
os2init.obj

For Stony Brook you need the following:
You need to link the following under dos:
mb3sb.lib
repsb.lib   
FAPI.lib

You need to link the following under os/2:
mb3sb.lib
repsb.lib   
os2init.obj





Feel free to contact us if you have any questions or problems.

John McMonagle