The only file that's actually required in order to run the program is polarbar.jar. To start the Polarbar Mailer, the polarbar.jar file must be on the "class path" in the session in which you're going to run it. Then you just pass the string "innoval.mailer.jstreet" as a parameter to your Java Virtual Machine's Java Interpreter, which may be JAVA.EXE, JRE.EXE, etc.
You can also add other parameters to that command to tell the Polarbar Mailer to do certain things. If you want to use more than one parameter at the same time, the order in which you specify them makes no difference. If you have to specify a name that's more than one word long, put quotation marks around it. Here are the accepted parameters and their purposes:
The online help files are located in the doc directory inside the Polarbar.jar file and do not need to be extracted. If you are installing Polarbar over J Street Mailer, you may have to delete or rename the J Street Mailer doc directory in order to see the updated Polarbar help files.
The various icon and image files that Polarbar needs are located in the image directory in the Polarbar.jar file and do not need to be extracted. If you want to change some or all of the icons and/or images used by Polarbar, please visit the Polarbar FAQ.
The Mailer directory contains the jstreet.ini file, the Account.Index file, Custom.Keystrokes if you have created a global one, your public address books, and LDAP.INI if you've used the LDAP function.
This directory also contains several subdirectories:
Each account directory contains files named Account.Settings (which holds the account's settings from the Settings dialog, the Message menu, etc.), Last15.List (the compose window's record of the last 15 addresses to which you've written), Transaction.Log (the Message Transaction Log file), filters.dat (the account's Filter information), Remote.Folder.Index (the index of the account's "remote" folders), Custom.Keystrokes (if you've created an account-specific one); toolbar.profile, compbar.profile, compbarp.profile, and/or virtbar.profile (if you've customized your toolbars), any private address book files you've created, and a subdirectory for each of the account's non-"remote" folders.
Each folder subdirectory contains *.POP files (the messages) and PopFiles.Inx, the folder's index file. Each time you open a folder, its *.POP file contents are reconciled against its index file. Index file entries are created (by reading the contents of the file) for each *.POP file in the directory that doesn't already have an index file entry. Index file entries for *.POP files that no longer exist in the directory are deleted from the index file. If you ever lose an index file (the whole thing, or just one entry), it will be recreated the next time you open the folder from within the program. However, extra information that isn't part of the *.POP file (such as sticky notes, color codes, and the flag which tells whether or not you've opened the message yet) cannot be recreated since the lost index file entry is the only place where that information is stored.
The first time you run the Polarbar Mailer, it asks you whether you want to run the program on a hard drive partition using a file system that supports long filenames or on one which supports 8.3 filenames (a maximum of 8 characters in the name and a maximum of 3 characters in the extension without any spaces and various other special characters allowed). If you made the latter choice (whether because FAT is the only type of partition you have or because you want to share one Polarbar Mailer installation between two operating systems which have no other file system in common), your jstreet.ini file contains a line which says "Registration<~>LongFileNames=false" and the Polarbar Mailer runs in short filename mode. Instead of using the file and directory names this documentation has specified throughout, it is using these short names: