Program Files
The only file that's actually required in order to run the program is innoval.jar. To start the J Street Mailer, the innoval.jar file must be on the "class path" in the session in which you're going to run it, and 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 J Street 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 "My Account"
-d d:\jstreet\Mailer
In order for the program to find the spell checker files (Sndspell.jdx, dict.txt, and mostfreq.txt), they must be in the current directory of the session in which the program is running.
In order for the program to find the online help files, they must be in the doc subdirectory of the current directory of the session in which the program is running.
Each time you start the program, it looks for the image subdirectory of the current directory of the session in which the program is running. If it doesn't find such a directory, or if that directory does not contain the required files, it creates that directory if necessary, and extracts all the *.GIF files from within the innoval.jar file into that directory. But if the files are already present, the program will not bother to re-extract them. This means that 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 contains the jstreet.ini file, which holds some settings that are global, not specific to a certain account; 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. If you create a file named DEBUG.OUT in this directory, then during startup, the program will put informational messages into that file, so that our technical support team can figure out exactly where the problem is, if you're having trouble getting the program to run. This directory also contains several subdirectories:
Except in cases where you specified the directory location for an account at the time you created the account, 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.
Regardless of whether an account directory is a subdirectory of MailData or was created elsewhere, it 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, which are the messages; and PopFiles.Inx, which is 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 which doesn't already have an index file entry; and index file entries for *.POP files which don't exist in the directory are deleted from the index file. If you ever lose an index file (the whole thing, or just one entry) for any reason, 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 in which that information had been stored.
The first time you run the J Street Mailer, it asks you whether you want to run the program on a hard drive partition that uses a file system which 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) such as the original FAT file system used by Windows 3.1 and optionally by OS/2. If you made the latter choice (whether because FAT is the only type of partition you have, or because you want to share one J Street Mailer instalation between two operating systems which have no other file system in common), then your jstreet.ini file contains a line which says "Registration<~>LongFileNames=false", and the J Street Mailer runs in short filename mode. Which means that instead of using the file and directory names this documentation has specified throughout, it is using these short names: