EUMAIL.TXT                           1                         Aug 26, 1999

The EUMAIL.EXE program does some summarizing for the Eudora Internet e-mail
program.

What is Eudora?  Eudora is an excellent Internet e-mail program.  It's  put
out by QUALCOMM Incorporated in San Diego California.  The  latest  version
of Eudora Light can be found at:

        ftp.qualcomm.com
        quest/windows/eudora/1.5

The Windows freeware user manual can also be found at:

        ftp.qualcomm.com
        quest/windows/eudora/documentation

EUMAIL, on the other hand, is a freeware utility which reads Eudora's files
and provides the following benefits:

  * Allows you to save your Eudora nickname  file  (containing  individuals
    and groups with the corresponding e-mail addresses) as a DOS text  file
    which is useful for searching and such.  (Have you ever tried  to  find
    out where all you have someone's  e-mail  address  referenced  in  your
    nickname file?)
  * Presents a summary of how many messages you have in each of  your  mail
    folders, including their date range and their total size in bytes, plus
    what share of total mailbox bytes this particular folder accounts for.
  * Allows you to dump all (or a subset  of  your  mailboxes)  as  straight
    ASCII- text files.  There will be one text file per  mailbox,  prefaced
    by a table of contents for all messages in that mailbox.
  * Allows you to write out just the table of contents  as  an  ASCII  text
    file.
  * Allows you to write each individual message as an incremented file name
    (TRASH.001, TRASH.002, etc).
  * Allows you to process all mailboxes or all mailboxes whose names  begin
    with a certain string.
  * Allows for multiple nickname files (supported in Eudora Pro).
  * The date format shown is based on your country setting as  detected  by
    DOS.
  * Pressing escape stops the program early.



EUMAIL.TXT                           2                         Aug 26, 1999

Quickie instructions:

Okay!  You hate to read.  I know that.  And there aren't any cute  pictures
in this documentation and, like everything I write, it's way  too  long  to
keep your attention for  long.   So,  let's  bottom  line  it;  what's  the
quickest way to use this program without learning any of the options?

Make sure you've extracted EUMAIL.EXE from the EUMALymm.ZIP file.  Run it.

The first time  it's  run,  EUMAIL  will  try  to  find  your  main  Eudora
subdirectory.  It will scan drive C, then D, etc looking for the EUDORA.EXE
(or the older WEUDORA.EXE) file.  Once it finds it, it will tell you  where
it found the file and ask if you want to save this location in an INI file.
If you say "Y" (yes), it will create a EUMAIL.INI file for  you  and  store
the location there.  The next time you run EUMAIL, it will not need to scan
for the subdirectory.

Then it will do a bunch of status messages and create  two  text  files  in
your Windows' TEMP subdirectory (typically C:\TEMP).  It will tell you  the
two files it creates but they default to EUMAIL.TXT and EUMAIL.BOX.  Use  a
file viewer or the Windows NotePad program to view these files.   They  are
described below.

Type in "EUMAIL /?" and try out some of the other parameters.  If you  find
yourself consistently overriding some of them,  they  can  be  saved  in  a
EUMAIL.INI file.  Read the BRUCEINI.TXT file for information on how  to  do
this.



EUMAIL.TXT                           3                         Aug 26, 1999

EUMAIL.TXT:  The e-mail data base:

EUMAIL creates a listing of your nickname file.  By default, this file will
be called EUMAIL.TXT (override with /NL=filename  parameter)  and  will  be
stored in your Windows'  TEMP  subdirectory  (e.g.   C:\TEMP).   This  file
includes all of your nicknames and comments (the use of comments is heavily
recommended).  This is an ideal file to use the DOS FIND  command  (or  the
Wayne Software BFIND command) to search through.  A sample of the format:

BanBruce      : Bruce Guthrie            <bruce.guthrie@mail.doc.gov>
BanForrest    : Forrest Williams         <fwilliams@doc.gov>
BanJoe        : Joe Correia              jcorreia@doc.gov
BanTravis     : Travis Mayo              <tmayo@doc.gov>
WS_READ       : Billy Rudock             <billy_rudock@notes.seagate.com>
           [2]: Les Ferch                <ferch@cce.ubc.ca>
           [3]: Martin Mossakowski       <mossako@asterix.uni-muenster.de>
           [4]: Tony Vincent             <tonyvinc@iconz.co.nz>
XList         > requests: majordomo@chaos.taylored.com
XList         > msg: SUBSCRIBE X-FILES
XList         > msg: SUBSCRIBE X-FILES-DIGEST
XList         > msg: UNSUBSCRIBE X-FILES
XList         : x-files@chaos.taylored.com

The fields in the file are:
  * The nickname you've defined for this user
  * The actual name (if any) of that user
  * The e-mail address for that user

Comments are indicated with ">" entries and they appear before  the  actual
entry.

Nicknames which define multiple users are sorted by actual name and then by
e-mail address.  Typically, as is shown above, only the first  instance  of
the nickname is shown with all of the individual contacts shown  with  item
counts.  Alternatively, you can use the /REPEAT  option  and  the  nickname
label will repeat for each item.  The latter option is useful when you  are
using the FIND or BFIND command to searchfor all members  of  a  particular
group.



EUMAIL.TXT                           4                         Aug 26, 1999

EUMAIL.BOX:  The summary of your Eudora mailboxes and folders:

EUMAIL creates a summary of all the mailboxes and folders  you've  created.
By default, this file will be called EUMAIL.BOX (override with /NS=filename
parameter) and will be stored in  your  Windows'  TEMP  subdirectory  (e.g.
C:\TEMP).   This  file  shows,  for  each  of  your  boxes,  the  following
information:  the number of messages, their date range, the size of the box
in bytes, and what percent of total bytes consumed each box accounts for. A
fairly complete example of what mine looked like  when  I  ran  it  at  one
point:

C:\TEMP\PHONMAIL.OUT generated 10-18-1996 00:54:08 by EUMAIL.EXE

Box/folder name    msgs % of   earliest -> newest         bytes  % of
                        msgs                                    bytes

In                   34   1%   05-21-96 -> 10-16-96     324,042    2%
Trash               346   9%   11-15-94 -> 10-17-96   1,156,646    7%
Out                 256   6%   10-14-96 -> 10-16-96     463,945    3%
  ... (portion deleted to make it fit on the page) ...
Wayne               187   5%   04-07-96 -> 10-16-96     426,159    3%
X-Files              28   1%   04-07-96 -> 10-16-96     130,698    1%
Humans
  Arlene            343   9%   08-12-96 -> 10-16-96   1,157,929    7%
  Family             46   1%   01-19-96 -> 10-07-96      67,100    0%
  Munchkyn           29   1%   12-15-95 -> 10-15-96      47,420    0%
  Webman             50   1%   02-02-96 -> 10-15-96      99,420    1%
    4 boxes         468  12%   12-15-95 -> 10-16-96   1,371,869    9%
Humor
  __Progress        139   3%   04-28-96 -> 10-15-96     381,048    2%
  _Cartoons          67   2%   04-28-96 -> 10-05-96     437,440    3%
  _Comedians         64   2%   05-01-96 -> 10-08-96     357,953    2%
  ... (portion deleted to make it fit on the page) ...
  _Songs/Lyrics       6   0%   05-11-96 -> 08-13-96      15,852    0%
  _TV/Movies          7   0%   05-20-96 -> 10-05-96      54,606    0%
    8 boxes         830  21%   02-06-96 -> 10-15-96   2,876,881   18%
Keep
  1993                3   0%   10-22-93 -> 10-24-93       7,907    0%
  1994                3   0%   05-18-94 -> 12-11-94      20,506    0%
  1995               27   1%   01-05-95 -> 12-29-95      78,193    1%
  1996               85   2%   01-02-96 -> 02-28-96     226,929    1%
  0_Hold             87   2%   10-28-95 -> 09-16-96     193,348    1%
    5 boxes         205   5%   10-22-93 -> 09-16-96     526,883    3%
Misc
  Misc               19   0%   03-16-96 -> 10-10-96      46,542    0%
  NMAA                6   0%   09-28-95 -> 09-28-96      23,172    0%
  Resends            41   1%   09-01-96 -> 10-01-96      10,378    0%
  Websites           16   0%   02-20-96 -> 07-19-96      33,831    0%
  Work                1   0%   04-08-96 -> 04-08-96      10,867    0%
    5 boxes          83   2%   09-28-95 -> 10-10-96     124,790    1%
Out_Prev
  Wk39              380   9%   09-23-96 -> 09-29-96   1,168,188    7%
  Wk40              384  10%   09-30-96 -> 10-06-96     810,029    5%
  Wk41              244   6%   10-07-96 -> 10-13-96     505,446    3%
    3 boxes       1,008  25%   09-23-96 -> 10-13-96   2,483,663   16%

  37 boxes        4,023 100%   11-15-94 -> 10-17-96  15,588,849  100%


EUMAIL.TXT                           5                         Aug 26, 1999

The program, by  default,  will  automatically  display  information  about
"large" boxes based on a combination of three criteria.  Lines  above  will
be shown on-screen for any box which exceeds any of the three criteria. The
three are:

  * The total number of messages in the box (/n parameter)
  * The total number of (thousand) bytes in the box (/nK parameter)
  * The percentage of total bytes that that box accounts for (/n% parm)

The defaults are /100, /100K, and /5%.

If you'd like to turn off the on-screen display entirely, you  can  specify
the /Q parameter.  If you'd like the criteria to be based  on  one  or  two
criteria only, specify an unusually large value for the other  parameter(s)
(for example, /30000K).

Using an INI file for the criteria (see later) is always an option.



EUMAIL.TXT                           6                         Aug 26, 1999

Header formats:

When you request either /DUMP  or  /HEADERS,  the  program  will  typically
generate headers which describe what messages are in your file.  The  order
of the messages corresponds to the order shown in  Eudora.   Message  sizes
are shown in lines if /DUMP is used, and in thousand bytes  if  /HEADER  is
used.  The exact format of the  headers  depends  on  your  value  for  the
/FORMAT=n parameter.  The various formats are:

/FORMAT=0   (or /-FORMAT):  Skip showing the headers at all.
/FORMAT=1:  Show one line per mail message.  This  format  closely  matches
            that shown in Eudora itself.  This is initially the default for
            EUMAIL.
/FORMAT=2:  Show two or more lines per message.  The subject  gets  a  line
            all to itself.  You may get three lines for  some  messages  if
            the length of the "Sender" field is long.
/FORMAT=3:  Show one line per mail message.  This  format  shows  just  the
            message size and subject line; this is useful when you're using
            Eudora to catalog messages and such and don't really care  when
            they were sent or from whom.

Examples of each format are shown below (remember, the size of the  message
is measured in lines if /DUMP is used, bytes if /HEADER is used):

Contents:                       (using /FORMAT=1)

  1 Bruce Guthrie    04:31 PM 3/26/96   2 Round robin time
  2 Bruce Guthrie    11:44 AM 4/7/96    1 RE: FORB data update
  3 Olumoya - Pamela 07:49 PM 4/7/96   14 Posting Guidelines for X-Files-Fanfic
  4 Heather and Eric 07:29 PM 4/19/96   4 re: Vancouver locations for x-filese

Contents:                       (using /FORMAT=2)

  1 Bruce Guthrie                            04:31 PM 3/26/96      2K
    Round robin time
  2 Bruce Guthrie                            11:44 AM 4/7/96       1K
    RE: FORB data update
  3 Olumoya - Pamela                         07:49 PM 4/7/96      14K
    Posting Guidelines for X-Files-Fanfic
  4 Heather and Eric                         07:29 PM 4/19/96      4K
    re: Vancouver locations for x-filese

Contents:                       (using /FORMAT=3)

  1     2K   Round robin time
  2     1K   RE: FORB data update
  3    14K   Posting Guidelines for X-Files-Fanfic
  4     4K   re: Vancouver locations for x-filese



EUMAIL.TXT                           7                         Aug 26, 1999

ASCII dumps:

The EUMAIL program will dump the contents of all of your e-mail  boxes  for
you if you'd  like.   (Optionally,  you  can  specify  that  it  only  dump
mailboxes whose names begin with a certain character string.) In so  doing,
it creates a table of contents and divides each article with a  page  eject
for you.  The format for this table of contents is discussed above.

The ASCII message dump is requested with the /DUMP parameter.   A  separate
dump file (with an extension of, by default, *.DMP)  will  be  created  for
each mailbox.  Alternatively, you can request that a separate text file  be
created for each message using the /SPLIT parameter, in which case the file
extensions will have incremented names (for example, TRASH.001,  TRASH.002,
etc; after 999 messages, they will start to be named TRASH.A00 etc).

Eudora handles mail folders (vs mail boxes) by creating a subdirectory  for
each folder off of the parent directory.  If a folder contains folders, the
second  level  subdirectories  are  created  off  of  the   primary   level
subdirectories, not the Eudora main subdirectory.  The individual mailboxes
within each folder are created  in  the  appropriate  subdirectories.   For
example, if you have a folder called  "People",  and  it  has  two  folders
called "Family" and "Friends", and each of these have  message  boxes,  the
directory structure on your hard disk will look like this:

        (main Eudora subdirectory)
        ... various files ...
          +----- PEOPLE.FOL (subdirectory)
                 +-------- FAMILY.FOL (subdirectory)
                 |      ... various Family mailboxes...
                 +-------- FRIENDS.FOL (subdirectory)
                        ... various Friends mailboxes...

Unless the /D=dump_sub parameter is provided, all dump files  are  left  in
the same subdirectories the source mail is in.  You can specify that all of
the dump files be created  in  a  single  subdirectory  by  specifying  the
/D=dump_sub parameter.

You may want to PKZIP one or more of the dump files and then move them  out
of your Eudora subdirectories, perhaps storing them on  a  floppy  diskette
for purposes of retaining them.  As long as you  are  reasonably  sure  you
will not want to be doing responses or something in Eudora, you can  delete
the messages from the mailboxes you save this way.

Personally, I save all of my outgoing messages for  some  reason.   I  then
save an ASCII version of what I sent, compress  it,  and  then  delete  the
original messages en masse.

If you'd like, you can get just the table of contents for the messages  and
skip the actual dump of the messages themselves.  This can be  achieved  by
using the /HEADER option.  The output files created will  still  be  called
"dump files" however, and will be created where the normal dump files would
have been created.

If you later decide you want to kill off all of the dump files, pass in the
parameter /KILLDUMP and it will take care of them for you.



EUMAIL.TXT                           8                         Aug 26, 1999

Specifying parameters:

Parameters for this program can be set in the  following  ways.   The  last
setting encountered always wins:
  - Read from an *.INI file (see BRUCEINI.TXT file),
  - Through the use of an environmental variable (SET EUMAIL=whatever), or
  - From the command line (see "Syntax" below)


Syntax:

    EUMAIL [ /E=eudora_sub ] [ /O=output_sub ]
      [ /NL=filename | /-NL ] [ /REPEAT ] [ /NICKFILE=filename ]...
      [ /NS=filename | /-NS ] [ /n ] [ /nK ] [ /n% ] [ /SHOWEXT ] [ /Q ]
      [ /DUMP | /HEADERS | /SPLIT | /KILLDUMP ] [ domain ] [ /FORMAT=n ]
      [ /HEAD=xxxx ] [ /DMP=xxx ] [ /D=dump_sub ] [ /WIDTH=n ]
      [ /T=temp_dir ] [ /MONO ] [ /Iinitfile | /-I ] [ /-ENV ] [ /? ]

where:

"/E=eudora_sub" is the location where you installed Eudora.   There  is  no
default for this parameter.  If no location is provided, the  program  will
scan for the EUDORA.EXE file on all of your available hard disks  until  it
finds it.  It will then allow you to save this information in a  EUMAIL.INI
file so it doesn't need to scan again in subsequent times.  (INI files  are
explained in BRUCEINI.TXT.)

"/O=output_sub" specifies the default subdirectory to which the two listing
files (the  ones  generated  by  /NL=filename  and  /NS=filename)  will  be
written.  This subdirectory must exist already.  It  defaults  to  whatever
you have "SET TEMP=subdir" set in your CONFIG.SYS file.  Again, the use  of
a EUMAIL.INI file is heavily recommended  (see  BRUCEINI.TXT).   Note  that
this parameter does not affect the positioning of the dump files at all.

