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 files (Sndspell.jdx, dict.txt, and mostfreq.txt) must be in the current directory of the session in which the program is running.

The online help files must be in the doc subdirectory of the current directory of the session in which the program is running.

Each time the program starts, it looks for the image subdirectory of the current directory of the session in which the program is running. If the directory is not found or does not contain the required files, it creates that directory, if necessary, and extracts all the *.GIF files from within the polarbar.jar file. If the files are already present, the program will not bother to re-extract them. You can replace the program's *.GIF files with *.GIF files of your own if you create them in the right size and resolution and such to match the existing ones by the same names.

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.
templates
This directory contains the template files for all accounts.
PREIMAP4
This directory contains one subdirectory for each account you have which uses an IMAP4 rather than POP3 server. These subdirectories hold the temporary files used by the Preview IMAP4 Mail function.
POPPER
This directory contains one subdirectory for each account you have which has been configured to use the Popper message retrieval center.
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 General Settings notebook, the Advanced Settings notebook, 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), UIDL.IDS (the account's UIDL 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