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