#

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
  This parameter lets you specify which account to open when you start the program. If you do not specify this parameter, the program will start with whatever account was open the last time you closed the program. So if you want to start the program with a specific account, you just specify its name here, as in

  -a "My Account"

-d
  This parameter lets you specify the location of your Mailer directory. If you do not specify this parameter, the program will only use the Mailer subdirectory of the current directory in the session in which the program is running. If there is no Mailer subdirectory in the session's current directory, the program will create one and will store all account information below it. So if you want to start the program from somewhere other than the parent of your Mailer directory for any reason, you must use this parameter to tell the program where to find/create the Mailer directory. For example,

  -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

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:

MailData
  This directory contains one subdirectory for each non-"remote" account.
atchmnts
  This directory is where your attachment files are stored, during the time you are viewing, in the browser window, 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, 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.

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

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:

*.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