home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / MT333.ZIP / MT.DOC next >
Text File  |  1994-09-19  |  46KB  |  1,070 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                  MsgTrack 3.33
  23.  
  24.                                September 19, 1994
  25.  
  26.  
  27.                                   USER MANUAL
  28.  
  29.      
  30.                    Copyright (c) 1989-1994 Andrew D. Farmer.
  31.                               All rights reserved.
  32.  
  33.  
  34.  
  35.                                License Statement
  36.  
  37.  
  38.           The MsgTrack package is protected by both Canadian copyright 
  39.           law and international treaty provisions.
  40.  
  41.           MsgTrack is provided as is, without warranty of any kind, 
  42.           either expressed or implied.  Andrew D. Farmer only 
  43.           guarantees that MsgTrack will occupy disk space.
  44.  
  45.           In no event shall Andrew D. Farmer be liable to you or 
  46.           anyone else for any damages, including any lost profits, 
  47.           lost savings or other incidental or consequential damages 
  48.           arising out of the use or inability to use this program.
  49.  
  50.           All Andrew D. Farmer products are trademarks or registered 
  51.           trademarks of Andrew D. Farmer.
  52.  
  53.  
  54.           ------------------------------------------------------------
  55.  
  56.           The unregistered version of MsgTrack does not offer as many
  57.           'toys' as the registered version, but it is not crippled,
  58.           nor does it quit working after a period of time.  It is
  59.           fully functional as provided.
  60.  
  61.           The unregistered shareware version is yours to evaluate. If
  62.           you plan to use it for more than 30 days, you really should
  63.           consider registering it.
  64.  
  65.           If you are using MsgTrack within a commercial environment,
  66.           then immediate registration is mandatory.  It doesn't matter
  67.           if you are making money by using it or not, if you are using
  68.           it within commercial walls, you must register your copy.
  69.  
  70.           If you wish to register your copy of MsgTrack, see the file
  71.           REGISTER.ALL within the distribution archive.
  72.  
  73.           ------------------------------------------------------------
  74.  
  75.  
  76.                                    Chapter 1
  77.  
  78.                                     Preface
  79.  
  80.  
  81.      1.1  Archive
  82.  
  83.           The program archive, MT333.ZIP, should have included the
  84.           following files:
  85.  
  86.               MT.DOC       -  User manual.
  87.               MT333.NEW    -  Release notes.
  88.               MT.EXE       -  Main program.
  89.               MTSETUP.EXE  -  Setup program.
  90.               MTLOG.EXE    -  Log analyzer.
  91.               REGISTER.ALL -  Registration form.
  92.  
  93.      1.2  System requirements
  94.  
  95.           Although it is possible to run MsgTrack on a system with 
  96.           less than the following equipment, the following should be 
  97.           considered the realistic minimum with which you can get by:
  98.  
  99.               A 100% IBM BIOS compatible computer system with at
  100.               least 384K of available RAM.
  101.  
  102.               MS-DOS or PC-DOS version 3.20 or greater.
  103.  
  104.      1.3  AFI environment variable
  105.  
  106.           MsgTrack will expect to find its configuration data files in  
  107.           the DOS current directory or the directory pointed to by the 
  108.           AFI environment variable.
  109.  
  110.      1.4  AFIOPT environment variable
  111.  
  112.           By default MT uses 'smart' (int 21h, function 60h) path
  113.           resolution code.  Under some configurations, this actually
  114.           returns an unuseable pathspec.  Setting AFIOPT=LOTEK_RES
  115.           tells MT to use 'dumb' or 'lotek' path resolution code
  116.           (this consists of resolving ambiguous paths to absolute
  117.           paths, but not doing any internal remapping).
  118.  
  119.      1.5  TZ environment variable
  120.  
  121.           MsgTrack uses the TZ environment variable to calculate 
  122.           Universal Coordinated Time (UTC).
  123.  
  124.           Examples:  TZ=EST05EDT   TZ=AEST-10   TZ=GMT00   TZ=UTC0
  125.  
  126.      1.6  Key
  127.  
  128.           The registered version requires a key file for operation.  
  129.  
  130.  
  131.                                    Chapter 2
  132.  
  133.                                      Setup
  134.  
  135.  
  136.           The setup program, MTSETUP.EXE, is the backbone of MsgTrack.  
  137.           This full screen, menu driven, module is what you use to 
  138.           create and edit MsgTrack's configuration data files.
  139.  
  140.  
  141.      2.1  Video mode / command line syntax
  142.  
  143.           MTSetup will attempt to automatically use the correct video 
  144.           mode for your system, unfortunately some BIOSs return bogus 
  145.           information.  For that reason two command line options are 
  146.           available to you: -M will force MTSetup to use Mono video 
  147.           and -C will force MTSetup to use Colour video.
  148.  
  149.           Note: MTSetup uses direct screen writes.  If it detects
  150.                 DESQview, it will use the DV shadow buffer.
  151.  
  152.  
  153.      2.2  Errorlevels
  154.  
  155.           There are only 2 possible ErrorLevels that MTSetup can exit       
  156.           with.  Errorlevel 1 indicates a fatal error and Errorlevel 0 
  157.           indicates successful completion.
  158.  
  159.                   
  160.      2.3  Menus
  161.  
  162.           There are 6 top level (pull down) menus.  The settings 
  163.           available on the first 5 will be explained in this section.  
  164.           The 6th top menu, Managers, is explained in section 2.4.
  165.  
  166.  
  167.      2.3.1  File
  168.  
  169.           Copyright               This displays program identification 
  170.                                   and copyright information.  It will 
  171.                                   stay on the screen for 3 seconds, or 
  172.                                   until a key is pressed.
  173.  
  174.           Password                If a password is specified, all 
  175.                                   subsequent attempts to access 
  176.                                   MTSetup will require that the 
  177.                                   correct password to be provided.
  178.  
  179.           DOS Shell               This spawns a command shell using 
  180.                                   ComSpec. When you type EXIT to 
  181.                                   return to MTSetup, it will change 
  182.                                   directories back to where you were 
  183.                                   when you loaded MTSetup.
  184.  
  185.           DOS Shell (cont'd)      MTSetup will automatically attempt
  186.                                   to swap itself out of memory, when
  187.                                   spawning.  It will first attempt to
  188.                                   swap to EMS, if that fails it will
  189.                                   try for a swap to disk and if that
  190.                                   also fails, it will spawn without
  191.                                   swaping.
  192.  
  193.                                   You can also Shell to DOS by typing 
  194.                                   ALT-Z at any keyboard input field.
  195.  
  196.           Exit/Save               This causes MTSetup to quit and exit 
  197.                                   back to DOS. If you have made 
  198.                                   changes to your configuration, then 
  199.                                   you will be asked whether you wish 
  200.                                   to save the changes.
  201.  
  202.                                   You can also Exit/Save by typing ESC 
  203.                                   at any top level keyboard input field.
  204.  
  205.      2.3.2  General
  206.  
  207.           Address
  208.               Network Address     These are your network addresses 
  209.                                   (upto 20).
  210.  
  211.               Private Network     This is your private network number, 
  212.                                   if any.
  213.  
  214.               Domain Matching     This is a table of upto 30 domain 
  215.                                   names that should be mapped to a 
  216.                                   specific zone number.
  217.  
  218.           Sysops                  These are your names (upto 5).
  219.  
  220.                                   You can also choose whether or not
  221.                                   any messages addressed to an alias
  222.                                   (names 2-5) should be renamed so
  223.                                   that they are to your primary name.
  224.  
  225.           Paths
  226.               NetMail             This is the path to your network 
  227.                                   mail area.
  228.  
  229.               BadMail             This is the path to your bad mail 
  230.                                   area.  This is where MsgTrack will 
  231.                                   place bad messages.
  232.  
  233.               Inbound             This is the path to your mailer's 
  234.                                   inbound files area.
  235.  
  236.               SentMsgs            This is the path that you wish 
  237.                                   MsgTrack to place Sent message into.  
  238.                                   If not specified, the BadMail path 
  239.                                   will be used.
  240.  
  241.           Paths
  242.               RcvdMsgs            This is the path that you wish 
  243.                                   MsgTrack to place Received message
  244.                                   into. If not specified, the BadMail
  245.                                   path will be used.
  246.  
  247.               Nodelist            This is the path to your nodelist 
  248.                                   directory.  This is where MsgTrack 
  249.                                   will place, and expect to find, its 
  250.                                   nodelist index file (NODELIST.MTX).
  251.  
  252.               Semaphore           This is where MT will look for and
  253.                                   place semaphore files, such as the
  254.                                   FrontDoor rescan files.
  255.  
  256.           Nodelists               This is where you enter the names of 
  257.                                   your raw nodelist files (upto 10).  
  258.                                   This must include the complete path 
  259.                                   to the files.
  260.  
  261.                                   If you do not specify a file type 
  262.                                   (extension) MsgTrack will use the 
  263.                                   most recent file matching the trunk 
  264.                                   name.
  265.  
  266.                                   You can also choose whether or not 
  267.                                   nodes marked 'DOWN' should be 
  268.                                   included in the compiled index.
  269.  
  270.           Log Info
  271.               Log File            This is the path and name of the 
  272.                                   file that you wish MsgTrack to use 
  273.                                   for its log.  If this is not 
  274.                                   specified then there will be NO log.
  275.  
  276.               Log Data            This sub-menu allows you to select 
  277.                                   what actions you wish to have 
  278.                                   placed in the log file.  Here is a 
  279.                                   brief run-down of the action types:
  280.  
  281.                                   Fatal Errors are errors causing 
  282.                                   abortion of MsgTrack.
  283.  
  284.                                   Other Errors are non-fatal errors.
  285.  
  286.                                   Major Actions are items such as 
  287.                                   "Bounce Return Message sent to 
  288.                                   xxx/xxx", "NetMail #6 relocated to 
  289.                                   BadMail #4", "NetMail #5 Deleted".
  290.  
  291.           Log Info
  292.               Log Data            Routine Actions are items such as    
  293.                                   "Tracking, 1:243/1 -> 2:257/102".
  294.  
  295.                                   Message Info lines provide 
  296.                                   additional information about 
  297.                                   messages affected by Routine    
  298.                                   Actions.  They contain the To Name, 
  299.                                   From Name and Subject line of the    
  300.                                   message being processed.
  301.  
  302.                                   Runtime Status lines list the number 
  303.                                   of messages that MsgTrack scans in 
  304.                                   the area and the amount of RAM 
  305.                                   available for internal buffering.
  306.  
  307.                                   Trivial Messages are items such as
  308.                                   'Renumbering'. 
  309.  
  310.                                   Extended Debug logging is only 
  311.                                   useful to the author.  Turning this 
  312.                                   selection on will not have any 
  313.                                   effect unless authorized by the 
  314.                                   author.
  315.  
  316.               Log Format          This sub-menu allows you to select 
  317.                                   which of the four available log 
  318.                                   format types you wish to have used.
  319.  
  320.      2.3.3  Handling
  321.  
  322.           Attribute Bits
  323.               Strip Priority      This causes MsgTrack to remove the
  324.                                   Crash, Hold and XX2 bits and the DIR,
  325.                                   IMM and XMA flags from all passthrough
  326.                                   messages.  You can make exceptions
  327.                                   to this, see section 2.4.3. 
  328.  
  329.               Strip Attach        This causes MsgTrack to remove the
  330.                                   Attach bit from all passthrough
  331.                                   messages.  You can make exceptions
  332.                                   to this, see section 2.4.3.
  333.  
  334.               Strip Transit       This causes MsgTrack to remove the 
  335.                                   In-Transit bit from all passthrough 
  336.                                   messages.  You can make exceptions 
  337.                                   to this, see section 2.4.3.
  338.  
  339.               Strip Kill          This causes MsgTrack to remove the 
  340.                                   Kill/Sent bit from all passthrough 
  341.                                   messages.  You can make exceptions 
  342.                                   to this, see section 2.4.3.
  343.  
  344.           Attribute Bits
  345.               Add Private         This causes MsgTrack to add the 
  346.                                   Private bit to all passthrough 
  347.                                   messages.
  348.  
  349.               Strip Freq          This causes MsgTrack to remove the
  350.                                   FileRequest and UpdateRequest bits
  351.                                   from all passthrough messages.
  352.  
  353.           Miscellaneous
  354.               Map DB Flags        This causes MsgTrack to translate
  355.                                   the redundant flags used by D'Bridge
  356.                                   (PVT, CRA, RCV, SNT, FIL, K/S, HLD
  357.                                   and FRQ) to the 'standard' attribute
  358.                                   bits denoting the same status.
  359.  
  360.                                   Each flag will be striped when trans-
  361.                                   lated to an attribute bit.
  362.  
  363.               Stop Wild Att       This causes MsgTrack to remove the 
  364.                                   Attach bit from passthrough msgs, if 
  365.                                   (and only if) the attached filespec 
  366.                                   includes wildcard characters.
  367.  
  368.               Clear Cost          This causes MsgTrack to reset the 
  369.                                   Cost field in the msg header to zero 
  370.                                   (0) on all passthrough messages.
  371.  
  372.               Strip FAX           This causes MsgTrack to remove the
  373.                                   FAX related flags used by D'Bridge
  374.                                   (HIR, COV, SIG, LET) from all pass-
  375.                                   through messages.
  376.  
  377.      2.3.4  Actions
  378.  
  379.           NodeList Lookup
  380.               Check NodeList      This tells MsgTrack to check through 
  381.                                   the nodelist index for the Origin 
  382.                                   and Destination Address on each msg.  
  383.                                   If the address is not found, the 
  384.                                   message will not be forwarded.
  385.  
  386.                                   If this is not turned on, none of 
  387.                                   the other NodeList Lookup functions 
  388.                                   will be operative.
  389.  
  390.               Only My Zone        This tells MsgTrack to only confirm 
  391.                                   the existence of the Zone, not the 
  392.                                   Net and Node, for addresses outside 
  393.                                   of your primary Zone.
  394.  
  395.           NodeList Lookup
  396.               Skip Node Level     This tells MsgTrack not to check the 
  397.                                   Node address, only the Zone and Net, 
  398.                                   for addresses outside of your net.
  399.  
  400.               Return Bad Dest     This tells MsgTrack to Return 
  401.                                   messages with unknown destination 
  402.                                   addresses to the sender.
  403.  
  404.                                   The text for the return message may
  405.                                   be specified in BAD_DEST.MTB (in the
  406.                                   AFI environment directory).  If this
  407.                                   file is not present, default text
  408.                                   will be used.
  409.  
  410.               Warn Bad Orig       This tells MsgTrack to warn the 
  411.                                   recipient if the origin address on 
  412.                                   the message is unlisted.
  413.  
  414.               Hold Bad Orig       This tells MsgTrack to move any 
  415.                                   message with an unknown origin 
  416.                                   address to BadMail (or, delete it if 
  417.                                   the following option is used).
  418.  
  419.               Kill Failed Msgs    This tells MsgTrack to delete 
  420.                                   messages that failed the Nodelist 
  421.                                   lookup, instead of moving them to 
  422.                                   the BadMail area.
  423.  
  424.           EchoMail Handler  
  425.               Bounce EchoMail     This tells MsgTrack to disallow 
  426.                                   routed EchoMail. You can make 
  427.                                   exceptions to this, see section 
  428.                                   2.4.3.
  429.  
  430.                                   If this is not turned on, none of 
  431.                                   the other EchoMail Handler functions 
  432.                                   will be operative.
  433.  
  434.               Return to Sender    This tells MsgTrack to Return routed 
  435.                                   EchoMail messages to the sender.
  436.  
  437.                                   The text for the return message may
  438.                                   be specified in ECHOMAIL.MTB (in the
  439.                                   AFI environment directory).  If this
  440.                                   file is not present, default text
  441.                                   will be used.
  442.  
  443.               Kill Failed Msgs    This tells MsgTrack to delete routed 
  444.                                   EchoMail messages, instead of moving 
  445.                                   them to the BadMail area.
  446.  
  447.           Bad UUCP Handler  
  448.               Bounce Bad UUCP     This tells MsgTrack to bounce 
  449.                                   messages that are addressed to UUCP
  450.                                   on your system, but do not contain
  451.                                   a valid TO: routing line or are
  452.                                   marked as 'Orphan'.
  453.  
  454.                                   This option is only useful to those
  455.                                   running a FidoNet<->UUCP gateway.
  456.  
  457.                                   If this is not turned on, none of 
  458.                                   the other Bad UUCP Handler functions 
  459.                                   will be operative.
  460.  
  461.               Return to Sender    This tells MsgTrack to Return bad 
  462.                                   UUCP messages to the sender.
  463.  
  464.                                   The text for the return message may
  465.                                   be specified in BAD_UUCP.MTB (in the
  466.                                   AFI environment directory).  If this
  467.                                   file is not present, default text
  468.                                   will be used.
  469.  
  470.               Kill Failed Msgs    This tells MsgTrack to delete bad 
  471.                                   UUCP messages, instead of moving
  472.                                   them to the BadMail area.
  473.  
  474.  
  475.           Send Copies             You may enter a list of upto 5 
  476.                                   addresses where you wish messages 
  477.                                   addressed to you to be copied.  
  478.  
  479.                                   MsgTrack treats a message as  being 
  480.                                   addressed to you if it is addressed 
  481.                                   to one of the names listed under 
  482.                                   Sysops (see section 2.3.2) at one of 
  483.                                   your addresses (see section 2.3.2).
  484.  
  485.                                   You may additionally specify whether 
  486.                                   or not the original message should 
  487.                                   be deleted after it has been 
  488.                                   processed by Send Copies.  
  489.  
  490.      2.3.5  Miscellaneous
  491.  
  492.           Action Settings
  493.               Bounce Local Msgs   This tells MsgTrack to apply all
  494.                                   configured 'bounce' tests against
  495.                                   locally entered messages (mail
  496.                                   to/from your system), as well as
  497.                                   to passthrough mail.
  498.  
  499.           Action Settings
  500.               Ignore Zones        This tells MsgTrack to ignore Zone 
  501.                                   numbers during all address lookups.
  502.  
  503.               Move Sent Msgs      This tells MsgTrack to move msgs 
  504.                                   marked 'Sent' to the SentMsgs area.
  505.  
  506.               Move Rcvd Msgs      This tells MsgTrack to move msgs 
  507.                                   marked 'Rcvd' to the RcvdMsgs area.
  508.  
  509.               Gate INTL Mail      This tells MsgTrack to Zonegate 
  510.                                   route any Inter-Zone messages that 
  511.                                   are not already Zonegated.
  512.  
  513.               UnGate INTL Mail    This tells MsgTrack to remove Zone- 
  514.                                   gate routing on Inter-Zone messages.
  515.  
  516.               Keep Bounce Msgs    This tells MsgTrack not to mark any 
  517.                                   of the return messages, associated 
  518.                                   with bouncing mail, as Kill/Sent.
  519.  
  520.               FrontDoor Rescan    This tells MsgTrack to force 
  521.                                   FrontDoor (mailer/editor) to rescan 
  522.                                   the NetMail area if any changes have 
  523.                                   been made to the contents.
  524.  
  525.               Renumber NetMail    This tells MsgTrack to renumber the 
  526.                                   NetMail area.
  527.  
  528.                                   You can also cause multiple areas
  529.                                   to be renumbered by using the
  530.                                   -R<file> command line option.
  531.  
  532.               Full Screen Mode    This tells MsgTrack to operate in 
  533.                                   Full Screen mode, instead of BIOS
  534.                                   scroll mode.
  535.  
  536.               Force INTL Line     This tells MsgTrack to place an
  537.                                   INTL line into =all= messages.
  538.  
  539.               Process Packets     This tells MsgTrack to unpack any mail
  540.                                   packets (*.PKT files) that are in your
  541.                                   Inbound area.  USE THIS WITH CARE!
  542.  
  543.               Kill Inbound Freq   This tells MsgTrack to delete any
  544.                                   message that is addressed to your
  545.                                   system and has the File Request or
  546.                                   Update Request attribute bit set.
  547.  
  548.           Colour Choices
  549.               Customized          This allows you to manually select 
  550.                                   what colours MsgTrack will use while 
  551.                                   operating in Full Screen Mode.
  552.  
  553.           Colour Choices
  554.               Default mono set    This tells MsgTrack to use its 
  555.                                   default monochrone colour set while 
  556.                                   operating in Full Screen Mode.
  557.  
  558.               Default colour set  This tells MsgTrack to use its 
  559.                                   default CGA/EGA/VGA colour set while 
  560.                                   operating in Full Screen Mode.
  561.  
  562.  
  563.      2.4  Managers
  564.  
  565.           The managers allow you to control MsgTrack's powerful Point, 
  566.           Node, Exceptions and Routing handling functions.  All four
  567.           managers will now be explained.
  568.  
  569.  
  570.      2.4.1  Point Manager
  571.  
  572.           The Point Manager is a complete Point management interface.  
  573.           It allows you to specify upto 500 points and fully control 
  574.           what actions will be taken on each.
  575.  
  576.           Note that nothing you do in the Point Manager will become 
  577.           permanent until you exit and save your changes.
  578.  
  579.  
  580.      2.4.1.1  Wildcard macros
  581.  
  582.           When entering a name, you may specify an asterix (*) at the
  583.           end of the name.  This will cause a strict match only to be
  584.           made upto that point in the string, escentially wildcarding
  585.           the tail end of the string.
  586.  
  587.           Example:  Using "Andre*" would cause a match with "andrew
  588.                     farmer", "Andre Gagnon" or "Andrea Johnson".
  589.  
  590.  
  591.      2.4.1.2  Keystroke actions
  592.  
  593.           Enter                   Edit an existing entry.
  594.  
  595.           F1                      Toggle the active status of the 
  596.                                   current entry.  If the active status 
  597.                                   is set to no, then the entry will be 
  598.                                   ignored.
  599.  
  600.           F2                      Toggle the Mapping method.  This can 
  601.                                   be set to either Point or PvtNet.  
  602.                                   If set to Point, mail for that point 
  603.                                   will be addressed using a fully 
  604.                                   qualified 4-dimensional address.  If 
  605.                                   set to PvtNet, mail for that point 
  606.                                   will be addressed using a 3-
  607.                                   dimensional private network address.
  608.  
  609.           F3                      Global settings:
  610.  
  611.                                   If 'Map from Pvt Net' is set to yes, 
  612.                                   then any mail that originates in 
  613.                                   your private network will be 
  614.                                   remapped to show a fully qualified 
  615.                                   4-dimensional origin address.
  616.  
  617.                                   If 'Files to Points' is set to yes, 
  618.                                   then mail addressed to your points, 
  619.                                   that also has the Attach bit set, 
  620.                                   will have your Inbound path inserted 
  621.                                   as the 'attach path' for the file.
  622.  
  623.           Ins                     Insert a new entry.
  624.  
  625.           Del                     Delete an existing entry.
  626.  
  627.           Esc                     Exit/Save.
  628.  
  629.  
  630.      2.4.2  Node Manager
  631.  
  632.           The Node Manager is a complete Node management interface.  
  633.           It allows you to specify upto 500 addresses, or user names, 
  634.           whose mail you wish to have readdressed to a different 
  635.           destination.
  636.  
  637.           Note that nothing you do in the Node Manager will become 
  638.           permanent until you exit and save your changes.
  639.  
  640.  
  641.      2.4.2.1  Wildcard macros
  642.  
  643.           When entering a name, you may specify an asterix (*) at the
  644.           end of the name.  This will cause a strict match only to be
  645.           made upto that point in the string, escentially wildcarding
  646.           the tail end of the string.
  647.  
  648.           Example:  Using "Andre*" would cause a match with "andrew
  649.                     farmer", "Andre Gagnon" or "Andrea Johnson".
  650.  
  651.      2.4.2.2  Select menu
  652.      
  653.           A note about the 'Select' menu that will pop up whenever you 
  654.           hit Enter or Ins.
  655.  
  656.           If you select 'UserName' then you will be asked to enter a 
  657.           username followed by the node where that user's mail should 
  658.           be sent.  Note that only mail addressed to the specified 
  659.           user AT ONE OF YOUR ADDRESSES will be processed in this 
  660.           case.
  661.  
  662.           If you select 'Address' then you will be asked to enter a 
  663.           network address followed by the node where the mail should 
  664.           be readdressed.
  665.  
  666.           The default display screen will show an at sign (@) in front 
  667.           of all entries where you have selected 'Address'.
  668.  
  669.  
  670.      2.4.2.3  Keystroke actions
  671.  
  672.           Enter                   Edit an existing entry.
  673.  
  674.           F1                      Toggle the active status of the 
  675.                                   current entry.  If the active status 
  676.                                   is set to no, then the entry will be 
  677.                                   ignored.
  678.  
  679.           Ins                     Insert a new entry.
  680.  
  681.           Del                     Delete an existing entry.
  682.  
  683.           Esc                     Exit/Save.
  684.  
  685.  
  686.      2.4.3  Exceptions Manager
  687.  
  688.           The Exceptions Manager is a complete Exceptions management 
  689.           interface.  It allows you to specify upto 500 addresses 
  690.           (wildcards are allowed, read on) that should be excepted 
  691.           from 'Strip Priority', 'Strip Attach', 'Strip Kill/Transit',
  692.           and/or 'Bounce EchoMail' actions.
  693.  
  694.           Note that nothing you do in the Exceptions Manager will 
  695.           become permanent until you exit and save your changes.
  696.  
  697.      2.4.3.1  Wildcard macros
  698.  
  699.           When entering an address, you may specify an asterix (*) in 
  700.           any, or all, address portions (the 4 valid address portions 
  701.           are:  Zone, Net, Node and Point).
  702.  
  703.           Note that wildcarding will auto-flow in a greater to lesser 
  704.           direction.  That means that if you specify an asterix in the 
  705.           Net position, Node and Point will also be wildcarded.
  706.  
  707.           For example:
  708.  
  709.               Entering 1:243/* will cause any node in Zone 1, Network 
  710.               243, plus all point under them, to be excepted from the 
  711.               specified actions.  This would be displayed on the 
  712.               default screen as 1:243/All.All.
  713.  
  714.               Entering 3:*/* will cause any node/point in Zone 3 to be 
  715.               excepted from the specified actions.  This would be 
  716.               displayed on the default screen as 3:All/All.All.
  717.  
  718.               Entering 1:243/1.* will cause all points of 1:243/1 to
  719.               be excepted from the specified actions.  This would be
  720.               displayed on the default screen as 1:243/1.All.
  721.  
  722.  
  723.      2.4.3.2  Keystroke actions 
  724.  
  725.           Enter                   Edit an existing entry.
  726.  
  727.           F1                      Toggle the active status of the 
  728.                                   current entry.  If the active status 
  729.                                   is set to no, then the entry will be 
  730.                                   ignored.
  731.  
  732.           F2                      Select Origination exceptions. These 
  733.                                   are the actions that the specified 
  734.                                   address(es) should be excepted from 
  735.                                   if the message is FROM them.
  736.  
  737.           F3                      Select Destination exceptions. These 
  738.                                   are the actions that the specified 
  739.                                   address(es) should be excepted from 
  740.                                   if the message is FROM them.
  741.  
  742.           Ins                     Insert a new entry.
  743.  
  744.           Del                     Delete an existing entry.
  745.  
  746.           Esc                     Exit/Save.
  747.  
  748.  
  749.      2.4.4  Routing Manager
  750.  
  751.           The Routing Manager is a complete Routing management
  752.           interface.  It allows you to specify upto 500 addresses
  753.           (with user names if you wish), whose mail you will not
  754.           route.
  755.  
  756.           You may further select to disallow mail FROM this
  757.           address/name, mail TO this address/name or go hog wild and
  758.           disallow mail that is either FROM or TO this address/name.
  759.  
  760.           Note that nothing you do in the Routing Manager will become 
  761.           permanent until you exit and save your changes.
  762.  
  763.  
  764.      2.4.4.1  Wildcard macros
  765.  
  766.           When entering an address, you may specify an asterix (*) in 
  767.           any, or all, address portions (the 4 valid address portions 
  768.           are:  Zone, Net, Node and Point).
  769.  
  770.           Note that wildcarding will auto-flow in a greater to lesser 
  771.           direction.  That means that if you specify an asterix in the 
  772.           Net position, Node and Point will also be wildcarded.
  773.  
  774.           For example:
  775.  
  776.               Entering 1:243/* will cause any node in Zone 1, Network 
  777.               243, plus all point under them, to be excepted from the 
  778.               specified actions.  This would be displayed on the 
  779.               default screen as 1:243/All.All.
  780.  
  781.               Entering 3:*/* will cause any node/point in Zone 3 to be 
  782.               excepted from the specified actions.  This would be 
  783.               displayed on the default screen as 3:All/All.All.
  784.  
  785.               Entering 1:243/1.* will cause all points of 1:243/1 to
  786.               be excepted from the specified actions.  This would be
  787.               displayed on the default screen as 1:243/1.All.
  788.  
  789.      2.4.4.2  Keystroke actions
  790.  
  791.           Enter                   Edit an existing entry.
  792.  
  793.           F1                      Toggle the active status of the 
  794.                                   current entry.  If the active status 
  795.                                   is set to no, then the entry will be 
  796.                                   ignored.
  797.  
  798.           F2                      Select your DisAllow value.  It may
  799.                                   be set to NONE, TO, FROM or BOTH.
  800.  
  801.           F3                      Global settings:
  802.  
  803.                                   If 'Return to Sender' is set to yes, 
  804.                                   then any mail that is bounced on a
  805.                                   routing violation will be returned
  806.                                   to the sender.
  807.  
  808.                                   If 'Kill Failed Msgs' is set to yes, 
  809.                                   then any mail that is bounced on a
  810.                                   routing violation will be deleted,
  811.                                   instead of being relocated to the
  812.                                   BadMail area.
  813.  
  814.           Ins                     Insert a new entry.
  815.  
  816.           Del                     Delete an existing entry.
  817.  
  818.           Esc                     Exit/Save.
  819.  
  820.  
  821.                                    Chapter 3
  822.  
  823.                                     MsgTrack
  824.  
  825.  
  826.           The main program, MT.EXE, is ready to run once you have
  827.           configured with MTSetup and placed SYSTEM.MT (plus MT.KEY,
  828.           POINTSYS.MT, NODESYS.MT, EXCEPSYS.MT and ROUTESYS.MT if
  829.           applicable) into one of the directories where MsgTrack will
  830.           look for them (see section 1.3).
  831.  
  832.  
  833.      3.1  Video mode
  834.  
  835.           When operating in Full Screen mode, MsgTrack uses direct 
  836.           screen writes.  When operating in Scroll mode, MsgTrack 
  837.           writes to the screen using calls to the undocumented BIOS 
  838.           interrupt 29.  In both cases output in =not= redirectable.
  839.  
  840.           Note:  If MsgTrack detects DESQview, any direct screen
  841.                  writes will be done via the DV shadow buffer.
  842.  
  843.  
  844.      3.2  Command line syntax
  845.  
  846.           MsgTrack can be executed without any command line options, 
  847.           but a number of specialized features are available from the 
  848.           command  line.  Command line switches may be  preceded  with 
  849.           either a dash (-) or the currently configured DOS switch
  850.           char (normally a forward slash).
  851.  
  852.           Syntax/Usage:  MT <optional switches>
  853.  
  854.               -?                  This will cause MsgTrack to display 
  855.                                   a Syntax/Usage screen, then abort 
  856.                                   with nothing Done.
  857.  
  858.               -A                  By default, MsgTrack will NEVER
  859.                                   process message from ARCmail or
  860.                                   Tick on your system.  This switch
  861.                                   will override that default.
  862.  
  863.               -D                  When used with -P, this will cause 
  864.                                   the file(s) to be deleted after 
  865.                                   being posted.
  866.  
  867.               -F                  This will force MsgTrack to compile 
  868.                                   its NodeList Index, even if no 
  869.                                   compile is necessary, then abort 
  870.                                   with nothing else done.
  871.  
  872.               -L                  This will cause MsgTrack to NEVER
  873.                                   bounce locally entered messages.
  874.  
  875.               -Mdir               This will cause MsgTrack to scan the 
  876.                                   path specified by 'dir', instead of 
  877.                                   the NetMail area specified in your 
  878.                                   configuration.
  879.  
  880.               -N                  By default, MsgTrack will will 
  881.                                   automatically re-compile its 
  882.                                   NodeList index if it judges that a 
  883.                                   compile is necessary. Using this 
  884.                                   switch will 'short circuit' the 
  885.                                   auto-compile logic, telling MsgTrack 
  886.                                   to use the existing Index file, even 
  887.                                   if it is out-of-date.
  888.  
  889.               -Pfile              This will cause MsgTrack to post the 
  890.                                   file(s) specified by 'file' as msgs 
  891.                                   in your NetMail area. 'file' can 
  892.                                   include wildcards characters.
  893.  
  894.               -Q                  This will cause MsgTrack to run in 
  895.                                   Quiet mode, providing only minimal 
  896.                                   screen output.
  897.  
  898.               -R<file>            This will cause MsgTrack to renumber 
  899.                                   the NetMail area, then exit with 
  900.                                   nothing else done.
  901.  
  902.                                   The optional <file> is a raw ASCII 
  903.                                   text file listing one directory path 
  904.                                   per line.  If this is specified, 
  905.                                   then MsgTrack will renumber all 
  906.                                   directories listed therein.
  907.  
  908.               -S                  This causes MsgTrack NOT to include
  909.                                   the Subject line in 'Message Info'
  910.                                   log enties.
  911.  
  912.               -Tlogfile           This tells MsgTrack to use the 
  913.                                   path/filename specified by 'logfile' 
  914.                                   for its log, instead of the log file 
  915.                                   specified in your configuration.
  916.  
  917.  
  918.      3.3  Errorlevels
  919.  
  920.           The  following is a run-down of the 4 possible ErrorLevels 
  921.           that MsgTrack can exit with:
  922.  
  923.           Errorlevel 3            MsgTrack processed some messages.
  924.  
  925.           Errorlevel 2            Fatal Error - program abortion.
  926.  
  927.           Errorlevel 1            Fatal Error - program abortion.
  928.  
  929.           Errorlevel 0            Successful completion.
  930.  
  931.  
  932.                                    Chapter 4
  933.  
  934.                                   Log Analyzer
  935.  
  936.  
  937.           The log analyzer, MTLOG.EXE, is a small utility program
  938.           that will take as input a MsgTrack log (wildcards are
  939.           valid, so you can process multiple logs in one pass) and
  940.           output a report file.
  941.  
  942.  
  943.      4.1  Report
  944.  
  945.           The report file consists of 3 sections.
  946.  
  947.           The Activity report lists the total number of times a
  948.           particular action was executed.
  949.  
  950.           The From report lists msgs/bytes that were FROM a specific
  951.           address, no matter what the destination address was.
  952.  
  953.           The To report lists msgs/bytes that were TO a specific
  954.           address, no matter what the origination address was.
  955.  
  956.  
  957.      4.2  Video mode
  958.  
  959.           MTLog uses Standard Output for screen writes.
  960.  
  961.  
  962.      4.3  Command line syntax
  963.  
  964.           MTLog must be executed with two (2) command line options.
  965.  
  966.           Syntax/Usage:  MTLog [LogFile] [Report]
  967.  
  968.               LogFile             This is the MT logs(s) you wish to
  969.                                   process.  Wildcards are valid.
  970.  
  971.               Report              This is the path/filespec MTLog
  972.                                   should write its report file to.
  973.                                   Note that MTLog will OVERWRITE any
  974.                                   existing file by this name.
  975.  
  976.      4.4  Errorlevels
  977.  
  978.           The following are the 2 possible ErrorLevels that MTLog can
  979.           exit with:
  980.  
  981.           Errorlevel 1            Fatal Error - program abortion.
  982.  
  983.           Errorlevel 0            Successful completion.
  984.  
  985.  
  986.                                    Appendix A
  987.  
  988.  
  989.                           Program support - Help nodes
  990.  
  991.  
  992.           If you have any questions, concerns or reports of unexpected 
  993.           behavior in the software, the author can be contacted in the 
  994.           following ways:
  995.  
  996.  
  997.           Electronic:
  998.  
  999.               FidoNet:     1:243/1
  1000.  
  1001.               Internet:    adf@aficom.ocunix.on.ca
  1002.  
  1003.  
  1004.           Surface:
  1005.  
  1006.               Andrew D. Farmer
  1007.               P.O.Box 11087, Station H
  1008.               Nepean, Ontario
  1009.               K2H 7T8  CANADA
  1010.  
  1011.  
  1012.           Inquiries and questions about installation or operation may 
  1013.           also be addressed to the following help nodes: 
  1014.  
  1015.  
  1016.           Europe:                 Noel Bradford
  1017.                                   United Kingdom
  1018.                                   2:257/102@fidonet
  1019.  
  1020.                                   Peter Janssens
  1021.                                   Netherlands
  1022.                                   2:512/1@fidonet
  1023.  
  1024.           North America:          Bruce Bodger
  1025.                                   United States
  1026.                                   1:170/400@fidonet
  1027.  
  1028.  
  1029.  
  1030.                                   Appendix B
  1031.  
  1032.                           Thanks for all the fish...
  1033.  
  1034.  
  1035.           I would like to take this opportunity to thank all of the 
  1036.           people that helped to make MsgTrack what it is.  Over the
  1037.           years they have tested the pants off it, contributed many
  1038.           excellent feature ideas and inspired me to new heights, but
  1039.           above all they are a great bunch of people.  Let's give them
  1040.           all a standing ovation.  In alphabetical order, they are:
  1041.  
  1042.           John Barton, Bruce Bodger, Noel Bradford, Orlando Castillo,
  1043.           Greg Dawson, David Dodell, Scott Dudley, Tom Hall, Tom
  1044.           Hendricks, Jesse David Hollington, Joaquim Homrighausen,
  1045.           Mark Howard, Dave Hunter, Eric Jacksch, Peter Janssens,
  1046.           Felix Kasza, Bill Kraski, Renald Loignon, Joop Mellaart,
  1047.           Bruce Miller, jim nutt, David Osborne, George Peace,
  1048.           James Smith, Dieter Soltau, John Souvestre, Dan Thomson,
  1049.           Ken Wilson and several others that I have no doubt forgotten
  1050.           to mention (my appologies).
  1051.  
  1052.  
  1053.                                 Closing comments
  1054.  
  1055.           I have tried to make this documentation as complete as 
  1056.           possible, but there are always some small things that slip 
  1057.           through the cracks and aren't documented, or aren't 
  1058.           documented correctly.  I apologize in advance for any such 
  1059.           errors that may occur.
  1060.    
  1061.           I hope that you enjoy using MsgTrack and that it provides 
  1062.           you with the features you need to keep your netmail flow
  1063.           under control in our increasingly complex environment.
  1064.  
  1065.           MsgTrack is still very much 'in development' and I am always 
  1066.           open to feature suggestions, so please feel free to let me 
  1067.           know if you have some ideas that would make MsgTrack even 
  1068.           better.
  1069.  
  1070.