home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac / eumal605.zip / EUMAIL.DOC < prev    next >
Text File  |  1996-05-14  |  17KB  |  345 lines
  1. EUMAIL.DOC                           1                         Revised: 05/13/96
  2.  
  3. The EUMAIL.EXE program does some summarizing  for  the  Eudora  Internet  e-mail
  4. program.
  5.  
  6. What is Eudora?  Eudora is an excellent Internet e-mail program.  It's  put  out
  7. by QUALCOMM Incorporated in San Diego California.  The latest version of  Eudora
  8. Light    can    be    found    on    ftp.qualcomm.com,    in    the    directory
  9. quest/windows/eudora/1.5.  The Windows freeware user manual can also be found on
  10. ftp.qualcomm.com, in the directory quest/windows/eudora/documentation.
  11.  
  12. EUMAIL, on the other hand, is a freeware utility which reads Eudora's files  and
  13. provides the following benefits:
  14.  
  15.   * Allows you to save your Eudora nickname file (containing individuals and
  16.     groups with the corresponding e-mail addresses) as a DOS text file which
  17.     is useful for searching and such.
  18.   * Presents a summary of how many messages you have in each of your mail
  19.     folders, including their date range and their total size in bytes, plus
  20.     what share of total mailbox bytes this particular folder accounts for.
  21.   * Allows you to dump all (or a subset of your mailboxes) as straight ASCII-
  22.     text files.  There will be one text file per mailbox, prefaced by a table
  23.     of contents for all messages in that mailbox.
  24.   * Allows you to write the table of contents only as an ASCII text file.
  25.   * Allows you to write each individual message as an incremented file name
  26.     (TRASH.001, TRASH.002, etc).
  27.   * Allows you to process all mailboxes or all mailboxes whose names begin
  28.     with a certain string.
  29.  
  30.  
  31. The e-mail data base:
  32.  
  33. EUMAIL creates a dump of your e-mail data  base.   This  includes  all  of  your
  34. nicknames and comments (the use of comments is heavily recommended).  This is an
  35. ideal file to use the DOS FIND command (or the Wayne Software BFIND command)  to
  36. search through.  A sample of the format:
  37.  
  38. BanBruce      : Bruce Guthrie            <bguthrie@doc.gov>
  39. BanForrest    : Forrest Williams         <fwilliams@doc.gov>
  40. BanJoe        : Joe Correia              jcorreia@doc.gov
  41. BanTravis     : Travis Mayo              <tmayo@doc.gov>
  42. WS_READ       : Billy Rudock             <billy_rudock@notes.seagate.com>
  43.            [2]: Les Ferch                <ferch@cce.ubc.ca>
  44.            [3]: Martin Mossakowski       <mossako@asterix.uni-muenster.de>
  45.            [4]: Tony Vincent             <tonyvinc@iconz.co.nz>
  46. XList         > requests: majordomo@chaos.taylored.com
  47. XList         > msg: SUBSCRIBE X-FILES
  48. XList         > msg: SUBSCRIBE X-FILES-DIGEST
  49. XList         > msg: UNSUBSCRIBE X-FILES
  50. XList         : x-files@chaos.taylored.com
  51.  
  52. The fields in the file are:
  53.   * The nickname you've defined for this user
  54.   * The actual name (if any) of that user
  55.   * The e-mail address for that user
  56.  
  57.  
  58. EUMAIL.DOC                           2                         Revised: 05/13/96
  59.  
  60. Comments are indicated with ">" entries and they appear before the actual entry.
  61.  
  62. Nicknames which define multiple users are sorted by  actual  name  and  then  by
  63. e-mail address.  Typically, as is shown above, only the first  instance  of  the
  64. nickname is shown with all of the individual contacts shown  with  item  counts.
  65. Alternatively, you can use the /REPEAT option and the nickname label will repeat
  66. for each item.  The latter option is useful when you are using the FIND or BFIND
  67. command to searchfor all members of a particular group.
  68.  
  69.  
  70. The summary of your Eudora mailboxes and folders:
  71.  
  72. EUMAIL creates a summary of all the mailboxes and folders you've created.  These
  73. show the number of messages, the date range, and file size, and what percent  of
  74. total bytes consumed each box accounts for.  A complete dump of what mine looked
  75. like when I ran it:
  76.  
  77. Box/folder name  msgs  earliest -> newest         bytes  % of
  78.                                                         bytes
  79.  
  80. In                 19  02/02/96 -> 03/03/96      75,336    1%
  81. Trash             291  02/15/96 -> 03/03/96     677,407   13%
  82. Out               431  02/24/96 -> 03/03/96     461,383    9%
  83. BMG                17  01/30/96 -> 02/21/96      39,311    1%
  84. Humor              44  01/11/96 -> 03/02/96     154,464    3%
  85. Kevin              25  05/31/95 -> 02/27/96      45,156    1%
  86. Misc               30  02/04/96 -> 03/01/96      63,273    1%
  87. SAAB               44  01/31/96 -> 03/01/96     123,530    2%
  88. SAAB Digests       50  02/22/96 -> 03/02/96   1,925,477   36%
  89. SF-Lovers           3  01/22/96 -> 02/29/96      43,542    1%
  90. SF-News            46  01/17/96 -> 03/01/96     538,093   10%
  91. Simtel              1  12/11/95 -> 12/11/95      15,339    0%
  92. Soniat              7  10/06/95 -> 01/24/96      10,498    0%
  93. System              4  09/28/95 -> 02/21/96      10,080    0%
  94. Wayne              28  01/21/96 -> 02/29/96      70,486    1%
  95. Work                4  02/20/96 -> 02/22/96       5,526    0%
  96. WWW site           25  01/25/96 -> 02/28/96      55,695    1%
  97. X-Files            73  02/03/96 -> 03/02/96     248,217    5%
  98. Keep
  99.   Keep-Other       16  12/11/94 -> 01/04/96      46,881    1%
  100.   Keep-Ithaca      12  12/10/95 -> 02/07/96      20,651    0%
  101.   Keep-Pamela      24  12/21/95 -> 02/21/96      74,663    1%
  102.   Keep-SAAB        10  01/21/96 -> 02/16/96      17,836    0%
  103.   Keep-Wayne       20  10/22/93 -> 02/15/96      64,244    1%
  104.   Keep-X-Folk      21  12/01/95 -> 02/21/96      78,818    1%
  105. Listers
  106.   Chigs            11  02/11/96 -> 02/25/96      23,518    0%
  107.   Debbie           13  02/03/96 -> 02/29/96      26,948    1%
  108.   Ithaca           83  02/08/96 -> 03/01/96     143,692    3%
  109.   Munchkyn         28  12/15/95 -> 02/29/96      68,709    1%
  110.   Pamela           45  02/18/96 -> 03/02/96      70,790    1%
  111.   Simon            32  02/26/96 -> 03/03/96      47,685    1%
  112.   SpaceGirl        54  02/10/96 -> 03/02/96      92,230    2%
  113.   Wendy            12  02/08/96 -> 02/25/96      17,587    0%
  114.  
  115.   32 boxes      1,523           ->            5,357,065  100%
  116.  
  117.  
  118. EUMAIL.DOC                           3                         Revised: 05/13/96
  119.  
  120. The program, by default, will automatically display  information  about  "large"
  121. boxes based on a combination of three  criteria.   Lines  above  will  be  shown
  122. on-screen for any box which exceeds any of the three criteria.  The three are:
  123.  
  124.   * The total number of messages in the box (/n parameter)
  125.   * The total number of (thousand) bytes in the box (/nK parameter)
  126.   * The percentage of total bytes that that box accounts for (/n% parameter)
  127.  
  128. The defaults are /100, /100K, and /5%.
  129.  
  130. If you'd like to turn off the on-screen display entirely, you can specify the /Q
  131. parameter.  If you'd like the criteria to be based on one or two criteria  only,
  132. specify an unusually large value for the other parameter(s) (e.g. /30000K).
  133.  
  134. Using an INI file for the criteria (see later) is always an option.
  135.  
  136.  
  137. ASCII dumps:
  138.  
  139. The EUMAIL program will dump the contents of all of your e-mail boxes for you if
  140. you'd like.  (Optionally, you can specify that  it  only  dump  mailboxes  whose
  141. names begin with a certain character string.) In so doing, it creates a table of
  142. contents and divided each article with a page  eject  for  you.   The  table  of
  143. contents looks something like this:
  144.  
  145. Dump of file E:\NMAA\MAIL\In.mbx Processed on 03-31-1996 at 11:55:00
  146.  
  147. Contents:
  148.  
  149.    1 hans.schrader@geol.uib.no                07:05 AM 2/2/96 MET       47 lines
  150.      Dirtotal changed
  151.    2 T. R. Halvorson                          09:14 AM 2/23/96 EST      53 lines
  152.      Re: HTMSTRIP
  153.    3 T. R. Halvorson                          09:15 AM 2/24/96 EST      22 lines
  154.      Re: HTMSTRIP
  155.  
  156. The ASCII message dump is requested with the /DUMP parameter.  A  separate  dump
  157. file  (with  an  extension  of  *.DMP)  will  be  created  for   each   mailbox.
  158. Alternatively, you can request that a separate text file  be  created  for  each
  159. message, in which case the file extensions will  have  incremented  names  (e.g.
  160. TRASH.001, TRASH.002, etc).
  161.  
  162. All dump files are left in the same subdirectories you mail is  in.   Note  that
  163. Eudora places each mail folder in a subdiirectory off the current level.
  164.  
  165. You may want to PKZIP one or more of the *.DMP files and then move them  out  of
  166. your Eudora subdirectories, perhaps  storing  them  on  a  floppy  diskette  for
  167. purposes of retaining them.  As long as you are reasonably  sure  you  will  not
  168. want to be doing responses or something in Eudora, you can delete  the  messages
  169. from the mailboxes you save this way.
  170.  
  171.  
  172. EUMAIL.DOC                           4                         Revised: 05/13/96
  173.  
  174. Personally, I save all of my outgoing messages for some reason.  I then save  an
  175. ASCII version of what I sent, compress it, and then delete them en masse.
  176.  
  177. If you'd like, you can get just the table of contents for the messages and  skip
  178. the actual dump of the messages themselves.  This can be achieved by  using  the
  179. /HEADER option.
  180.  
  181. If you later decide you want to kill off all of the *.DMP  files,  pass  in  the
  182. parameter /KILLDUMP and it will take care of them for you.
  183.  
  184.  
  185. Specifying parameters:
  186.  
  187. Parameters for this program can be set in the following ways.  The last  setting
  188. encountered always wins:
  189.   - Read from an *.INI file (see BRUCEINI.DOC file),
  190.   - Through the use of an environmental variable (SET EUMAIL=whatever), or
  191.   - From the command line (see "Syntax" below)
  192.  
  193.  
  194. Syntax:
  195.  
  196.     EUMAIL { /Eeudora_sub | /SCAN [ d: ] } [ /Ooutput_sub ]
  197.       [ /NL=filename | /-NL ] [ /REPEAT ]
  198.       [ /NS=filename | /-NS ] [ /n ] [ /nK ] [ /n% ]
  199.       [ /DUMP | /HEADERS | /SPLIT | /KILLDUMP ] [ domain ]
  200.       [ /Q ] [ /Iinitfile | /-I ] [ /? ]
  201.  
  202. where:
  203.  
  204. "/Eeudora_sub" is the location where you installed Eudora.  There is no  default
  205. for this parameter; /SCAN C:  will be invoked if one is not  provided  and  this
  206. can take awhile.  The use of a EUMAIL.INI file is  heavily  recommended  to  set
  207. this parameter (see BRUCEINI.DOC).
  208.  
  209. "/SCAN d:" specifies that the program is to search for the Eudora  subdirectory.
  210. (It actually looks for the first file named NNDBASE.TXT.)  A disk drive  can  be
  211. specified (e.g. "/SCAN E:").  If none is provided, the program will scan your C:
  212. drive for the file.  Searching  can  take  awhile;  use  of  the  "/Eeudora_sub"
  213. parameter is recommended.
  214.  
  215. "/Ooutput_sub" is the subdirectory in which you want to  write  the  two  output
  216. files.  This subdirectory must exist already.  It defaults to /OC:\TEMP.  Again,
  217. the use of a EUMAIL.INI file is heavily recommended (see BRUCEINI.DOC).
  218.  
  219. "/NL=filename" specifies the filename that the nickname listing is to go to.  If
  220. no drive/path information is specified,  this  file  will  be  written  to  your
  221. /Ooutput_sub specification.  Otherwise, the name will override the  /Ooutput_sub
  222. specification.  Saying "/-NL" or "/NL="  without  any  filename  indicator  will
  223. suppress  the  creation  of  the  nicknames  file   altogether.    Defaults   to
  224. /NL=EUMAIL.TXT.
  225.  
  226. "/-NL" suppresses the creation of the nickname file entirely.
  227.  
  228.  
  229. EUMAIL.DOC                           5                         Revised: 05/13/96
  230.  
  231. "/REPEAT" says to repeat the names of the nicknames  when  they're  listed.   It
  232. looks better if you don't repeat them but if you use something like FIND on  the
  233. file, you might want to have them repeating.  Initially defaults to /-REPEAT.
  234.  
  235. "/-REPEAT" is the opposite of "/REPEAT".  The name of the nickname only  appears
  236. once even if it contains five e-mail addresses.  There  very  first  example  in
  237. this documentation shows the  output  with  /-REPEAT.   This  is  initially  the
  238. default.
  239.  
  240. "/NS=filename" specifies the filename that the mailbox/folder summary listing is
  241. to go to.  If no drive/path information is specified, this file will be  written
  242. to your /Ooutput_sub specification.   Otherwise,  the  name  will  override  the
  243. /Ooutput_sub specification.   Saying  "/-NS"  or  "/NS="  without  any  filename
  244. indicator will suppress the listing of  the  summary  altogether.   Defaults  to
  245. /NS=EUMAIL.BOX.
  246.  
  247. "/-NS" suppresses the creation of the mailbox summary file entirely.
  248.  
  249. "/n" specifies that any mailbox with more than "n" entries is to be indicated on
  250. the screen when the program runs.  The test for this is  done  independently  of
  251. the tests for the number or entries or the absolute filesize test; any box  with
  252. more than /n message or with a filesize bigger than /nK or a share of more  than
  253. /n% will be displayed unless /Q is specified.  Defaults to /100.
  254.  
  255. "/nK" specifies that any mailbox with more than "n" thousand (K) bytes is to  be
  256. indicated on the screen when the program  runs.   The  test  for  this  is  done
  257. independently of the tests for the number or entries or  the  absolute  filesize
  258. test; any box with more than /n message or with a filesize bigger than /nK or  a
  259. share of more than /n% will be displayed unless /Q is  specified.   Defaults  to
  260. /100K.
  261.  
  262. "/n%" specifies that any mailbox with more than "n" percentage (%) of the  total
  263. bytes used by all stored mail is to be shown on  the  screen  when  the  program
  264. runs.  The test for this is done independently of the tests for  the  number  or
  265. entries or the absolute filesize test; any box with more than /n message or with
  266. a filesize bigger than /nK or a share of more than /n% will be displayed  unless
  267. /Q is specified.  Defaults to /5%.
  268.  
  269.  
  270. EUMAIL.DOC                           6                         Revised: 05/13/96
  271.  
  272. "/DUMP" says to dump the contents of the  mailboxes  out  as  plain  ASCII  text
  273. documents.  The program generates one text file for each mailbox.   The  program
  274. will also add a table of contents in front of each dump for you.  The dump files
  275. will be the name of the folder with a  *.DMP  file  extension.   Note  that  the
  276. messages will appear in the order they show up when you view them on the  screen
  277. and you may want to re-sort them all first.  Defaults to  /-DUMP  (don't  create
  278. the dump files).
  279.  
  280. "/HEADERS" says to write out the message headers only, not the actual  messages.
  281. The header files will be the name of the folder with a *.DMP file extension.
  282.  
  283. "/SPLIT" takes each messages and dumps it as a individual text file.  The  files
  284. will be named as the DOS name of the mailbox with numeric  extensions  beginning
  285. with 001 (e.g. TRASH.001, TRASH.002, etc).
  286.  
  287. "/KILLDUMP" deletes  any  *.DMP  files  it  finds.   Also  deletes  any  of  the
  288. /SPLIT-produced files (e.g.  TRASH.001) that it finds.   This  is  used  if  you
  289. later decide you don't want any of the *.DMP files around or if  you've  already
  290. moved out the ones you need and you no longer want  the  rest  of  them  around.
  291. (Note:  /KILLDUMP will not delete any *.DMP or *.xxx files  for  you  if  you've
  292. deleted the mailbox itself.)
  293.  
  294. "domain" restricts /DUMP and /HEADERS processing to only those files whose names
  295. begin with a particular character string.  As an example, if you  just  want  to
  296. dump the "Out" mailbox, pass in "OUT".  Note that  this  will  also  dump  other
  297. mailboxes whose names begin with "OUT".  By default, all mailboxes are dumped if
  298. any are.
  299.  
  300. "/Q" says that no individual mailboxes are to be indicated on  the  screen  when
  301. the program runs.  This ignores any /n, /nK, or /n% settings.
  302.  
  303. "/Iinitfile" says to read an initialization file with the file name  "initfile".
  304. The file specification *must* contain a period.  Initfiles are described in  the
  305. BRUCEINI.DOC file.  Initially defaults to "/IEUMAIL.INI".
  306.  
  307. "/INULL" says to skip loading the initialization file.
  308.  
  309. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  310.  
  311.  
  312.  
  313. EUMAIL.DOC                           7                         Revised: 05/13/96
  314.  
  315. Author:
  316.  
  317. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  318. and redistribution provided relevant documentation is kept with the program,  no
  319. changes are made to the program or documentation, and it  is  not  bundled  with
  320. commercial programs or charged for separately.  People who need to bundle it  in
  321. for-sale packages must pay a $50 registration fee to  "Wayne  Software"  at  the
  322. following address.
  323.  
  324. Additional information about this and other Wayne Software programs can be found
  325. in the file BRUCEymm.DOC which should be included  in  the  original  ZIP  file.
  326. ("ymm" is replaced by the last digit of the year and the two digit month of  the
  327. release.  BRUCE603.DOC came out in March 1996.  This same naming  convention  is
  328. used in naming the ZIP file that this program was  included  in.)  Comments  and
  329. suggestions can also be sent to:
  330.  
  331.                 Bruce Guthrie
  332.                 Wayne Software
  333.                 113 Sheffield St.
  334.                 Silver Spring, MD 20910
  335.  
  336.                 fax: (301) 588-8986
  337.                 e-mail: bguthrie@nmaa.org
  338.                 http://hjs.geol.uib.no/guthrie/
  339.  
  340. See BRUCEymm.DOC file for additional contact information.
  341.  
  342. Foreign users:  Please provide an Internet e-mail address in all correspondence.
  343.  
  344. 
  345.