home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / IM2IM170.ZIP / IM2IMP.DOC next >
Text File  |  1995-07-03  |  5KB  |  154 lines
  1.  
  2.           IM2IMP/386, Create ECHOSCAN.LOG Utility for Imail
  3.                       Version 1.70, Revision 07/03/95
  4.                       (C) 1994-95 by Christian Coehn
  5.  
  6.  ----------------------------------------------------------------------------
  7.  
  8.  
  9.  Files in this archive 
  10.  ~~~~~~~~~~~~~~~~~~~~~
  11.  
  12.  IM2IMP.DOC    - this documentation
  13.  IM2IMP.EXE    - 16 Bit DOS  Version of IM2IMP
  14.  IM2IMPP.EXE   - 32 Bit OS/2 Version of IM2IMP
  15.  IMFUNC.DLL    - Library to access imail.ar, used by OS/2 version
  16.  
  17.  
  18.  What is it good for anyway?
  19.  ~~~~~~~~~~~~~~~~~~~~~~~~~~
  20.  
  21.  When I switched tossers from Squish to Imail I wanted to keep my favourite
  22.  tools for the squish message base like SFSQ (a mail robot by Robert Muchsel),
  23.  WIMM (a personal mail scanner by Gerard van Essen) or QQLink (a really fast
  24.  msgid-reply linker by Josh Parsons).
  25.  
  26.  However all these tools rely on an ascii file containing the areatags of all
  27.  echomail areas with newly tossed echomail. Usually this file is called
  28.  echoscan.log or import.xyz.
  29.  
  30.  Imail does not create this file - instead it marks all areas that need to
  31.  be linked in its internal area structure file imail.ar.
  32.  
  33.  IM2IMP creates this ascii file from imail.ar and resets the link
  34.  flag in imail.ar.
  35.  
  36.  
  37.  
  38.  What it doesn't do (hopefully)
  39.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  40.  
  41.  Ruin your Imail area setup by trashing imail.ar.
  42.  However IM2IMP has to write to imail.ar to reset the link flag. Although
  43.  IM2IMP uses sharing calls and doesn't write to files which are in use by
  44.  another process IT IS A VERY SMART IDEA TO BACKUP YOUR IMAIL.AR BEFORE
  45.  TESTING THIS PROGRAM.
  46.  
  47.  For security reasons IM2IMP now compares the structs used in Imail to
  48.  the structs uses in IM2IMP and aborts if versions do not match. You may
  49.  override this check with the -o command line parameter. Be sure to backup
  50.  your imail.ar before you do so.
  51.  
  52.  
  53.  
  54.  And how do I use it?
  55.  ~~~~~~~~~~~~~~~~~~~~
  56.  
  57.  IM2IMP <out-file> [options] 
  58.  
  59.  where
  60.  
  61.  out-file  is the ascii file containig the area tags
  62.  
  63.  The input files (imail.cf/imail.ar) are read from the
  64.  directory pointed to by the Imail environment variable.
  65.  IM2IMP will not work when the Imail variable is not
  66.  (properly) set.
  67.  
  68.  OS/2 Users: put IMFUNC.DLL somewhere into you libpath. Whenever you receive
  69.              a new version of IM2IMP, replace IMFUNC.DLL as well.
  70.  
  71.  Options:
  72.  
  73.  -h : Process only Hudson type echomail areas
  74.  -s : Process only Squish type echomail areas 
  75.  -j : Process only JAM type echomail areas
  76.  -l : Enable logging
  77.  -ll: Enable extended logging (mainly for debugging purposes) 
  78.  -q : Quiet mode (supress screen output)
  79.  -o : Override Imail Struct version check
  80.  
  81.  Example (the author's imtoss.bat):
  82.  
  83.  @echo off
  84.  rem --- scan & toss ---
  85.  if exist %squish%\echotoss.log imail scan
  86.  imail toss
  87.  
  88.  rem --- all squish areas are processed by qqlink ---
  89.  im2imp %squish%\import.xyz -s -l
  90.  
  91.  rem --- leave hudson to imail ---
  92.  imthings link /h
  93.  
  94.  rem --- Arealink/Compress ---
  95.  imalnk
  96.  imcomp
  97.  
  98.  rem --- call qqlink ---
  99.  cdd %squish%
  100.  qqlink -fimport.xyz
  101.  
  102.  
  103.  
  104.  Version History
  105.  ~~~~~~~~~~~~~~~
  106.  
  107.  1.00 ■ First public version
  108.  
  109.  1.01 ■ Added message base specific processing (-j/-s/-h)
  110.  
  111.  1.02 ■ On errors IM2IMP tried to write to the log file even
  112.         when logging was disabled. Fixed.
  113.       ■ Added some screen output to show progress. Doesn't seem
  114.         to slow down IM2IMP but added -q switch to suppress
  115.         progress indicator anyway.
  116.       ■ Added struct version check. Use -o to override.
  117.       ■ Changed logging. -l switch now produces a very small and useable
  118.         log wheras -ll produces the monster log of the previous version.
  119.       ■ DOS:  Since Imail 1.60 is 386+ only IM2IMP uses now 386 code, too.
  120.               Request Magic IM2I286 from my system for the 80286 version.
  121.       ■ OS/2: Changed OS/2 compiler to GCC 2.6.3 (and emx 0.9a)
  122.       ■ OS/2: Rewrote file handling, IM2IMP now uses OS/2 Api Calls instead
  123.               of ANSI functions. Seems to speed up disk I/O.
  124.  
  125.  1.03 ■ OS/2: IM2IMP now reads imail.ar into memory completely. This
  126.               speeds up processing on my system but may reduce speed on
  127.               low memory systems due to swapping.
  128.       ■ Changed compiler to Watcom C/C++ 10.0a for both DOS & OS/2 versions.
  129.  
  130.  1.70 ■ Rewrote IM2IMP from scratch. DOS and OS/2 versions are now built
  131.         from the same source. IM2IMP is faster and requires less memory.
  132.  
  133.       ■ Implemented Imail struct version 5.
  134.  
  135.       ■ IM2IMP now automagically detects imail.ar and imail.cf by
  136.         evaluating the Imail environment variable. Parameters have
  137.         changed. PLEASE CHANGE YOUR BATCH FILES ACCORDINGLY !!!
  138.  
  139.  
  140.  
  141.  License
  142.  ~~~~~~~
  143.  
  144.  $0 Shareware; warranty: none.
  145.  
  146.  
  147.  
  148.  Author
  149.  ~~~~~~
  150.  Christian Coehn at 2:2480/412@fidonet
  151.                  or cc@second.muc.de
  152.  
  153. <eof>
  154.