home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMNETML / IMLOG102.ZIP / IM-DOCS.DOC < prev    next >
Encoding:
Text File  |  1992-03-21  |  7.5 KB  |  172 lines
  1. ┌─┐┌─┬┬─┬┬─┐    ┌─┐   ┌─┬┬─┐┌─────┐┌─────┐
  2. │ ││ │└─┘│ │┌──┐│ │   │ ││ ││ ┌───┘├─────┘  By: Matthew Amann of 1:249/111
  3. │ ││ │   │ │└──┘│ │   │ ││ ││ │ ┌─┐├─────┐      and Eric Tremblay
  4. │ ││ │   │ │    │ │┌─┐│ ││ ││ │ └─┤└─────┤  V·E·R·S·I·O·N v1.02
  5. └─┘└─┘   └─┘    └─┴┴─┘└─┴┴─┘└─┴───┘      │
  6.                         ─────────────────┘ + IMLAID!
  7.  
  8. ░░ FILES INCLUDED     ░░
  9.  
  10. The following files are included in the IMLOGS and IMLAID package:
  11.  
  12. IMLOGS02.EXE ...... The file needed to execute IMLOGS v 1.02
  13. IMLAID02.EXE ...... The file needed to execute IMLAID v 1.02
  14. IM-DOCS.DOC ....... The documation files for IMLOGS and IMLAID
  15. IMLOGS.CFG ........ A sample configuration file
  16. MAILTOSS.LOG ...... Sample capture (input) file from a mail tosser
  17. ECHO-LOG.ANS ...... Sample output ANSI file for IMLOGS
  18. ECHO-LOG.ASC ...... Sample output ASCII file for IMLOGS
  19. IMLAID.ANS ........ Sample output ANSI file for IMLAID
  20. IMLAID.ASC ........ Sample output ASCII file for IMLAID
  21. MOREINFO.DOC ...... More information (Misc)
  22.  
  23. ░░ WHAT IS IMLOGS ??? ░░
  24.  
  25.     IMLOGS is a utility that creates a real time log of echomail delivery
  26. to your system.  It creates ASCII and ANSI files which you may make viewable
  27. on your BBS by your users.  Having such a service available to your users
  28. can make it very simple for them to find out when the last mail delivery was,
  29. and exactly what echos it consisted of.  It is compatible with all BBS software
  30. and all echomail networks.  It is also compatible with all echomail tossers
  31. which generate reports, while unpacking the inbound mail files, that indicate
  32. each area name while unpacking and tossing.  For example, IMAIL and QECHO are 
  33. of this type.
  34.  
  35.  
  36. ░░ CONFIGURATION FILE ░░
  37.  
  38. IMLOGS and IMLAID is run from a configuration file. This file is easy to change
  39. to your own needs.
  40.  
  41. The file format is simply a list of all your echomail areas you wish to be
  42. included in the output file, each on an individual line.  An example file is
  43. included for your convenience (please see IMLOGS.CFG).
  44.  
  45. ░░ RUNNING IMLOGS ░░
  46.  
  47. In order to run IMLOGS you must have the following files in the present/active
  48. directory:
  49.  
  50. IMLOGS02.EXE
  51. IMLOGS.CFG (IMLOGS_CONFIG_FILE)
  52.  
  53. The program is called with four parameters.  The first is a complete path and
  54. filename to your input file.  The second is a complete path and filename to
  55. the ANSI file you wish IMLOGS to create.  The thord is a complete path and
  56. filename to the ASCII file you wish IMLOGS to create.  The fourth is the
  57. complete path and filename of your IMLOGS_CONFIG_FILE.
  58.  
  59. The first file is created using your favorite echomail tosser, such as IMail. 
  60. Normally, IMail writes to the main console (screen), however this can be
  61. re-directed using an internal DOS function.  Simply use '> filename.txt' to
  62. create the file which IMLOGS will read.  Capture the output every time 
  63. echomail is delivered.  Immediately after delivery execute IMLOGS.
  64.  
  65. An example run, using 'mailtoss.log' as the first file, which IMLOGS will read
  66. and 'mailtoss.ans' as the file IMLOGS will write the ANSI output to, and using
  67. 'mailtoss.asc' as the file IMLOGS will write the ASCII output to.
  68.  
  69. C:\I-MAIL\IMAIL.EXE <option> > mailtoss.log imlogs.cfg
  70.                                 
  71.             │          │     └─────┴── Redirects the output to 'mailtoss.log'
  72.             │          └────────────── Please see the IMail documation
  73.             └───────────────────────── File name to execute IMail
  74.  
  75. C:\IMLOGS02.EXE mailtoss.log echo-log.ans echo-log.asc imlogs.cfg
  76.                                                      
  77.       │            │            │           │            │        
  78.       │            │            │           │    File name of Config file
  79.       │               │            │           └── File name for ASCII output
  80.       │            │            └────────────── File name for ANSI output
  81.       │            └─────────────────────────── File name for input file
  82.       └──────────────────────────────────────── File name to execute IMLOGS
  83.  
  84. The second file (the output) contains a list of all echo-mail areas that just
  85. recieved mail.  A sample output file is shown below:
  86.  
  87.  
  88.        IMLOGS  v 1.02 (c)       -=-=-=-=-    Copyright 1992, Mathew Amann    
  89.  Registered to: Salterton BBS   -=-=-=-=-  Salterton BBS @ FidoNet 1:249/111   
  90.  
  91. ------------- [IM-LOGS] Sat Mar 21 07:14:48 1992
  92.  
  93. ■ HELL249         (1 message(s) tossed)
  94. ■ USERS249        (2 message(s) tossed)
  95.  
  96. ------------- [IM-LOGS] Sat Mar 21 10:50:50 1992
  97.  
  98. ■ MAG.JM1         (2 message(s) tossed)
  99. ■ MAG.SM1         (2 message(s) tossed)
  100.  
  101. ------------- [IM-LOGS] Sat Mar 21 13:41:24 1992
  102.  
  103. ■ SYSOP249        (5 message(s) tossed)
  104. ■ PROG249         (2 message(s) tossed)
  105. ■ EAST_ONT_CHAT   (1 message(s) tossed)
  106. ■ USERS249        (2 message(s) tossed)
  107.  
  108.  
  109. ░░ RUNNING IMLAID ░░
  110.  
  111. IMLAID is a utility that may be used in conjunction with IMLOGS.  IMLAID
  112. compiles a DAILY echomail activity report and IMLOGS monitors the activity
  113. at an echomail delivery level during the day.  IMLAID uses IMLOGS' ASCII ouput
  114. file to generate such a report.  IMLOGS should be executed upon every delivery
  115. wheras IMLAID should be executed once per day, typically during your nightly
  116. maintenace.  The command line syntax is as follows:
  117.  
  118.  
  119. c:\IMLAID02.EXE mailtoss.asc imlaid.ans imlaid.asc imlogs.cfg
  120.                                                     
  121.       │           │            │           │            │        
  122.       │           │            │           │     File name of Config file
  123.       │              │           │           └─── File name for ASCII output
  124.       │           │            └─────────────── File name for ANSI output
  125.       │           └──────────────────────────── File name for ASCII input file
  126.       └──────────────────────────────────────── File name to execute IMLAID
  127.  
  128. The following is an example of a typical output of IMLAID:
  129.  
  130.  
  131.       IMLAID v 1.02 (c)        -=-=-=-=-=-    Copyright 1992, Eric Tremblay
  132. Registered to: Salterton BBS   -=-=-=-=-=-  Salterton BBS @ FidoNet 1:249/111  
  133.  
  134. ■ SYSOP249        (6 message(s) received yesterday)
  135. ■ EAST_ONT_CHAT   (8 message(s) received yesterday)
  136. ■ QUICKBBS        (67 message(s) received yesterday)
  137. ■ QUICKPRO        (1 message(s) received yesterday)
  138. ■ WRITE249        (6 message(s) received yesterday)
  139. ■ HELL249         (3 message(s) received yesterday)
  140. ■ USERS249        (13 message(s) received yesterday)
  141. ■ OOII            (13 message(s) received yesterday)
  142. ■ DESQVIEW        (99 message(s) received yesterday)
  143. ■ MAG.JM1         (3 message(s) received yesterday)
  144. ■ MAG.MJ1         (1 message(s) received yesterday)
  145. ■ MAG.SM1         (6 message(s) received yesterday)
  146. ■ MAG.JP2         (6 message(s) received yesterday)
  147. ■ MAG.CHAT        (1 message(s) received yesterday)
  148. ■ MAG.SYSOP       (1 message(s) received yesterday)
  149. ■ MAG.WARP        (1 message(s) received yesterday)
  150. ■ MAG.GUTS        (2 message(s) received yesterday)
  151.  
  152.      Salterton BBS received 237 messages in 17 echo areas yesterday
  153.  
  154.  
  155. ░░ IMLOGS AND IMLAID SUPPORT ░░
  156.  
  157. The author(s) of IMLOGS and IMLAID may be reached by one of the following means:
  158.  
  159. POST: Eric Tremblay
  160.       3488 Buck Point Road    FidoNet: 1:249/111.0@fidonet.org
  161.       RR #1
  162.       Inverary, Ontario    
  163.       K0H 1X0 -- CANADA
  164.  
  165. Please fell free contact the author(s) if you have any questions, inquiries,
  166. and/or requests.
  167.  
  168. ░░ CREDITS/COPYRIGHTS ░░
  169.  
  170. IMLOGS is (c) Copyright 1992 by Matthew Amann and Eric Tremblay of 1:249/111.
  171. IMAIL is (c) Copyright 1990, 1992 by Fabiano Fabris.
  172. QECHO is (c) Copyright 1992 by Pegasus Software