"/NL=filename" specifies the filename that the nickname listing  is  to  go
to.  If no drive/path information is specified, this file will  be  written
to the /O=output_sub subdirectory.  Saying "/-NL"  or  "/NL="  without  any
filename indicator  will  suppress  the  creation  of  the  nicknames  file
altogether.  Defaults to /NL=EUMAIL.TXT.

"/-NL" suppresses the creation of the nickname file entirely.

"/REPEAT" says to repeat the names of the nicknames when they're listed. It
looks better if you don't repeat them but if you use something like FIND on
the file, you might want to have them  repeating.   Initially  defaults  to
/-REPEAT.

"/-REPEAT" is the opposite of "/REPEAT".  The name  of  the  nickname  only
appears once even if it contains five e-mail addresses.  There  very  first
example in this documentation shows the  output  with  /-REPEAT.   This  is
initially the default.


EUMAIL.TXT                           9                         Aug 26, 1999

"/NICKFILE=filename" specifies the name of the nickname  file  to  process.
This is used in Eudora Pro which supports multiple nickname files.  You can
specify up to five  file  names  here.   It  initially  defaults  to  being
NNDBASE.TXT in your Eudora subdirectory.

"/NS=filename" specifies  the  filename  that  the  mailbox/folder  summary
listing is to go to.  If no drive/path information is specified, this  file
will be written to the /O=output_sub subdirectory.  Saying "/-NS" or "/NS="
without any filename indicator will suppress the  listing  of  the  summary
altogether.  Defaults to /NS=EUMAIL.BOX.

"/-NS" suppresses mailbox handling  entirely,  including  creation  of  the
mailbox summary and dumps and whatever else.

"/n" specifies that any mailbox  with  more  than  "n"  entries  is  to  be
indicated on the screen when the program runs.  The test for this  is  done
independently of the tests for  the  number  or  entries  or  the  absolute
filesize test; any box with more than /n message or with a filesize  bigger
than /nK or a share of more  than  /n%  will  be  displayed  unless  /Q  is
specified.  Defaults to /100.

"/nK" specifies that any mailbox with more than "n" thousand (K)  bytes  is
to be indicated on the screen when the program runs.  The test for this  is
done independently of the tests for the number or entries or  the  absolute
filesize test; any box with more than /n message or with a filesize  bigger
than /nK or a share of more  than  /n%  will  be  displayed  unless  /Q  is
specified.  Defaults to /100K.

"/n%" specifies that any mailbox with more than "n" percentage (%)  of  the
total bytes used by all stored mail is to be shown on the screen  when  the
program runs.  The test for this is done independently of the tests for the
number or entries or the absolute filesize test; any box with more than  /n
message or with a filesize bigger than /nK or a share of more than /n% will
be displayed unless /Q is specified.  Defaults to /5%.

"/SHOWEXT" shows the message dates as they appear in the  Eudora  displays.
At times, this is confusing since the dates are actually  sorted  by  their
internal date format.  In addition, if you've changed external date formats
or you have one setting in Windows and another in DOS, EUMAIL will blow  up
with an invalid function error.  Thus it's safer to use /SHOWINT  which  is
the initial default.  If you do decide to use this option, be sure to  read
the "COUNTRY Notes" section below.

     NOTE ABOUT "INVALID FUNCTION CALL" ERROR MESSAGES:  If are  using  the
     /SHOWEXT setting, you may encounter errors in using this program.  The
     main reason for this is either (a) you've changed  your  default  date
     format since you started receiving  mail  using  Eudora  or  (b)  your
     Windows country setting (which is what Eudora uses) is different  from
     what your DOS setting (which is what EUMAIL uses) is.   If  either  of
     these are the case, you will  probably  get  "invalid  function  call"
     errors.  See the section  on  "Country  Notes"  at  the  end  of  this
     documentation for  information  on  how  to  set  the  value  in  your
     CONFIG.SYS file.  In most cases, simply do not use the /SHOWEXT option
     and you'll be fine.  However, in dire circumstances,  you  can  rename
     the *.TOC file as *.BAK for any mailbox that  gives  you  trouble  and
     Eudora will automatically try to recreate it for you.  This is not, of
     course, recommended since it may cause problems.


EUMAIL.TXT                           10                        Aug 26, 1999

"/SHOWINT" shows the message dates in their real internal date format. This
is initially the default.

