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