home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: InfoMgt / InfoMgt.zip / genmb107.zip / Readme.1st < prev    next >
Text File  |  1997-06-24  |  19KB  |  513 lines
  1. This is the readme.1st file for RXDbase and MaxBase.
  2. Please read all of it before installing or upgrading.
  3.  
  4. NOTE: Please see the end of this document to read 
  5. about the license for this package.
  6. RXDbase is *not* freeware (though it is cheap!).
  7.  
  8. NOTE2: When you find errors in any of the applications in this package, please
  9. report them to maxmars@pianeta.it, along with the error dump (you can find
  10. that in the shell where you have launched the program) and an explanation
  11. of what you were doing.
  12.  
  13. HOW TO GET 'LATEST AND GREATEST'
  14. "'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'
  15.  
  16. The web page for maxbase can be found at:
  17.  
  18. *************************************************
  19. http://www.bmtmicro.com/catalog/mb-web
  20. (BMT-Micro in USA, with secure online order form)
  21. *************************************************
  22.  
  23. *************************************************
  24. http://www.ososoft.com/RXDBASE.HTM
  25. (OsoSoft in Italy, with plain online order form)
  26. *************************************************
  27.  
  28. You can get MaxBase from any of the two.
  29.  
  30.  
  31.  
  32. UPDATING
  33. "'"'"'"'
  34.  
  35. Users updating from earlier versions of MaxBase 
  36. should shut down any MaxBase instance which is
  37. running and unzip this file into the existing 
  38. MaxBase directory.
  39.  
  40.  
  41.  
  42. DIFFERENCES FROM 1.06
  43. "'"'"'"'"'"'"'"'"'"'"
  44.  
  45. .) Speeded up most operations by means of both
  46.    code optimizations and adding multithreading.
  47.    The speed up should be noticeable.
  48. .) MaxBase now doesn't "flash" anymore.
  49. .) Import/Export has been enhanced: now it also works 
  50.    with DB IV files.
  51. .) Changes to the underlying RXDbase; please use Sportello
  52.    1.07 and SpApplet 1.07 to access RXDBServer 1.07.
  53. .) When viewing 50 records at a time, user now can move
  54.    forward or backward 50 records-wise and an indicator
  55.    of the position of the current batch of records has 
  56.    been added.
  57. .) Filter screen: two lists from which to select fields
  58.    and operators (.&. included) have been added.
  59. .) When in form view, it is not possible anymore to modify
  60.    a record.
  61. .) Added keyboard shortcuts (PGUP/PGDN, UP/DOWN, etc)
  62.    also to the database creation section.
  63. .) Add/Modify screens: Letters are now cut off (if in 
  64.    eccess) when you move to another field.
  65. .) Form view can be used now also to browse the archive
  66.    instead of only presenting one record.
  67. .) Small cosmetic changes (like the 'Hit cancel' message
  68.    which was pointing to a non-existant button).
  69. .) Corrected: add and modify screens now correctly
  70.    report number of records in the archive.
  71. .) Corrected: Now you can access a remote archive which is empty.
  72. .) Corrected: Minor filter failures.
  73. .) Corrected: MaxBase faulting (sometimes) after adding 
  74.    fields.
  75. .) Corrected: Minor bugs.
  76.  
  77.  
  78.  
  79. ACKNOWLEDGMENTS
  80. "'"'"'"'"'"'"'"
  81.  
  82. Many thanks to Giuseppe Aprile for his great .dbf <---> .dat conversion
  83. utilities. Also thanks to all the testers who have helped me while I
  84. was (but I still am and will be!) developing MaxBase.
  85. Thanks saCUL, Penny and all the others!
  86.  
  87.  
  88. INSTALLATION AND FIRST STEPS
  89. "'"'"'"'"'"'"'"'"'"'"'"'"'"'
  90.  
  91. Warning: this program heavily depends on the quality of your Java VM.
  92. Please get and install the latest release of the Java VM for your
  93. computer/Operating System before running MaxBase.
  94.  
  95. PLEASE NOTE that the programs in this package WON'T run unless you have told your
  96. computer / O.S. where to find the .class files.
  97.  
  98. 1) The easiest way.
  99.  
  100.  I have included a very simple 'runme.bat' batch file for Windows 95 which, 
  101.  if run from the program's directory, will start the MaxBase [local version].
  102.  You can create a shortcut on Windows 95 and let it point to that batch file.
  103.  
  104.  I would be glad to hear from users on how to create installation procedures 
  105.  for other operating systems.
  106.  
  107. 2) The more, the better.
  108.  
  109.  If you need\want to use also the networking extensions for MaxBase you'll need
  110.  to tell your Java runtime where to find MaxBase classes:
  111.  
  112.  As a rule of thumb, in order to install MaxBase you should only update
  113.  the CLASSPATH environment variable, adding the x:\dir\MBaseR.zip entry
  114.  [where 'x:' is the drive and 'dir' is the directory where you have
  115.  installed MaxBase], much like this:
  116.  
  117.  SET CLASSPATH=x:\dir\MBaseR.zip;%classpath%
  118.  
  119.  Then go to the "client" or "server" directory and use the batch files
  120.  (which have comments in them).
  121.  
  122.  
  123.  
  124. 1. If you are not a Java or NetRexx programmer.
  125.  1.1 QuickStart for MaxBase local version.
  126.  1.2 QuickStart for MaxBase networked version.
  127.  1.3 Publishing databases on the World Wide Web.
  128.  
  129. 2. If you are a Java/NetRexx programmer.
  130.  2.1 Where to go from here now (library for local database)?
  131.  2.2 Where to go from here now (library for networked databases)?
  132.  2.3 Where to go from here now (plugins for MaxBase)?
  133.  
  134.  
  135. 1. If you are not a Java or NetRexx programmer:
  136.  
  137. 1.1 QuickStart for MaxBase local version:
  138.     ---------- --- ------- ----- --------
  139.  
  140. Just unzip plugins.zip (or MACplug, UNIXplug if you use Macs or Unices), then
  141. type 'java MaxBase' and, via the GUI, connect to the database "imgs.dat".
  142. Select one or all of the entries in the database and click on the
  143. "view text/image" button.
  144. runme.cmd, runme.bat batch files are provided for OS/2 and Windows users.
  145. If you are a user from another system or machine, and have created a batch
  146. file to automatize the launch of MaxBase (local DB app) and/or Sportello
  147. (networked DB app, client side), RXDBServer (networked DB app, server side)
  148. please e-mail it to me at maxmars@pianeta.it.
  149.  
  150.  
  151. 1.2 QuickStart for MaxBase networked version:
  152.     ---------- --- ------- --------- --------
  153.  
  154. To run the server, you need to  use the batch files (runserver.cmd and
  155. runserver.bat) to put the server to work.
  156. If you launch RXDBServer.class without parameters, it will show you
  157. its usage. Eg. type "java RXDBServer" at the command prompt.
  158. ['runserver' is a batch file which issues 'java RXDBServer <parameters>']
  159.  
  160. To run the client, just launch runclient.cmd or runclient.bat giving as a
  161. parameter the IP address of the machine which has an RXDBServer running,
  162. the port on which that server is running and (optional) the password for
  163. the server. Without a password, you will be able only to browse the remote
  164. database (but only if the remote server is operating in safe mode).
  165. Beware that in most Java implementations you cannot use dotted decimal
  166. IP notation (unless you have some kind of host resolution hardiwred, as in
  167. OS/2 Warp 4's C:\MPTN\ETC\HOSTS file)
  168. ['runclient' is a batch file which issues 'java Sportello <parameters>']
  169.  
  170. For example, I have set up my machine to act as 10.0.0.1, and when I
  171. do my tests I fire up the server then I launch "runclient.cmd 10.0.0.1".
  172.  
  173.  
  174. 1.3 Publishing databases on the World Wide Web.
  175.     ---------- --------- -- --- ----- ---- ----
  176.  
  177. Please refer to the SportelloApplet.doc file into the "client" directory
  178. to learn how to publish your databases on the web (warning: in that
  179. document it is assumed that you know how to mantain a web page).
  180.  
  181.  
  182.  
  183.  
  184. 2. If you are a Java/NetRexx programmer:
  185.  
  186. Warning:
  187. ----------------------------------------------------------------------
  188. this package was created using NetRexx, a compiler (written in Java) which generates
  189. Java code. The programs generated by it (and all the programs here are such)
  190. need the NetRexx classes. A copy of these is here in this package,
  191. file NetRexxR.zip. Just copy NetRexxR.zip in a directory that's in your
  192. CLASSPATH environment variable, and you're OK (no need to unzip them).
  193. Be sure to have .\. (./. or whatever your OS needs) in the classpath environment
  194. variable.
  195.  
  196. More NetRexx info on my page or at http://www2.hursley.ibm.com
  197.  
  198. Read also the file 'license.txt' in the netrexx\lang directory that resides in
  199. NetRexxR.zip, because it contains the user license for those NetRexx classes.
  200. License.txt doesn't apply to RXDbase and MaxBase, though: for those two, refer
  201. to the .doc accompanying them.
  202.  
  203. From version 0.9 I've started using Taligent widgets. See Talicense.txt
  204. for the license.
  205. ----------------------------------------------------------------------
  206.  
  207. If you're interested in plugins for MaxBase and are using WinXX or OS/2, please
  208. unzip the file plugins.zip.
  209. If you are using a Mac unzip macplug.zip, and finally for Unix unzip unixplug.zip.
  210. Those packages differ for the included databases (in WinXX and OS/2 you have
  211. newline = \r\n, in Mac = \r and in Unix = \n) and plugin.ini.
  212.  
  213.  
  214. 2.1 Where to go from here now (library for local database)?
  215.     ----- -- -- ---- ---- --- -------- --- ----- ---------
  216.  
  217. The file to read is RXDbase.doc. I have also put here some examples
  218. (dbtest.nrx and dbtest2.nrx) which are coded in NetRexx.
  219.  
  220.  
  221. 2.2 Where to go from here now (library for networked databases)?
  222.     ----- -- -- ---- ---- --- -------- --- --------- ----------
  223.  
  224. The Networked, client side classess for RXDbase come in the form of RXDBClient.doc
  225. in the .\client directory. There are no server side classes or APIs since it's
  226. all handled by the server.
  227.  
  228.  
  229. 2.3 Where to go from here now (plugins for MaxBase)?
  230.     ----- -- -- ---- ---- --- -------- --- ---------
  231.  
  232. Readme.plugins is the place where to start to learn more about plugins.
  233.  
  234. MaxBase can be customized with little effort by means of plugins.
  235. Plugins are small Java or NetRexx applications which communicate
  236. with MaxBase to get the list of fields and records which were
  237. selected at the moment that the user launched the plugin, and then
  238. do specific tasks.
  239.  
  240. Let's see it a bit better:
  241.  
  242. 1) The user selects some records in MaxBase.
  243. 2) The user pushes a plugin button from within
  244.    MaxBase, thus launching a plugin.
  245. 3) MaxBase fires up the plugin, and waits until
  246.    the plugin has finished initializing itself.
  247. 4) MaxBase sends the plugin info about the fields
  248.    of the current DB and the records which are selected.
  249. 5) Now it's up to the plugin: it can do whatever it wants
  250.    with those data.
  251.  
  252.  
  253. PLATFORM CONSIDERATIONS
  254. "'"'"'"'"'"'"'"'"'"'"'"
  255.  
  256. I did test this program only on OS/2 Warp 4 and Win32.
  257. If you're using it under other platforms, please drop
  258. me a note on your results with it.
  259.  
  260.  
  261. PLEASE BE VOCAL
  262. "'"'"'"'"'"'"'"
  263.  
  264. Yes, I need _your_ feedback on errors, incompatibilites, suggestions, etc.
  265. So far I'm testing it only on the OS/2 platform (and some
  266. tests are done also on Win32). I'd be interested on
  267. feedback also from users of other O.Ss. and platforms.
  268.  
  269.  
  270. LICENSE
  271. "'"'"'"
  272.  
  273. Why should you register?
  274. Because this way you:
  275.  
  276. A) Receive (via e-mail or snail mail) the uncrippled
  277.    version of MaxBase.
  278. B) Receive for free all the updates up to version 2 for
  279.    MaxBase. [Note: bug-fixes are always seen as 1.X,
  280.    and so do most of the improvements until the program
  281.    is really different from version 1.0, and this won't
  282.    happen in 1997 anyway - I plan to release 1 major
  283.    release for year, with discounts for people who
  284.    already have an older version].
  285. C) Help the author decide that the developing of MaxBase
  286.    is a worthy cause, so he will be encouraged to add
  287.    many enhancements to it. :-)
  288.  
  289.  
  290.  
  291. With "program", it is intended the whole set of .class files included
  292. in this package.
  293.  
  294. If you have received this program as shareware, be warned that you
  295. have a period of 30 days to evaluate it, then you must choose:
  296.  
  297. 1) if you want to continue using this product, you must pay for it.
  298.  
  299. MaxBase can be registered via BMT-Micro - please see the end of the
  300. document.
  301.  
  302.  Register fees are:
  303.   US Dollars   29 .. for the standard edition (full local database
  304.                       + server able to receive 2 clients at once)
  305.   US Dollars   89 .. for the extended edition (full local database
  306.                       + server able to receive all the clients
  307.                       it can handle at once)
  308.  
  309. 2) if you don't like this program, or are unable to contact the author,
  310. you *must* stop using the program and you *must* uninstall it after the
  311. 30 days period.
  312.  
  313. 3) If you build an application with RXDbase, a *small* one-time fee
  314. must be paid to the author (contact me for details).
  315.  
  316. 4) Non profit organizations: please contact me for details; discounts
  317. are available.
  318.  
  319. I am not responsible or liable in any way for any damages
  320. deriving from the use of this product. Use it at your own risk.
  321.  
  322. The sources for RXDbase are not provided, and you cannot modify or disassemble
  323. the class, in any way. Also, you can not re-distribute this program unless
  324. you have the permission of the author (Max Marsiglietti).
  325.  
  326. RXDBase is (c) Max Marsiglietti 1996, 97.
  327.  
  328. See Also Talicense.txt (in the directory where you found this) and license.txt
  329. inside NetRexxR.zip.
  330.  
  331.  
  332.  
  333. CONTACTING THE AUTHOR
  334. "'""'"'"'""'"'"'""'"'
  335.  
  336. If you find any bug, or have suggestions, please
  337. report all of your comments to:
  338.  
  339.  Max Marsiglietti,
  340.  
  341.  E-mail:
  342.   maxmars@pianeta.it (Internet), 2:332/529.12 (Fidonet)
  343.  
  344.  Snail Mail:
  345.   V.Landino 13,
  346.   41049, Sassuolo (MO)
  347.   Italy.
  348.  
  349.  
  350. REGISTERING VIA BMT - MICRO
  351. "'"'"'"'"'"'"'"'"'"'"'"'"'"
  352.  
  353.                   Mail Orders To: BMT Micro
  354.                                   PO Box 15016
  355.                                   Wilmington, NC 28408
  356.                                   U.S.A.
  357.  
  358.                     Voice Orders: 8:00am - 7:00pm EST (-5 GMT)
  359.                                   (800) 414-4268 (orders only)
  360.                                   (910) 791-7052
  361.  
  362.                       Fax Orders: (910) 350-2937  24 hours / 7 Days
  363.                                   (800) 346-1672  24 hours / 7 Days
  364.  
  365.          Online Orders via modem: (910) 350-8061  10 lines, all 14.4K
  366.                                   (910) 799-0923  Direct 28.8K line
  367.  
  368.                     via Internet: orders@bmtmicro.com
  369.                                   telnet@bmtmicro.com
  370.                                   http://www.bmtmicro.com
  371.      Secure Ordering: https://wwws.wilmington.net/bmtmicro/secure_form.html
  372.  
  373.  
  374.      Ordering and general ordering questions:
  375.  
  376.                             Via AOL: bmtmicro
  377.                             Via MSN: bmtmicro
  378.                          Via Prodigy: HNGP66D
  379.                     Via Compuserve: 74031,307
  380.  
  381.  
  382.      We accept Visa, Mastercard, Discover, American Express, Diners
  383.      Club, Carte Blanche, Cashiers Check, Personal Check.   Personal
  384.      checks are subject to clearance.  Eurochecks in DM are welcome.
  385.      DM, Sterling, and US Currency is welcome but send only by
  386.      registered mail, return receipt requested.   We cannot be liable
  387.      for lost cash sent through the mail.
  388.  
  389.      If you reside in a country with an unconvertible currency please
  390.      contact us for alternatives.
  391.  
  392.      Purchase orders are welcome, subject to approval.   The minimum
  393.      amount is $250.00.
  394.  
  395.      Information for our German customers is explained in the last
  396.      paragraph of this order form.
  397.  
  398.      _____________________________________________________________________
  399.  
  400.      Company:_____________________________________________________________
  401.  
  402.      Name:________________________________________________________________
  403.  
  404.      Address:_____________________________________________________________
  405.  
  406.              _____________________________________________________________
  407.  
  408.      City: _______________________________State/Province: ________________
  409.  
  410.      Postal/ZIP Code: ____________________Country:________________________
  411.  
  412.      Phone:_______________________________________________________________
  413.  
  414.      Fax:  _______________________________________________________________
  415.  
  416.      E-Mail #1____________________________________________________________
  417.  
  418.      E-Mail #2____________________________________________________________
  419.  
  420.  
  421.      Product                    Quantity Price  Number of copies
  422.      _________________________  ______________  ________________
  423.  
  424.      _________________________  ______________  x ____________ = + $ _______
  425.  
  426.      _________________________  ______________  x ____________ = + $ _______
  427.  
  428.      _________________________  ______________  x ____________ = + $ _______
  429.  
  430.      Latest Version on Diskette _____$3.00____  x ____________ = + $ _______
  431.  
  432.  
  433.      North Carolina Residents add 6% Sales Tax                     $ _______
  434.  
  435.      Shipping and Handling (no quantity limit / see below)         $ _______
  436.  
  437.        Email - Subject to Credit Card Verification     Free
  438.        Fax (USA/Canada)...........................     1.00 US
  439.        Fax (Non-North America)....................     2.00 US
  440.        Worldwide 1st Class .......................     Free
  441.        2nd Day Priority, USA Only ................ $   4.00 US
  442.        US Postal Service International Express
  443.          (Including Canada and Mexico), allow up to
  444.          7-10 days ............................... $  25.00 US
  445.        Airborne Select Delivery  (USA Only)        $   8.00 US
  446.        FedEx Overnight, USA Only (delivery by
  447.          3:00 pm the following day) .............. $  15.00 US
  448.        FedEx Europe/Japan (guaranteed delivery
  449.          within 3 days) .......................... $  35.00 US
  450.  
  451.  
  452.      Total:                                                      $ _______
  453.  
  454.  
  455.       For credit card payment only
  456.  
  457.       Circle one: VISA / Master / Discover / American Express / Diners
  458.  
  459.       Credit card number: _____________________________________________
  460.  
  461.       Expiration date: ________________________________________________
  462.  
  463.       Authorization signature: ________________________________________
  464.  
  465.  
  466.  
  467.                    ORDERING FROM INSIDE GERMANY ONLY
  468.                    =================================
  469.  
  470. Persons in Germany wishing to order shareware may also transfer funds
  471. into our account with Deutsche Bank.   Once the money is deposited you
  472. may either fax a confirmation to us with proof of deposit or wait until
  473. Deutsche Bank notifies us of the transaction (usually 10-18 business days).
  474. Account information is as follows:
  475.  
  476. Deutsche Bank / Frankfurt Branch
  477. Empf║nger:  Thomas Bradford
  478. Konto-Nummer: 0860221
  479. Bankleitzahl: 500-700-10
  480.  
  481. When you make the transfer, be sure to put your name and the program you
  482. are registering on the transfer.
  483.  
  484. Current exchange rates can be obtained by sending an email to
  485. dm_to_us@bmtmicro.com.   An automated reply will return todays exchange
  486. rates.
  487.  
  488. It is very important that you send us a completed order form by
  489. either email or fax if you deposit money into this account for a
  490. registration.  Fill the order form out as usual except in the credit
  491. card number field put "DEUTSCHE BANK".   We will file the order and
  492. use it to match against the deposit information we receive from the
  493. bank.
  494.  
  495.                                IMPORTANT!
  496.                                ----------
  497. When you email us your order form, we will reply with an
  498. acknowledgement.   If you do not get an acknowledgement within 24 hours
  499. please send your order again in case it was lost.  This extra bit of
  500. caution can save a lot of confusion.
  501.  
  502. If you are concerned that your order is taking too long to process, feel
  503. free to check with us about the status of your order.   It's important
  504. to all of us that you feel safe doing business with our company and
  505. please feel free to suggest ways we can improve our service to you.
  506.  
  507.  
  508.  
  509.  
  510. Ciao and thanks for your time!
  511. Max.
  512.  
  513.