<p>First off, please check to have the following items in your MaxBase folder
on the WPS:</p>
<ul>
<li> "Open local DB" (Main MaxBase icon).
<li> "Share DB on the network" (To let other users access your DBs).
<li> "Access a remote DB" (To access other MaxBase DBs on the network).
<li> "db_store" (Where you should store your DBs).
<li> "Docs" (The files you should read - start with readme.1st).
<li> "New DB" (A template to create new DBs - drag and drop it on the db_store folder).
<li> "Get the latest 1.02 Java Runtime!" (An URL object to retrieve up-to-date versions of the Java runtime).
</ul>
<p>
If you don't have one or more elements, it means that the installer couldn't do its job properly. Please contact MaxBase author (see BUGS! section) specifying your setup and other relevant info (use of WPS utilities, etc).
</p>
</panel>
.***** MaxBase Requirements Panel *****
<panel name=Requirements next=MaxBase
previous=main
enable-done hide-undo hide-help
image-lib=os2imgs.dll image-id=1001>
<title>Requirements
<p><b>Things to have and to do to use MaxBase.</b>
</p>
<ul>
<li>You should have a recent OS/2 Java rel 1.0.2 (type "java -version" on an OS/2 shell to see what is the one you got). <b>MaxBase won't run on Java 1.0.1!</b>
<li>You should have installed MaxBase in an HPFS drive, because you need long file names.
<li><b>You should reboot your computer after installation before using MaxBase for the first time.</b>
<li>You should have Rexx support installed in order for the installation program to do its job.
</ul>
<p><b>
Warning: to launch the following program you need to have the EPM Enhanced Editor installed (comes with every Warp package).
<p>MaxBase ("Open Local DB", or "java MaxBase" from the command line) is the program used to:
<ul>
<li>Create your databases (from the Tools..DB Related..Create DB menu).
<li>Delete and pack them (packing means reindexing them).
<li>Export your DBs in DBIII format, and import DBIII databases.
<li>Add/delete fields, change field names, indexing and length (from the Tools..Field Related menu).
<li>Work with your data.
</ul>
<al=left>
<p>Let's expand this latest point.</p>
<p>To work with your data, you can go to the record panel and add/modify/delete records, order the db on a field, set a filter and so on. <b>Note that when you add one or more records, you must hit the 'refresh' button to see them</b>. When you exit from MaxBase, the current settings (window size/position, properties, filter, used index) will be saved <b>on the directory you have started MaxBase from.</b></p>
<p>If you have installed plugin support, in the main panel you will also see the buttons to launch the plugins (See the plugins page for details).</p>
</al>
<p>Available shortcuts from within MaxBase:
<ul>
<li>Advance to the next entry field: <b>PAGE DOWN</b>.
<li>Return to the previous entry field: <b>PAGE UP</b>.
<li>Advance to the next page (when there are more than 5 fields): <b>CTRL+PAGE DOWN</b>.
<li>Return to the previous page (when there are more than 5 fields): <b>CTRL+PAGE UP</b>.
<li>Confirm add/modify of a record, use the new filter: <b>CTRL+END</b>.
<li>Same as before, but with the a 'cancel' meaning: <b>CTRL+HOME</b>.
<li>Modify a record: <b>select it and double-click on it</b>.
<li>The <b>CTRL+A</b> keys bring you directly into the 'add record' layout. Note that when you start inserting records, the default action after insertion is to insert another record. You need to hit "cancel" to return to the default browse view; this was done to help the people who have to insert a lot of records at once.
<li>The <b>CTRL+B</b> keys when used during record adding / modifying or filtering, delete the field value under cursor.
<li>The <b>ALT+C</b> keys when used during record adding or modifying, copy the record which was last stored into disk into the current fields (only the fields in the page you're in when you press ALT+C).
<li>The <b>CTRL+C</b> keys when used during record adding or modifying, copy the record which was last stored into disk into the current fields (all the fields of the page you're in but the one you're on with the cursor).
<li>The <b>CTRL+D</b> keys bring you directly into the 'delete records' layout.
<li>The <b>CTRL+F</b> keys bring you directly into the 'filter' layout.
<li>The <b>CTRL+O</b> keys bring you directly into the 'order' layout.
<li>The <b>CTRL+V</b> keys when used during record adding or modifying, copy the record which was last stored into disk into the current fields (only the field you're on with the cursor).
</ul>
<p>Why such funky key combinations? Because There is no standard TAB in Java for example. Yes I know you're using OS/2 and your TAB key is just fine, but this program can be used also on NT, Unix etc.</p>
<p><b>Warning: you should reboot your computer after installation before using MaxBase for the first time.</b>
If you did that, and you want to play with MaxBase now, hit the "start MaxBase now" button.</b></p>
<al left>
<li action="start java MaxBase">~Start MaxBase now
<p>MaxBase can be expanded by means of PLUGINS, small NetRexx (or Java) programs that let you do things on selected records. But how do they work?</p>
<p>When MaxBase starts up, it looks (among the other things) <b>in the directory it was launched from</b>, for the file <b>plugin.ini</b>. If it is present, you should have one or more <b>couple</b> of lines in it, the first being the name of the plugin, the second being the program to launch when the button is pressed. After the plugin has initialized itself, it receives from MaxBase information about records selected, and therefore it can do whatever it wants on them (locally, NOT on the real DB data), like printing them, using the information to draw a graph, etc.</p>
<p>The included plugins are <b>txtimg</b> (a plugin which will show images and associated text, see the imgs.dat database for an example) and <b>printrec</b> (a plugin which will print record data).</p>
<ul>
<li>If you are interested in creating plugins, please refer to README.PLUGINS in the Docs folder.</p>
<li>If you have InfoZip's unzip push the "unzip plugins" button to activate them. The next time you will open MaxBase from the main MaxBase directory two new buttons will show up in the main panel.
<li action="start java MaxBase imgs.dat">~Start MaxBase with plugins
</al>
</panel>
.***** Interacting with the WPS Panel *****
<panel name=WPSInteract next=bugs
previous=plugins
enable-done hide-undo hide-help
image-lib=os2imgs.dll image-id=1004>
<title>WPS and MaxBase
<p><b>How to get the most from your MaxBase under OS/2.</b></p>
<p>MaxBase integrates nicely with OS/2 WorkPlace Shell, even though it doesn't interact with SOM/DSOM. The installation program created some objects in your WPS, and they have been created this way in order to let you use MaxBase in a document-centric fashion.</p>
<p>Drag a <b>"new db"</b> from its template to the <b>db_store</b> shadow folder (the original is located in the main MaxBase directory) to create a new database, customize its name, and then double click on it. Now go to <b>tools..Field Related..Change field</b> name and change the field name. Add other fields, then start adding records. Yes, it is that easy!</p>
<p>When you right click on a .DAT file (the default association for MaxBase DBs) and left-click on 'open as..' you will see at least two options:</p>
<ul>
<li>Open local DB. If you select this (it should be the default action, BTW) the database will be opened locally and you can start working on it directly.
<li>Share DB on the network. When you select this, you will be prompted for a <b>port</b> (use different ports for different DBs! I use port 6789 for tests) and then RXDBServer will start serving remote requests and logging info into log.txt in the db directory.
</ul>
<p><b>I strongly recommend you to use this document-centric way of operating, because it is very powerful. Since MaxBase looks in the directory from where it is launched (and when you double-click on a DB MaxBase is launched from that DB directory) you can (and should, to get the maximum out of MaxBase) have customized .INIs, menus and plugins for every DB.</b> Also, when you exit from MaxBase, the program will automatically save in the current directory the settings in use (window position, active query, how many records to display at once, what index was used last time), so this will add more power to the document-centric way of using MaxBase: it will be like having "customized views" for every DB.</p>
<p><b>NOTES:</b></p>
<ul>
<li> Yes, you can customize MaxBase menus: just copy the maxbase.mnu file which is in the main MaxBase directory into a DB directory, and edit the strings found there. As an example, I have created a maxbase.ita (also in the main MaxBase directory) which makes MaxBase use all italian names and strings. <b>If you customize MaxBase for your language, please let me have that translation, I will add it to the MaxBase distribution package!</b> Note to the note: If you use a dash (-) as a button label, <b>that button will be disabled.</b> (And if the button gives access to a panel, that whole panel will be inaccessible too - useful to protect the DB from "malicious" users)
<li>Your computer can act as a server both on a LAN or on a WAN like the internet. The only requirement is that the network should use the TCP/IP protocol.
<li>You can share as many DBs as you want, only set them at different ports (eg ports 7000, 7001, etc).
<li>Several users, including yourself, can be logged at once into a DB which is shared on the network.
<li><b>There is, on many implementations of the 1.0.2 Java, a bug which makes decimal IP (eg. 10.0.0.1) address resolution fail; please use only alpha-numeric IPs (eg. www.funky.com), or hardwire into your HOSTS file (from the TCP/IP configuration object) the information about who-is-who</b>.
</ul>
</panel>
.***** bugs Panel *****
<panel name=bugs
previous=WPSInteract next=credits
enable-done hide-undo hide-help
image-lib=os2imgs.dll image-id=1005>
<title>Bugs!
<p><b>Things to know when using MaxBase.</b>
</p>
<ul>
<li><b>There is, on many implementations of the 1.0.2 Java, a bug which makes decimal IP (eg. 10.0.0.1) address resolution fail; please use only alpha-numeric IPs (eg. www.funky.com), or hardwire into your HOSTS file (from the TCP/IP configuration object) the info about who-is-who</b>.
<li>The networking extensions have been tested, but not THAT much.
<li>Please report any errors to me, maxmars@pianeta.it.
</ul>
<al center>
<li action="start explore.exe mailto:maxmars@pianeta.it">Mail the author (via ~Web Explorer)
<li action="start netscape.exe mailto:maxmars@pianeta.it?SUBJECT=Bug!">Mail the author (via ~Netscape/2)
</al>
</panel>
.***** Credits Panel *****
<panel name=credits
previous=bugs disable-next
enable-done hide-undo hide-help
image-lib=os2imgs.dll image-id=1006>
<title>Credits
<p><b>I would really like to thank the following people: [listed in alphabetical order]</b>
</p>
<ul>
<li>Giuseppe Aprile, for his .dbf to .dat (and viceversa) functions.
<li>Penny Eads, for being a very precious source of comments and critics.
<li>Andrew Lucas (saCUL) for his many tests while on IRC and a lot of relaxing chatting :-).
<li>Andrea Resmini, for his great MaxBase artworks!
<li>All the people who have contributed to the birth and the developing of MaxBase!
<li>Every application is done <b>for</b> the users. Many thanks to everyone who uses it!