"/Q" says that no individual mailboxes are to be indicated  on  the  screen
when the program runs.  This ignores any /n, /nK, or /n% settings.

"/DUMP" says to dump the contents of the mailboxes out as plain ASCII  text
documents.  The program generates one text  file  for  each  mailbox.   The
program will also add a table of contents in front of each  dump  for  you.
The dump files will be the name of the folder with a *.DMP  file  extension
(unless /SPLIT or /DMP=xxx is specified).   Note  that  the  messages  will
appear in the order they show up when you view them on the screen  and  you
may want to re-sort them all first.   See  the  /HEAD=xxxx  parameter  too.
Defaults to /-DUMP (don't create the dump files).

"/HEADERS" (or "/HEADER", "/HEAD", "/HDRS", "/HDR") says to write  out  the
message headers only, not the actual messages.  See the /FORMAT=n parameter
below.  The header files will be the name of the folder with a  *.DMP  file
extension (unless the /DMP=xxx parameter is specified).

"/-HEADERS" (or "/-HDRS" and the logical abbreviations) is the opposite  of
/HEADERS and tells  the  system  to  not  create  header  files.   This  is
initially the default.

"/SPLIT" takes each messages and dumps it as a individual text  file.   The
files will be named as the DOS name of the mailbox with numeric  extensions
beginning with 001 (for example, TRASH.001, TRASH.002, etc).

"/KILLDUMP" deletes any dump files it finds.  This option also deletes  any
of the /SPLIT-produced files (for example, TRASH.001) that it finds.   This
is used if you later decide you don't want any of the dump files around  or
if you've already moved out the ones you need and you no  longer  want  the
rest of them around.  (Note:  /KILLDUMP deletes the dump  and  *.xxx  files
for each Eudora mailbox [*.MBX]  file  it  finds;  if  you've  deleted  the
mailbox from within  Eudora,  /KILLDUMP  will  not  delete  the  associated
EUMAIL-produced files and you'll have to delete them manually if  you  want
them gone.)

"domain" restricts /DUMP and /HEADERS processing to only those files  whose
names begin with a particular character string.  As an example, if you just
want to dump the "Out" mailbox, pass in "OUT" as  in  "EUMAIL  /DUMP  OUT".
Note that this will also dump other mailboxes whose names begin with  "OUT"
which may be useful to you.  If your mailbox name includes a space, you can
specify this by replacing the space with an underscore (for example,  "Joke
List" can be entered as "JOKE_LIST").  By default, all mailboxes are dumped
if any are.

"/FORMAT=n" specifies what the headers are to  look  like  in  a  /DUMP  or
/HEADERS request.  Basically, /FORMAT=1 creates the headers as one line per
message, in a manner similar to the way that  Eudora  itself  displays  the
headers.  /FORMAT=2 expands the header  information  to  being  two  lines.
/FORMAT=3 is similar to /FORMAT=1 but the author and date/time are dropped.
/FORMAT=0  or  /-FORMAT  skips  showing  the  headers  entirely.   See  the
discussion on "Header  formats"  above  for  examples  of  the  each  type.
Initially defaults to /FORMAT=1.


EUMAIL.TXT                           11                        Aug 26, 1999

"/HEAD=xxxx" specifies that instead of seeing all of  the  message  headers
when you dump the messages, it only shows specific lines  from  the  header
section.  You can use any combination of the following characters:
    T = "To:"
    F = "From:"
    S = "Subject:"
    D = "Date:"
So "/HEAD=S" will give you just the Subject  line.   The  sequence  of  the
letters doesn't matter; the header lines requested will be written  in  the
order they are found in the message.  There are  two  other  specifications
that can't be used in combination with the previous ones:
    /HEAD=ALL = don't filter the header information shown at all; this
                gives you everything including the funky routing ones
    /HEAD=FILTER = the same thing as "/HEAD=TFSD"
"/HEAD=ALL" is initially the default.

"/DMP=xxx" specifies the file extension to assign to the /DUMP files. "xxx"
must be from one-to-three characters  in  length.   Initially  defaults  to
/DMP=DMP.

"/D=dump_sub" specifies where the resulting dump files (if any) are  to  be
written.  By default, they are written to  the  same  subdirectories  where
Eudora created the *.MBX mail files.  You can, however, have  them  created
elsewhere if desired.  If two mailboxes in different folders share the same
DOS file name, the dump file(s) from the mailbox found in the later  folder
will overwrite the dump file(s) from the prior folder.

"/WIDTH=n" specifies that the lines  in  the  EUMAIL.BOX  file  should  not
exceed n-characters.  If the  name  of  a  mailbox  exceeds  26  characters
(including indentation), the output would be wider than 80 characters.   If
this is okay with you,  feel  free  to  override  the  specification.   The
setting is used to shrink columns, not expand them, so if  you  have  short
mailbox names and you specify /WIDTH=200, the program will still give you a
compact listing.  Initially defaults to /WIDTH=80.

"/T=temp_dir" specifies where to write the temporary ISAM  files  that  the
routine needs.  ISAM data bases are used to store and sort the file  names.
ISAM files cannot be created reliably on certain types of drives.  Examples
are "/T=C:" and "/T=C:\TEMP".  If not specified, the routine writes to  the
following in sequence:

  - the value of any TEMP, then TMP, environmental variable
  - C:\TEMP
  - C:\

"/MONO" (or "/-COLOR") does not try to override screen  colors.   Initially
defaults to "/COLOR".

"/COLOR" (or "/-MONO") allows screen colors  to  be  overridden.   This  is
initially the default.


EUMAIL.TXT                           12                        Aug 26, 1999

"/Iinitfile" says to  read  an  initialization  file  with  the  file  name
"initfile".  The file specification *must* contain a period.  Initfiles are
described in the BRUCEINI.TXT file.  Initially defaults to "/IEUMAIL.INI".

"/INULL" says to skip loading the initialization file.

"/ENV" says to look for %var% occurrences in the command line  and  try  to
resolve any apparent environmental variable references.   See  BRUCEINI.TXT
for more information.  This is initially the default.

"/-ENV" says to skip resolving apparent %var% occurrences  in  the  command
line.  Initially defaults to "/ENV".

"/?" or "/HELP" or "HELP" shows you the syntax for the command.


Return codes:

EUMAIL returns the following ERRORLEVEL codes:

        0 = no problems
      250 = operation aborted by pressing Escape
      252 = internal restriction breached
      253 = no files found
      254 = could not find a decent temporary output subdirectory
      255 = syntax problems, or /? requested



EUMAIL.TXT                           13                        Aug 26, 1999

COUNTRY Notes:

   If your DOS COUNTRY setting (which, if not present, defaults to  the  US
   date format of mm-dd-yyyy) is different from the  setting  you  have  in
   Windows (which is how the dates are showing up in Eudora), you  may  get
   "illegal function call" errors.

   The following section tells  you  how  to  modify  the  settings.   It's
   modified slightly but is copied from the DOS 6.2 HELP command.

   The basic format for the COUNTRY command is:

           COUNTRY=xxx[,[yyy][,[drive:][path]filename]]

   where:

           xxx = the country code (see below)
           yyy = the character  set  for  the  country  (used  for  setting
   keyboard
                 types; we'll ignore this one)
           [drive:][path]filename = where the COUNTRY.SYS file is

   For example:

            COUNTRY=033,,c:\dos\country.sys

   Says to use France's country code for  date,  skips  the  character  set
   entirely, and says COUNTRY.SYS is c:\dos\country.sys


Changing default country settings:

   MS-DOS uses the United States as the default setting.  You can  use  the
   COUNTRY command in your CONFIG.SYS file to change the setting.

   If you do not specify the location  and  name  of  the  file  containing
   country-specific information, MS-DOS tries to find the COUNTRY.SYS  file
   in the root directory of your startup drive.



EUMAIL.TXT                           14                        Aug 26, 1999

Specifying supported languages:

   The following table lists each country or language supported by  MS-DOS.
   The table also lists the character sets you can use  with  each  country
   code. For example, if you  use  country  code  003,  you  can  use  only
   character set 437 or 850 for the yyy parameter.  The first  of  the  two
   character sets listed for  each  country  or  language  is  its  default
   character set.

           Country or language    Country       Character sets
                                                code


           Belgium                032           850, 437
           Brazil                 055           850, 437
           Canadian-French        002           863, 850
           Croatia                038           852, 850
           Czech Republic         042           852, 850
           Denmark                045           850, 865
           Finland                358           850, 437
           France                 033           850, 437
           Germany                049           850, 437
           Hungary                036           852, 850
           International English  061           437, 850
           Italy                  039           850, 437
           Latin America          003           850, 437
           Netherlands            031           850, 437
           Norway                 047           850, 865
           Poland                 048           852, 850
           Portugal               351           850, 860
           Serbia/Yugoslavia      038           852, 850
           Slovakia               042           852, 850
           Slovenia               038           852, 850
           Spain                  034           850, 437
           Sweden                 046           437, 850
           Switzerland            041           850, 437
           United Kingdom         044           437, 850
           United States          001           437, 850

   Character sets  for  the  following  countries  or  languages  are  also
   available with special  versions  of  MS-DOS:   Arabic,  Israel,  Japan,
   Korea, People's Republic of China, and Taiwan.



EUMAIL.TXT                           15                        Aug 26, 1999

Specifying international time and date formats:

   The country code specifies  the  time  and  date  formats  used  by  the
   following MS-DOS commands:  BACKUP, DATE, RESTORE, and TIME.

   The following table lists the date and  time  formats  related  to  each
   country code.  For each country code, the "Date format" column shows how
   MS-DOS displays January 3, 1993, and the "Time format" column shows  how
   MS-DOS displays 5:35 P.M.   (with  0  seconds  and  0  hundredths  of  a
   second).

           Country or language    Country       Date code    Time format

           Belgium                032           23/01/1993   17:35:00
           Brazil                 055           23/01/1993   17:35:00
           Canadian-French        002           1993-01-23   17:35:00
           Czechoslovakia         042           1993-01-23   17:35:00
           Denmark                045           23-01-1993   17.35.00
           Finland                358           23.01.1993   17.35.00
           France                 033           23.01.1993   17:35:00
           Germany                049           23.01.1993   17:35:00
           Hungary                036           1993-01-23   17:35:00
           International English  061           23-01-1993   5:35:00.00p
           Italy                  039           23/01/1993   17.35.00
           Latin America          003           23/01/1993   5:35:00.00p
           Netherlands            031           23-01-1993   17:35:00
           Norway                 047           23.01.1993   17:35:00
           Poland                 048           1993-01-23   17:35:00
           Portugal               351           23-01-1993   17:35:00
           Spain                  034           23/01/1993   17:35:00
           Sweden                 046           1993-01-23   17.35.00
           Switzerland            041           23.01.1993   17,35,00
           United Kingdom         044           23/01/1993   17:35:00.00
           United States          001           01-23-1993   5:35:00.00p
           Yugoslavia             038           1993-01-23   17:35:00

   Character sets  for  the  following  countries  or  languages  are  also
   available with special  versions  of  MS-DOS:   Arabic,  Israel,  Japan,
   Korea, People's Republic of China, and Taiwan.



EUMAIL.TXT                           16                        Aug 26, 1999

Author:

This program was written by Bruce Guthrie of Wayne Software.   It  is  free
for use and redistribution provided relevant documentation is kept with the
program, no changes are made to the program or documentation, and it is not
bundled with commercial programs or charged  for  separately.   People  who
need to bundle it in for-sale packages must pay a $50 registration  fee  to
"Bruce Guthrie" at the following address.

Additional information about this and other Wayne Software programs can  be
found in the file BRUCE.TXT which should be included in  the  original  ZIP
file.  The recent change  history  for  this  and  the  other  programs  is
provided in the HISTORY.ymm file which should be in the same ZIP file where
"y" is replaced by the last digit of the year and "mm"  is  the  two  digit
month of the release; HISTORY.611 came out in  November  1996.   This  same
naming convention is used in naming the ZIP file (EUMALymm.ZIP)  that  this
program was included in.

Comments and suggestions can also be sent to:

                Bruce Guthrie
                Wayne Software
                113 Sheffield St.
                Silver Spring, MD 20910

                e-mail: WayneSof@erols.com   fax: (301) 588-8986
                http://www.geocities.com/SiliconValley/Lakes/2414
             or find through http://www.erols.com/waynesof

Please provide an Internet e-mail address on all correspondence.


