Program Files

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:

-a
This parameter specifies the account to open when you start the program. If you do not specify this parameter, the program will start with the account that was open the last time you closed the program.
Example:
-a "My Account"
-d
This parameter specifies the location of your Mailer directory. If you do not specify this parameter, the program will use the Mailer subdirectory of the current directory of the session in which the program is running. If there is no Mailer subdirectory in the current session's directory, the program will create one and will store all account information below it. If you want to start the program from somewhere other than the parent of your Mailer directory, use this parameter to tell the program where to find/create the Mailer directory.
Example:
-d d:\polarbar\Mailer
The spell checker file (SNDSPELL.JDX) must be in the current directory of the session in which the program is running. Please visit the Polarbar FAQ to find out why this file isn't included with Polarbar and to find out how to obtain a copy of the file.

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

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:

MailData
This directory contains one subdirectory for each non-"remote" account.
ATCHMNTS
This directory is where your attachment files are stored while you are viewing the message in which they arrived.
COLLECT
This directory is where your incoming mail is stored, between the time it's retrieved from the server and the time the Filters are working on it and before it is brought into the INBOX folder.
DRAFTS
This directory contains one subdirectory for each account and each of those subdirectories contains that account's drafts.
PREIMAP4
This directory contains one subdirectory for each account that has one or more IMAP4 servers configured for it. These subdirectories hold the temporary files used by the Preview Mail feature when working with an IMAP4 server.
POPPER
This directory contains one subdirectory for each account you have which has been configured to use the Popper message retrieval center.
Templates
This directory contains the template files for all accounts.
Unless you specified a different directory location for an account when you created it, each account's files are stored in a subdirectory of the MailData directory. This subdirectory's name is the same as the account's name.

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 FAT File System

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:

*.AddressBook.html
*.ABH, which you must rename to *.HTM if you want to use another browser program to view it
*.Draft
*.DRA
*.Template
*.TPL
Account.Index
ACCOUNT.IDX
Account.Settings
ACCOUNT.SET
compbar.profile
COMPBAR.PRO
compbarp.profile
COMPBARP.PRO
Custom.Keystrokes
CUSTOM.KYS
jstreethelp.ini
JSTRHELP.INI
Last15.List
LAST15.LST
Print Queue
PRINTQ
Remote.Folder.Index
REMOTEF.IDX
TechSupport.Template
TECHSUPP.TPL
templates
TEMPLATE
toolbar.profile
TOOLBAR.PRO
Transaction.Log
TRANS.LOG
virtbar.profile
VIRTBAR.PRO