home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / btrvrx.zip / READ.ME < prev    next >
Text File  |  1993-08-21  |  2KB  |  33 lines
  1. I place this code in the public domain, and make absolutely no 
  2. representations about its reliability or suitability.  That being said, 
  3. it would appear from initial testing that BTRVREXX.DLL does indeed 
  4. function correctly as a REXX external function providing an interface to
  5. Btrieve 5.10a for OS/2 (BTRCALLS.DLL) under OS/2 2.1.
  6.  
  7. The file TEST.CMD demonstrates the use of the DLL with a simple call. 
  8. Note that BTRVREXX is a "dumb" interface to BTRCALLS.  All parameters 
  9. used by BTRCALLS must be allocated by the REXX caller and are passed 
  10. through as-is in both directions by BTRVREXX.  The caller is completely 
  11. responsible for deciphering the character-string results into meaningful
  12. information.
  13.  
  14. The function entry point BTRV requires six parameters, all of which 
  15. represent parameters to BTRCALL itself.  The first and sixth parameters 
  16. (operation code and key number, respectively) are expected to be numeric
  17. constants, and the remaining four parameters are expected to be 
  18. character-string names of REXX variables that the REXX caller has 
  19. preallocated with the proper length and contents.  These four variables 
  20. are the position block (which will need to be a global variable for 
  21. proper Btrieve operation), data buffer, data buffer length, and key 
  22. buffer (which should be allocated as 255 bytes, the maximum Btrieve key 
  23. length).  The data buffer can by up to 32000 bytes in length.
  24.  
  25. Compiled with CSet++
  26.  
  27. If you have any comments about this interface, please contact me on 
  28. CompuServe at 70304,1316.  In particular, I would of course appreciate 
  29. receiving any corrected or improved versions!
  30.  
  31.         Gary Kopp
  32.         8-21-93
  33.