home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / bufop.zip / BUFOP.DOC next >
Text File  |  1993-09-11  |  3KB  |  57 lines

  1. BETA VERSION
  2.  
  3. Bufop -  precompiler for programmers using C/C++  and the IBM DB2/2.
  4.  
  5. Bufop is a replacement for the IBM sqlprep program that comes standard with the IBM DB2/2 database.  However, this version is designed for, and has better support for C programmers (read & write to/from structures) and C++ programmers who can embed SQL into their classes.
  6.  
  7. Use - the same format of the sqlprep is used as input to Bufop.(don't support line numbers yet).
  8.  
  9. Features:
  10.  
  11. The SQL INCLUDE 'filename'  will process the include file name without embedding the file into the source.  This implies the class definitions and structures can be defined in a header file(s).  This facility allows a single program can be built to process an entire project.
  12.  
  13. example
  14.  EXEC SQL INCLUDE 'proga.sqc'   // which also includes headers
  15.  EXEC SQL INCLUDE 'progb.sqc'  //  which also includes headers
  16.  EXEC SQL INCLUDE 'progc.sqc'  //  which includes headers and other programs
  17.  
  18.   
  19. Read to  & write from a structure
  20.  
  21. Read into & write from within a class (including inherited attributes that are public or protected).
  22.  
  23. The optional use of booleans on WHENEVER statements.  (Can generate a goto or set a Boolean for program inspection - great for do while  found loops)
  24.  
  25. slightly better diagnostics in the event of an error in an SQL statement (all used variables are dumped along with their types)
  26.  
  27. future
  28.   direct support for date and time data types
  29.   clean up of the generated code
  30.   better examples and starter stuff.
  31.   better optimization  (the current optimization is dangerous because the addresses of the structures or class data could change with each call)
  32.  
  33. A note about the example:
  34.  
  35.   The sample code was developed to test some of the features of the precompiler.  Style and performance were not much of a consideration when these test cases were developed.  Also - If you do not have the IBM C/Set++ compiler, the use of the container class could be removed or replaced. 
  36.  
  37. BETA Restrictions 
  38.   THIS IS A BETA - I have not had the time to do extensive testing on all of the input options.
  39.  
  40. I have not tested user defined SQLDAs ( and I'll bet they don't work)
  41.  
  42. I do not yet support variable length strings with two byte lengths (i.e. structures for this data type).
  43. The product is still a little fragile when encountering some errors.
  44.  
  45. If you have any suggestions for improvements/changes to this product please either write to me or E-Mail on compuserve.  
  46.  
  47. IMPORTANT  - this is a beta,  USE AT YOUR OWN RISK. While every effort has been made to make this a useful product, there is no guarantee it will meet all of your requirements.
  48.  
  49.   
  50. If  you would like a copy of the finished product,  full documentation and more extensive examples using PM & the container classes,  then please send a check for $25.00 (US) for each developer to::  
  51.  
  52. Ross Software
  53. 1625 Red Mill Drive
  54. Upper St Clair, PA 15241.
  55.  
  56. The product should be finished by the end of November. 
  57.