home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / FAN_200.ZIP / FAN.DOC < prev    next >
Text File  |  1993-09-12  |  78KB  |  1,849 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                         FAN
  17.  
  18.                    File Announcement Utility, version 2.00 Manual
  19.  
  20.            Copyright 1992, 1993 by David G. Fisher.  All rights reserved.
  21.  
  22.  
  23.  
  24.        Introduction
  25.             What is FAN?..........................................4
  26.             Disclaimer............................................5
  27.             Documentation/Credits.................................6
  28.             Registering FAN.......................................7
  29.             Submitting Bug Reports................................8
  30.  
  31.        Using FAN
  32.             The Basic Philosophy..................................9
  33.             Description of Syntax................................10
  34.             Defining Month Names.................................12
  35.  
  36.        Message Area Formats......................................13
  37.             Format - Packet (*.PKT)..............................13
  38.             Format - *.MSG.......................................13
  39.             Format - Squish......................................13
  40.             Format - ASCII Text File.............................13
  41.             Announcing messages to ASCII text files..............14
  42.             Announcing messages to NetMail.......................15
  43.             Announcing messages to local message bases...........16
  44.             Defining Announcement Areas..........................17
  45.  
  46.        Description of Announcement Area Components
  47.             MsgAreaName..........................................18
  48.             MsgAreaType..........................................18
  49.             MsgAreaPath..........................................18
  50.             From.................................................19
  51.             To...................................................19
  52.             Subj.................................................19
  53.             Attributes...........................................19
  54.             AddressFrom..........................................19
  55.             AddressTo............................................19
  56.             MonthIndex...........................................20
  57.             Announce.............................................20
  58.             Exclude..............................................20
  59.  
  60.        Message Construction
  61.             Templates............................................21
  62.             Valid Template Macros................................22
  63.             Sorting and Grouping File Announcements..............25
  64.             Testing Your Templates and Message Formats...........26
  65.  
  66.        Defining a FILES.BBS Announcement Area....................27
  67.             Maximus CBCS and Opus Alternatives...................27
  68.                  MaximusFileAreaFileName <file name>.............27
  69.                  MaximusFileArea <area name> <FAN announce name>.27
  70.  
  71.        Using the File Logging Feature............................29
  72.             AnnounceLogFile......................................29
  73.             AnnounceLogTemplate..................................29
  74.             AnnounceLogMonthIndex................................29
  75.  
  76.        Special Tick Considerations
  77.             Reading Tick's Configuration File....................30
  78.             Bad Tick Files.......................................30
  79.             Announcing Locally "Hatched" Files...................30
  80.             Using SEAL's FileDesc Statement......................30
  81.  
  82.        Unresolved (Unresolvable?) Bugs...........................31
  83.             Using FAN with ZMail under DOS.......................31
  84.  
  85.  
  86.  
  87.             Using FAN with AutoBoot 2.00 and Opus under DOS......31
  88.  
  89.        Future Possible Features/Enhancements.....................32
  90.  
  91.        Appendices
  92.             Appendix A - Example REXX procedure calling FAN......33
  93.             Appendix B - Example DOS procedures calling FAN......35
  94.             Appendix C - Examples that place BBS caller
  95.             information in DOS Environment Variables.............38
  96.  
  97.  
  98.        FAN Users Manual                                              Page 4
  99.        ----------------------------------------------------------------------
  100.  
  101.        What is FAN?
  102.  
  103.        FAN creates message announcements to announce new file arrivals by
  104.        scanning - either or both - standard FILES.BBS files and .TIC files
  105.        generated by file distribution systems running Barry Geller's TICK
  106.        utility, or .TIC clone programs such as AllFix.
  107.  
  108.        FAN was originally inspired by Doug Belkofer's RFD [R]eceived [F]or
  109.        [D]istribution, an MS-DOS program that works beautifully on .TIC
  110.        processed files, but lacked other features I desired, such as support
  111.        for long file descriptions, FILES.BBS files, or would run under OS/2.
  112.  
  113.        After many versions, FAN has evolved into an incredibly different and
  114.        more advanced program than RFD.  FAN can be configured to announce
  115.        files in a variety of customized formats.  The following is an example
  116.        of FAN's potential:
  117.  
  118.        From:   Dave Fisher of 1:170/110@fidonet.org
  119.        To:     All
  120.        Subj:   New Arrival(s) on LiveNet
  121.        Attr:
  122.        Arrivals ____________________________________________________ 1:170/110
  123.  
  124.        The following file(s) were received here for distribution
  125.        on 11 Sep 92 at 02:07:52:
  126.  
  127.        FAN_121.ZIP   115876 10-Sep-92  File announcement utility (DOS and OS/2).
  128.                                        Scans inbound .TICs and/or FILES.BBS for
  129.                                        new uploads.  Enhanced formatting for
  130.                                        long, justified descriptions... Just like
  131.                                        this one!  Distributed via FWCOMM from
  132.                                        1:170/110.
  133.  
  134.        --- FAN 1.21/beta
  135.         * Origin: LiveNet!  Tulsa's OS/2 Warehouse.  918-481-5715 (1:170/110)
  136.  
  137.        FAN custom formats file descriptions up to 1024 characters in length,
  138.        creating announcements that can also include information such as the
  139.        following:
  140.  
  141.             File Name
  142.             Size in Bytes or Kilobytes
  143.             Distribution Area Tag Name
  144.             Originating Address,
  145.             File Date (expressed in many different ways),
  146.             Name of FDN area, etc.
  147.  
  148.        File announcments can be grouped and sorted in a variety of ways, and
  149.        be written to *.PKT, *.MSG, Ascii Text, or Squish formatted message
  150.        bases.
  151.  
  152.        FAN is a bound program (which means it will run under OS/2 or DOS).
  153.  
  154.  
  155.        FAN Users Manual                                              Page 5
  156.        ----------------------------------------------------------------------
  157.  
  158.        Disclaimer
  159.  
  160.        This program is shareware.  There is absolutely no warranty for this
  161.        program or guarantee it will work.  The user of this program assumes
  162.        all risk.  While I feel confident this program will not harm your
  163.        system in any way, by using this program, you agree to assume full
  164.        responsibility for any adverse effect to your system.
  165.  
  166.        Where applicable, all trademarks referred to here are the property of
  167.        their owners.
  168.  
  169.  
  170.        FAN Users Manual                                              Page 6
  171.        ----------------------------------------------------------------------
  172.  
  173.        Documentation/Credits
  174.  
  175.        There are four document files that describe FAN.
  176.  
  177.        FAN.DOC
  178.  
  179.             The file you are reading is a basic description and
  180.             introduction to FAN.
  181.  
  182.             Many thanks to Bill Whitehouse and Raymond Beriau for their
  183.             helpful, editorial comments, and contributions to this
  184.             document!
  185.  
  186.        HISTORY.DOC
  187.  
  188.             History of changes to FAN should serve as a good reference to
  189.             track new FAN enhancements as they are added.
  190.  
  191.        CONTENTS.DOC
  192.  
  193.             Content listing of all the files that are distributed with FAN
  194.             and a brief description of each one.
  195.  
  196.        FAN.CFG
  197.  
  198.             The accompanying FAN.CFG configuration file is heavily
  199.             documented and demonstrates how I use FAN on my system. It is
  200.             a companion to this document, included to illustrate how FAN's
  201.             default settings are modified and how Announcement Areas are
  202.             defined.
  203.  
  204.  
  205.        FAN Users Manual                                              Page 7
  206.        ----------------------------------------------------------------------
  207.  
  208.        Registering FAN
  209.  
  210.        FAN is probably one of the most easy programs to register.  Once you
  211.        configure the enclosed FAN.CFG configuration file, simply run the
  212.        program REGISTER.  This program will read your configuration file and
  213.        generate a netmail message which will be addressed to FAN on my
  214.        system.  My system will then read this message and automatically reply
  215.        to you with your registration key.
  216.  
  217.        It's that simple!
  218.  
  219.        No forms, no envelopes, no hassles.
  220.  
  221.        Once you receive your reply, change your FAN configuration to use your
  222.        personalized registration key by altering the RegistrationKey
  223.        statement.
  224.  
  225.        Please note:  once you have a registration key, changing the
  226.        PrimaryAddress, SystemName, or Sysopname will invalidate that key.
  227.        You will have to run REGISTER again with the new information to obtain
  228.        a new registration key.
  229.  
  230.        When you are registered, your ^aPID kludge line (if enabled) will read
  231.        x.xx Reg instead of x.xx Eval.
  232.  
  233.        Currently, registrations using the REGISTER program can only be sent
  234.        via FidoNet, ibmNET, or OS2NET.
  235.  
  236.        Please register FAN!  Knowing how many sysops are using fan will help
  237.        me determine how much time and resources to allocate to future
  238.        development and enhancements.
  239.  
  240.        All registered users will automatically receive notice of new beta
  241.        releases.  If you do not wish to be notified, please netmail me with
  242.        your request to be removed from the beta team distribution list.
  243.  
  244.        While I don't demand a contribution, if you find this program useful
  245.        and would like to contribute to ongoing shareware development, please
  246.        send a contribution of $10 or more to:
  247.  
  248.             Dave Fisher
  249.             5131 East 88th Court
  250.             Tulsa, Oklahoma  74137
  251.             USA
  252.  
  253.        The most recent FAN release is always available here with the magic
  254.        File Request name of "FAN" (without the quotes).
  255.  
  256.  
  257.        FAN Users Manual                                              Page 8
  258.        ----------------------------------------------------------------------
  259.  
  260.        Submitting Bug Reports
  261.  
  262.        When submitting a bug report, please read the following guidelines.
  263.        Invaritably when someone reports a bug in FAN, I will have to write
  264.        back asking for one or more of the following items.  Performing these
  265.        tasks first will ensure that I will be able to identify the problem
  266.        quickly.
  267.  
  268.        1.   Write a brief description of the problem.
  269.  
  270.        2.   Run FAN using the undocumented qualifier /debug=<level>.
  271.  
  272.             I guess this qualifier isn't so `undocumented' now. :)  Adding
  273.             this qualifier to the command line will make FAN write quite a
  274.             bit of information to STDOUT (normally the screen).  Redirect
  275.             this to a file (say called DEBUG.OUT) and send it to me with
  276.             your bug report.  For example:
  277.  
  278.             FAN /debug=5 [...] > DEBUG.OUT
  279.  
  280.             Debug levels range from 1 to 5.  Please run at debug level 5
  281.             when submitting a bug report.  This will give me the most
  282.             detailed information concerning the internal processing of
  283.             FAN.
  284.  
  285.        3.   Include any relevant output files.
  286.  
  287.             This could include *.PKT files, log files, ASCII formatted
  288.             message files --whatever-- you feel would help shed some light
  289.             on FAN's abnormal behavior.
  290.  
  291.        4.   Include a copy of your configuration file.
  292.  
  293.             This is important!  Many times the bug may be due to a
  294.             configuration error, in which case I need to make FAN more
  295.             intelligent concerning the processing of the configuration
  296.             file, or more clear concerning the instructions when
  297.             configuring FAN.
  298.  
  299.        Bug reports may be submitted to me at any of the following addresses:
  300.  
  301.             Dave Fisher
  302.             LiveNet OS/2 BBS
  303.  
  304.             1:170/110@fidonet.org
  305.             40:4372/0 (ibmNET)
  306.             81:202/201 (OS2NET)
  307.  
  308.        Also, please don't hesitate to send enhancement suggestions.  FAN
  309.        wouldn't be what it is today without your thoughtful recommendations.
  310.  
  311.  
  312.        FAN Users Manual                                              Page 9
  313.        ----------------------------------------------------------------------
  314.  
  315.        The Basic Philosophy
  316.  
  317.        FAN is designed to run on two separate occasions:
  318.  
  319.             1.   After your mailer receives *.TIC files but before they are
  320.                  processed by TICK. And...
  321.  
  322.             2.   After new files are uploaded to file areas you want FAN to
  323.                  monitor (i.e., FILES.BBS files).
  324.  
  325.        I run FAN on my own system only when the mailer exits to process mail
  326.        and *.TIC files are found in the Inbound Directory. This a matter of
  327.        personal preference; FAN will announce any new arrivals since its last
  328.        run.
  329.  
  330.        If you want announcements to identify BBS uploaders by name you should
  331.        run FAN whenever new uploads are detected at caller log-off.
  332.  
  333.        See Appendix A for an OS/2 REXX example that processes my incoming
  334.        *.TIC files.
  335.  
  336.        See Appendix B for three DOS batch file examples.  The first two
  337.        examples processes *.TIC files, and the third demonstates how to use
  338.        DOS's ATTRIB.EXE and a choice of two other shareware utilities to
  339.        detect new BBS uploads and prompt FAN announcements.
  340.  
  341.        See Appendix C and the accompanying FAN.CFG and file templates for
  342.        examples that place BBS caller information in environment variables
  343.        FAN can use in its announcements.
  344.  
  345.        Once FAN identifies file(s) to announce, it checks its configuration
  346.        file for each "Announcement Area" you have defined.
  347.  
  348.        When received files match an Announcement Area, FAN creates the
  349.        announcment in the file format you have chosen (*.PKT, *.MSG, etc.).
  350.  
  351.        *.PKT files created by FAN are suitable for mail processing software,
  352.        such as Squish or oMMM.  FAN's *.PKT file adheres to FTS-0001 Fidonet
  353.        mail packet standards.  Simply execute your mail processing software
  354.        to import echomail once these packets are created.
  355.  
  356.  
  357.        FAN Users Manual                                              Page 10
  358.        ----------------------------------------------------------------------
  359.  
  360.        Description of Syntax
  361.  
  362.        FAN
  363.             /Config = <path+file name>          default: FAN.CFG
  364.             /[no]Log                            default: NoLog
  365.             /LogFile = <path+file name>         default: None
  366.             /LogLevel = <1..4>                  default: 4
  367.             /[no]LogWarnings                    default: LogWarnings
  368.             /[no]Quiet                          default: NoQuiet
  369.             /TossLogFile = <path+file name>     default: None
  370.             /FileArea = ( Areaname1, ... )      default: All Areas
  371.             /TestMode                           default: NoTestMode
  372.             /Debug=<0..5>                       default: 0 (no debug)
  373.  
  374.        Notes on the syntax:
  375.  
  376.             Qualifiers can appear in any order, in any case, and are only
  377.             significant to four characters.  /TossLogFile, for instance,
  378.             is the same as /toss.
  379.  
  380.        Qualifiers
  381.  
  382.        /Config = <path+file name>
  383.  
  384.             This is the name of the configuration file.  The default is
  385.             FAN.CFG in the current directory.  If you prefer, you can
  386.             define an environment variable using the DOS SET command
  387.             instead, with the following syntax:
  388.  
  389.             Set FAN_CONFIG=<path+filename>
  390.  
  391.        /[no]Log
  392.  
  393.             This qualifier will turn the logging function on and off.
  394.             Default is NoLog.
  395.  
  396.        /LogFile = <path+file name>
  397.  
  398.             This qualifier defines the name of the log file.
  399.  
  400.        /LogLevel = <1..4>
  401.  
  402.             This qualifier defines the level of log file detail.  Level 1
  403.             is the least detailed, while Level 4 is the most verbose.  The
  404.             levels indicate the 'importance' of a message, where Level 1
  405.             is the most important (usually error messages).
  406.  
  407.        /[no]LogWarnings
  408.  
  409.             This qualifier will run instruct FAN is print or not print
  410.             warning messages.  Warning messages simply point out possible
  411.             inconsistencies in your configuration of FAN.  They do not
  412.             suppress messages of a more serious nature.  For example, you
  413.             may be running FAN using a TIC configuration file, and
  414.             neglected to announce a couple of the areas in this file.  FAN
  415.             will issue a warning indicating the area does not appear in
  416.             any Announcement Definitions.  However, it may also be you do
  417.  
  418.  
  419.        FAN Users Manual                                              Page 11
  420.        ----------------------------------------------------------------------
  421.  
  422.             NOT wish to announce those areas, thus the warning messages
  423.             would be unwanted.
  424.  
  425.             I would suggest to let FAN run the first few times for all
  426.             warning messages, until you feel things are running smoothly.
  427.             Then add the /NoLogWarn qualifier to FAN command line (or
  428.             state NoLogWarnings in the configuration file) after several
  429.             actual runs.
  430.  
  431.        /[no]Quiet
  432.  
  433.             This qualifier controls whether FAN should print detailed
  434.             output to the "standard output device", which is normally the
  435.             screen.  Set it to /Quiet and all you see are the program
  436.             copyright line and any error messages.  The default is
  437.             /NoQuiet.
  438.  
  439.        /TossLogFile
  440.  
  441.             This qualifier instructs FAN to write the message area names
  442.             it processes to a specific file, enabling your tosser/scanner
  443.             (such as Squish or oMMM) to limit its processing to those
  444.             listed areas.
  445.  
  446.        /FileAreas = ( Areaname1, Areaname2, ... )
  447.  
  448.             This qualifier will allow you to run FAN and restrict the
  449.             announcements to occur ONLY within the list *.TIC/File areas.
  450.             The area names used are the TIC file area names (such as
  451.             SDSMAX), or the area names you have defined in the FAN
  452.             configuration file using the FILESBBS statements.
  453.  
  454.             This qualifier is especially convenient if you want to
  455.             announce files that a particular user uploaded to a particular
  456.             file area, and want to use environment variables to indicate
  457.             his/her name as the author of the upload.  By restricting the
  458.             announcements to ONLY that file area, you limit the risk of
  459.             announcing other new file arrivals erroneously with the
  460.             uploader's name.
  461.  
  462.        /[no]TestMode
  463.  
  464.             This qualifier will run FAN in its test mode.  For a
  465.             description of this test mode, please refer to the section
  466.             entitled "Testing Your Messages and Message Formats".
  467.  
  468.        /Debug=<0..5>
  469.  
  470.             This qualifier will instruct FAN to print internal processing
  471.             information to STDOUT.  This qualifier is useful when
  472.             submitting bug reports, or trying to solve a problem in the
  473.             configuration.  At the highest debug level (5), quite a bit of
  474.             information will displayed.
  475.  
  476.  
  477.        FAN Users Manual                                              Page 12
  478.        ----------------------------------------------------------------------
  479.  
  480.        Defining Month Names
  481.  
  482.        In order to accomodate multiple languages, as well as different month
  483.        name formats, different "month lists" can be defined in the FAN
  484.        configuration file.  Each list of month names has an index number
  485.        associated with it.  This number can be specified in each Announcement
  486.        Area Definition.  If it is not specifically specified in an
  487.        Announcement Area Definition, Month List 1 will be used.
  488.  
  489.        A Month List has the following format:
  490.  
  491.        Months [index number] [month names]
  492.  
  493.        There can be up to 9 different month lists (index numbers 1-9), each
  494.        starting with the keyword 'Months'.  The month names can be separated
  495.        by spaces or commas, and must all be listed on the same line.
  496.  
  497.        Month lists can be referenced within a message by either using the
  498.        MonthIndex keyword in the Announcement Area Definition, or using the
  499.        tokens [filemonthname1] to [filemonthname9] in the message template
  500.        files.  By using the month token [filemonthname] in the template
  501.        files, it is possible to mix different month name formats within one
  502.        single message.
  503.  
  504.  
  505.        FAN Users Manual                                              Page 13
  506.        ----------------------------------------------------------------------
  507.  
  508.        Message Area Formats
  509.  
  510.        FAN will create announcement messages in a variety of message formats.
  511.        These formats are as follows:
  512.  
  513.             Format - Packet (*.PKT)
  514.  
  515.             Packet, or *.PKT, files are normally received by network
  516.             front-end mailers such as BinkleyTerm and FrontDoor.  These
  517.             files are then processed by your tossing/scanning software and
  518.             entered into the appropriate message area, whether that be
  519.             echomail or netmail.
  520.  
  521.             If your message base is not supported by FAN, you would use
  522.             this option and define your DefaultMsgType as "Packet".
  523.  
  524.             Format - *.MSG
  525.  
  526.             *.MSG formatted message bases are the defacto FidoNet
  527.             standard.  However, more efficient message base formats are
  528.             becoming more popular, such as Squish.
  529.  
  530.             Format - Squish
  531.  
  532.             Squish formatted message bases area created and maintained by
  533.             the SQUISH software created by Scott Dudley.  Each message
  534.             base is stored in one file with a companion index file for
  535.             efficient searches and quick access.
  536.  
  537.             Format - ASCII Text File
  538.  
  539.             FAN recognizes a special message area type which does not
  540.             really relate to FidoNet at all.  Instead of sending messages
  541.             to a special formatted file such as Squish or *.PKT files, FAN
  542.             can write messages to a flat ASCII text file.  This makes
  543.             extremely flexible since the format of this file is up to you
  544.             when you design the message template files.
  545.  
  546.  
  547.        FAN Users Manual                                              Page 14
  548.        ----------------------------------------------------------------------
  549.  
  550.        Announcing messages to ASCII text files
  551.  
  552.        One powerful feature of FAN is the ability to announce messages to a
  553.        variety of ASCII text files in a variety of formats.  These text files
  554.        can be used as input to virus scanning software or news items for QWK
  555.        downloaders.  This feature is similar to the AnnounceLogFile, but
  556.        much, much more flexible.  There is no limit to the number of ASCII
  557.        Announce Areas that can be defined.
  558.  
  559.        Please note!  FAN will append to the ASCII text file if it already
  560.        exists.  Thus, if you intend the ASCII text file for a temporary use
  561.        (such as input for virus scanning), be sure to delete it after you are
  562.        done.
  563.  
  564.        In order to define ASCII text files, simply create an Announcement
  565.        Definition with the special keyword "ASCII", a message type
  566.        (MsgAreaType) of "ASCII", and include the statement "MsgAreaPath".
  567.        For example:
  568.  
  569.             MsgAreaName     ASCII
  570.  
  571.             MsgAreaType     ASCII
  572.             MsgAreaPath     c:\bbs\fan\allfiles.txt
  573.             MonthIndex      2
  574.             PrefixTemplate  c:\bbs\fan\pascii.tpl
  575.             FileTemplate    c:\bbs\fan\local.tpl
  576.             SuffixTemplate  c:\bbs\fan\sascii.tpl
  577.  
  578.             Announce        *
  579.  
  580.        For example, the above can be used to create nicely formatted messages
  581.        as news items to QWK downloaders.  All file areas will be announced
  582.        (since a wildcard match of "*" is used in the Announce statement)
  583.        using the specified templates.  Notice that it is not necessary to
  584.        specify "From", "To", "Subj", and/or "Attributes" statements since
  585.        these are not used within creation of the messages.  If you wish to
  586.        include this information in the annoncement, simply include it within
  587.        one of the prefix or suffix templates.
  588.  
  589.             MsgAreaName     ASCII
  590.  
  591.             MsgAreaType     ASCII
  592.             MsgAreaPath     c:\bbs\fan\ibmnet.txt
  593.             PrefixTemplate  None
  594.             SuffixTemplate  None
  595.             FileTemplate    c:\bbs\fan\fascii.tpl
  596.  
  597.             Announce        IBMOS2FX IBMDOSFX IBMEWS IBMINFO IBMTCPIP
  598.  
  599.        The above example illustrates the use of an ASCII area creating a
  600.        "raw" text file which can be used as input into another software
  601.        package.  Notice the prefix and suffix templates have been disabled.
  602.        This is necessary if default prefix and suffix templates have been
  603.        defined earlier in FAN.
  604.  
  605.  
  606.        FAN Users Manual                                              Page 15
  607.        ----------------------------------------------------------------------
  608.  
  609.        Announcing messages to NetMail
  610.  
  611.        If you wish to send an announcement to a particular person via
  612.        netmail, create the Announcment Definition in the usual manner with
  613.        the following exceptions:
  614.  
  615.             1.  Define the MsgAreaName as 'NETMAIL', and
  616.             2.  Include the keyword 'AddressTo'.
  617.  
  618.        For example:
  619.  
  620.             MsgAreaName     NETMAIL
  621.  
  622.             AddressFrom     1:170/110
  623.             AddressTo       1:170/110.7
  624.             From            Dave Fisher
  625.             To              Mark Barbee
  626.             Subj            New OS/2 files received via ibmNET
  627.             Attributes      LP
  628.             FileTemplate    c:\bbs\fan\local.tpl
  629.  
  630.             Announce        IBMOS2FX
  631.  
  632.        The message area name 'NETMAIL' will instruct FAN to format the
  633.        message for NetMail, and not EchoMail, which simply means there will
  634.        be no ^aAREA control line, no tag/origin line, no ^aPATH or ^aSEEN-BY
  635.        control lines, etc.  The addresses can be full 4D format of
  636.        <zone>:<net>/<node>.<point>.
  637.  
  638.  
  639.        FAN Users Manual                                              Page 16
  640.        ----------------------------------------------------------------------
  641.  
  642.        Announcing messages to local message bases
  643.  
  644.        If you instruct FAN to write a message in *.PKT format to a local
  645.        message base, special consideration must be given to these message
  646.        bases since they are not set up for incoming/outgoing echomail.  In
  647.        other words, these message bases are local to your system, and
  648.        messages are never scanned out to other systems.
  649.  
  650.        Normally, you do not have to define these message bases in your
  651.        tossing/scanning software.  However, since you have instructed FAN to
  652.        create *.PKT messages, you will have to define these local areas for
  653.        your particular tossing/scanning software.  For example, for Squish,
  654.        you simply define the area by creating an echo tag name and use your
  655.        address as the origination node:
  656.  
  657.             EchoArea  LOCAL      c:\max\msg\local   -$  170/110
  658.  
  659.        In this example, the MsgAreaName used in FAN will be "LOCAL" and the
  660.        origination node for the messages is my FidoNet node number, 170/110
  661.        (your own address would go here).
  662.  
  663.        For Opus, you would add the lines ECHOMAIL and SCAN to you local
  664.        message area and scan it to your address as follows:
  665.  
  666.        AREA    0007    SDS
  667.                NAME    SDS/SDN_In
  668.                PUBLIC MESSAGES ONLY
  669.                ACCESS PRIV     Disgrace
  670.                EDIT PRIV       Sysop
  671.                PEEK PRIV       Sysop
  672.                PATH            E:\MSG\SDS_IN\
  673.                TITLE           Incoming Software Distribution Files
  674.                MAXLINES        60
  675.                ECHOMAIL        FILESIN
  676.                SCAN            129/112
  677.        END AREA
  678.  
  679.        In the above example, you would identify the MsgAreaName in FAN as
  680.        "FILESIN".  The address after "SCAN" would be your own.
  681.  
  682.  
  683.        FAN Users Manual                                              Page 17
  684.        ----------------------------------------------------------------------
  685.  
  686.        Defining Announcement Areas
  687.  
  688.        Announcement Areas are central to defining FAN's operation.
  689.  
  690.        They include all the information FAN needs to create messages destined
  691.        for echomail, netmail, or a message area/base.
  692.  
  693.        Announcement areas are defined in the configuration file, each
  694.        beginning with the keyword 'MsgAreaName'.  It is important to note
  695.        that this area name is the "message area tag name" of the echo for
  696.        announcements, NOT the tag name of the File Distribution Area (used in
  697.        Tick and FILESBSS definitions).
  698.  
  699.        Each announcement area has the following 3 basic parts:
  700.  
  701.             1.   The Echo Tag Name (keyword 'MsgAreaName')
  702.             2.   Message Header Specific Information (keywords, 'From', 'To',
  703.                  'Subj', etc.)
  704.             3.   FDN Tag Names to announce (keyword 'Announce') or exclude
  705.                  (keyword 'Exclude')
  706.  
  707.        Each announcement area is fully self-contained, and does not effect
  708.        any other announcement area definitions.
  709.  
  710.  
  711.        FAN Users Manual                                              Page 18
  712.        ----------------------------------------------------------------------
  713.  
  714.        MsgAreaName
  715.  
  716.        The MsgAreaName is the name echo tag name of the message base.  All
  717.        files received which are part of the groups in the Announce lines will
  718.        have announcement messages created for this message base.
  719.        MsgAreaType
  720.  
  721.        Each announcement definition can create the announcement message in a
  722.        variety of formats.  These formats range from FTS-0001 *.PKT files
  723.        which will be placed in your incoming mail directory to actual message
  724.        bases (such as Squish formatted bases).  Keywords for the different
  725.        area types are Packet, *.MSG, Squish, or ASCII.  Please see the
  726.        section "Message Area Formats" for a list and description of each area
  727.        type available.
  728.  
  729.        Please note:  If the message area is formatted as *.MSG or Squish
  730.        message base, enable one or more of the FAN configuration statements
  731.        MaximusMsgAreaFileName, SquishCfgFileName, or AreasBBSFileName.  This
  732.        will cause FAN to fill in the MsgAreaType and MsgAreaPath for you, and
  733.        reduce the amount of work it would take for you to maintain the FAN
  734.        configuration file.
  735.  
  736.        Also, if you choose a default message type of *.PKT
  737.        (DefaultMsgAreaType), and define one of the above Maximus/Squish
  738.        control files, THE DEFAULT MESSAGE TYPE MAY BE OVERRIDDEN for any
  739.        given message area.  For example, if you announce to a message area
  740.        called NEWFILES and FAN finds this definition in the Squish (or other)
  741.        configuration file, then FAN will automatically override the default
  742.        message type for that area (NEWFILES in this case) and set it to the
  743.        type of message area found in the configuration file.
  744.  
  745.        If a message area is defined in a configuration file and you want to
  746.        force a specific message type, simply use the keyword MsgAreaType
  747.        within the Announcement Definition itself.
  748.  
  749.        MsgAreaPath
  750.  
  751.        This configuration statement has different meanings based on the
  752.        MsgAreaType.  They are as follows:
  753.  
  754.             MsgAreaType Packet
  755.  
  756.             MsgAreaPath is not used for *.PKT messages.  The configuration
  757.             statement PacketPath will be used for the message path.
  758.  
  759.             MsgAreaType *.MSG
  760.  
  761.             MsgAreaPath is the directory name of the *.MSG message base.
  762.             If you have configured FAN to read your Maximus, Squish, or
  763.             AREAS.BBS configuration file, you will not have to define
  764.             MsgAreaPath.
  765.  
  766.             MsgAreaType Squish
  767.  
  768.             MsgAreaPath is the directory plus base name of the Squish
  769.             message base.  If you have configured FAN to read your
  770.             Maximus, Squish, or AREAS.BBS configuration file, you will not
  771.             have to define MsgAreaPath.
  772.  
  773.  
  774.        FAN Users Manual                                              Page 19
  775.        ----------------------------------------------------------------------
  776.  
  777.  
  778.             MsgAreaType Ascii
  779.  
  780.             MsgAreaPath is the full path and filename of the ascii file to
  781.             create.
  782.  
  783.        From
  784.  
  785.        This is the name of the "person" that is credited as sending the
  786.        announcement.  You can even user YOUR name here!  The default is "File
  787.        Announcer".
  788.  
  789.        To
  790.  
  791.        This is the name of the "person" to whom the message is written.  The
  792.        default is "All".
  793.  
  794.        Subj
  795.  
  796.        This is the subject line of the message.  The default is "Files
  797.        received for distribution".
  798.  
  799.        Attributes
  800.  
  801.        These are one letter keywords toggling FAN message attributes.
  802.  
  803.             P = Private
  804.             C = Crash
  805.             H = Hold
  806.             K = Kill/Sent
  807.             L = Local
  808.             F = Forward
  809.             R = Read/Received
  810.             S = Sent
  811.             X = Scanned (Squish only)
  812.  
  813.        Many mail processing software packages will need the Local flag set on
  814.        the message ('L').  One or more of the following attributes can be
  815.        combined on the same line, with no intervening spaces.  For example,
  816.        to mark a message as Private and Local, either "LP" or "PL" would be
  817.        acceptable (without the quote marks).
  818.  
  819.        AddressFrom
  820.  
  821.        This is the address to use for the newly created message packet.
  822.        Normally, FAN will use the default address defined at the top of the
  823.        configuration file.  However, it is possible to create annoucements
  824.        for other networks using an alternate address by specifying
  825.        'AddressFrom' within the announcement definition.
  826.  
  827.        AddressTo
  828.  
  829.        When sending messages via NetMail (instead of being destined to an
  830.        EchoMail message base), 'AddressTo' will define the node address of
  831.        the receiving party.
  832.        MonthIndex
  833.  
  834.  
  835.        FAN Users Manual                                              Page 20
  836.        ----------------------------------------------------------------------
  837.  
  838.        If a 'MonthIndex' is not specified, the Month List defined as Index 1
  839.        will be used.  Otherwise, 'MonthIndex' will define a different month
  840.        list.  Whenever the template token [filemonthname] or [curmonthname]
  841.        is encountered, the default Month List for the Announcement Area will
  842.        be used.
  843.  
  844.        Announce
  845.  
  846.        These are the names of the File Distribution Areas for which you wish
  847.        to create announcement messages.  You can have one or more lines using
  848.        the keyword 'Announce'.  One or more Tick File Areas can be defined
  849.        can be defined on each 'Announce' line.  Simply separate each Tick
  850.        File Area name with a space.
  851.        You may also specify wildcarded File Distribution Areas in the
  852.        Announce statement.  Valid wildcards are the asterick and the question
  853.        mark.  An asterick matches to one or more characters, while the
  854.        question mark matches only one character.  For example, an Announce
  855.        name of "IBMO??FX" would match to IBMOS2FX, but not IBMDOSFX.  An
  856.        Announce name of IBM*FX would match to both of the above example File
  857.        Distribution Areas.
  858.  
  859.        Exclude
  860.  
  861.        Since Announce areas can contain wildcards, it may be necessary to
  862.        restrict some areas from being caught in the wildcarded match.  For
  863.        example, if you want to announce most of your File Distribution Areas,
  864.        except for a select few (such as private or beta File Distribution
  865.        Areas), the Exclude statement can be used.
  866.  
  867.        For example, if you wish to include all ibmNET FDN areas, except the
  868.        private sysop area, you would specify:
  869.  
  870.             Announce IBM*
  871.             Exclude  IBMNET
  872.  
  873.        The format of the Exclude statement is identical to the Announce
  874.        statement explained above.
  875.  
  876.  
  877.        FAN Users Manual                                              Page 21
  878.        ----------------------------------------------------------------------
  879.  
  880.        Templates
  881.  
  882.        FAN composes the body of each message with three templates.
  883.  
  884.        "FileTemplate" determines the form and content of each file
  885.        announcement.  "PrefixTemplate" and "SuffixTemplate" assign any
  886.        opening and closing remarks you choose to run at the top and bottom of
  887.        each message.  "GroupTemplate" will be used when sorting is active,
  888.        and will appear at the beginning of each "group" of files.
  889.  
  890.        PrefixTemplate usually consists of a short sentence describing the
  891.        purpose of the message, along with the time and date the announced
  892.        files were received on your system.  SuffixTemplate might include
  893.        other systems you distribute the files announced here to, File Request
  894.        limitations, etc.
  895.  
  896.        The GroupTemplate normally includes some type of group header/divider
  897.        information, such as the TIC/FILESBBS group description, etc.
  898.  
  899.        If PrefixTemplate, FileTemplate, or SuffixTemplate are not part of an
  900.        Announcement Definition (i.e., they are defined BEFORE any
  901.        Announcement Definitions), then that template will pertain to all
  902.        Announcement Definitions.  This default behavior can be overridden by
  903.        defining the template within the Announcement Definition itself.
  904.        Please see the example FAN.CFG enclosed in the FAN distribution
  905.        archive for examples.
  906.  
  907.        For example, if the following were defined within your FAN
  908.        configuration file:
  909.  
  910.             FileTemplate DEF_FILE.TPL
  911.  
  912.             MsgAreaName MESSAGE_BASE_1
  913.             From ....
  914.             To   ....
  915.  
  916.             MsgAreaName MESSAGE_BASE_2
  917.             From ....
  918.             To   ....
  919.             FileTemplate LOCAL.TPL
  920.  
  921.             MsgAreaName MESSAGE_BASE_3
  922.             From ....
  923.             To   ....
  924.  
  925.        The file template DEF_FILE.TPL will be used for MESSAGE_BASE_1 and
  926.        MESSAGE_BASE_3, while the file template LOCAL.TPL will be used for
  927.        MESSAGE_BASE_2.
  928.  
  929.  
  930.        FAN Users Manual                                              Page 22
  931.        ----------------------------------------------------------------------
  932.  
  933.        Valid Template Macros
  934.  
  935.        All FAN macros, or tokens, are expanded as the message is created.
  936.        They are not case sensative (i.e., they can be in upper or lower
  937.        case).  The basic syntax of a macro is as follows:
  938.  
  939.             [ macroname, macro options, ... ]
  940.  
  941.        A macro is enclosed within brackets, and can include one or more macro
  942.        options which effect the appearance of the final formatted text.  The
  943.        order of the macro options are not significant.  Macro options are
  944.        only significant to 4 characters.  Thus, "TRUNCATE" is the same as
  945.        "TRUN" or "TRUNC".  See below for a list of macro options.
  946.  
  947.        The following macros are valid within ANY of the templates, as
  948.        well as specified To:, From:, and Subj: fields in FAN's configuration
  949.        file.
  950.  
  951.             The following macros expand various aspects of the current
  952.             date of the announcement:
  953.  
  954.             [curdate]           Current date in "DD [month name] YY" format
  955.             [curtime]           Current time in "HH:MM:SS" format
  956.             [curmonthname]      Current month name (using DefaultMonthIndex)
  957.             [curmonthname1..9]  Current month name using index N (1-9)
  958.             [curmonth]          Current month number (01-12)
  959.             [curday]            Current day number (01-31)
  960.             [curyear]           Current year number (i.e., "93")
  961.             [curyear4]          Current year number (i.e., "1993")
  962.  
  963.             Miscellaneous macros:
  964.  
  965.             [totalsize]         The total size of all files announced in the
  966.                                 message, in bytes
  967.             [totalsizeKB]       The total size of all files announced in the
  968.                                 message, in kilobytes (rounded to one decimal
  969.                                 place, i.e., 130.8 kilobytes).
  970.             [env:varname]       A valid DOS environment variable "VARNAME".
  971.                                 For example, if the user's name who uploaded
  972.                                 a file is in the environment variable ULNAME,
  973.                                 then this macro would be expressed as
  974.                                 [env:ULNAME].
  975.             [text,"???"]        Normally, text is simply written within the
  976.                                 template file without any translation.
  977.                                 However, it is possible to have FAN perform
  978.                                 the same formatting functions on
  979.                                 miscellaneous text as it does on macro
  980.                                 tokens.  For example, if you wanted a portion
  981.                                 of text to be a continuation of the previous
  982.                                 margined paragraph, specify something liek
  983.                                 [text,"Uploaded by ",MARGINS:30:78] instead
  984.                                 of simply writing "Uploaded by " directly
  985.                                 into the template file.
  986.  
  987.        The following macros are valid ONLY within the FileTemplate or
  988.        GroupTemplate:
  989.  
  990.  
  991.        FAN Users Manual                                              Page 23
  992.        ----------------------------------------------------------------------
  993.  
  994.             [filepath]          The full path name of the file received.
  995.                                 This is the physical directory location of
  996.                                 the file on your machine.
  997.             [filename]          The name of the file received
  998.             [filefullname]      The full path and file name ([filepath] +
  999.                                 [filename])
  1000.             [filebasename]      The base filename without extension (i.e.,
  1001.                                 "TEST")
  1002.             [fileext]           The file extension (i.e., "ZIP")
  1003.             [filesize]          The size of the file in bytes
  1004.             [filesizeKB]        The size of the file in Kilobytes
  1005.             [areatagname]       The TICK/FILESBBS file distribution area tag
  1006.                                 name
  1007.             [fileareadesc]      The TICK/FILESBBS file distribution area
  1008.                                 description
  1009.             [fileorigin]        The address where the file originated
  1010.             [filedesc]          The complete description of the file (up to
  1011.                                 1024 characters)
  1012.             [fileyear]          The file date year, expressed as two digits
  1013.                                 (i.e., "93")
  1014.             [fileyear4]         The file date year, expressed as four digits
  1015.                                 (i.e., "1993")
  1016.             [filemonthname1..9] The file date month, expressed as text as
  1017.                                 defined in the configuration file (using the
  1018.                                 'Months' keyword).  If a number does not
  1019.                                 follow [filemonthname], then the default
  1020.                                 Month List will be used.  Otherwise, specific
  1021.                                 month lists can be specified by using
  1022.                                 [filemonthname1], [filemonthname2], ...
  1023.                                 [filemonthname9], where the number is the
  1024.                                 Index Number of the Month List.
  1025.             [filemonth]         The file date month, expressed as two digits
  1026.             [fileday]           The file date day, expressed as two digits
  1027.  
  1028.        Any macro can also include any the following format options:
  1029.  
  1030.             Number
  1031.  
  1032.             A number after the macro name will force the expanded text to
  1033.             the indicated field length.  The actual text will not be
  1034.             truncated.  Thus, if the actual length of the expanded text is
  1035.             greater than "Number", then the output will be greater than
  1036.             "Number".  If the actual length of the expanded text is less
  1037.             than "Number", spaces will be padded until the length is
  1038.             "Number".  For example, if you want a 12 character fixed
  1039.             length field for the file/TIC area tag name, specify
  1040.             [areatagname,12].
  1041.  
  1042.             TRUNCATE
  1043.  
  1044.             Only applicable if a field length is specified.  If the actual
  1045.             length of the expanded text is greater than the field length
  1046.             indicated, the text will be truncated to the specified field
  1047.             length.  For example, if you only want up to 25 characters of
  1048.             the file description text, specify [filedesc,TRUNCATE,25].
  1049.  
  1050.             RIGHT
  1051.  
  1052.  
  1053.        FAN Users Manual                                              Page 24
  1054.        ----------------------------------------------------------------------
  1055.  
  1056.             Only applicable if a field length is specified.  This macro
  1057.             option will right justify the text.  For example, if you wish
  1058.             to have the file size right justified within a 10 character
  1059.             field, the syntax would be: [filesize,RIGHT,10].
  1060.  
  1061.             MARGINS:left:right
  1062.  
  1063.             One powerful feature of FAN is the ability to left and right
  1064.             justify text.  This is extremely handy if you want to format
  1065.             long file description lines, or create paragraph-like output.
  1066.  
  1067.             It is important to note that when MARGINS are spcified and FAN
  1068.             writes to a line of formatted text, it will NOT overwright
  1069.             previous text.  Thus, if your output line is already 50
  1070.             characters in length, and you specify a left margin of "30",
  1071.             FAN will append to the line until it hits the right margin.
  1072.             When a new line is created, FAN will move to the left margin
  1073.             and begin writing again.  In this way, it is possible to
  1074.             create "paragraphs" if you specify the same left and right
  1075.             margins for the output text.
  1076.  
  1077.             For example, if you wish to create a paragraph that begins
  1078.             with the file description and ends with the name of the TIC
  1079.             area tag and origin address of the file, you would specify:
  1080.  
  1081.             Desc: [filedesc,MARGINS:6:45] - [text,"Distributed via ",
  1082.                  MARGINS:6:45][areatagname,MARGINS:6:45][text,
  1083.                  " from ",MARGINS:6:45][fileorigin,MARGINS:6:45]
  1084.  
  1085.             The above should all be one line, it was broken ino three
  1086.             lines for readability.  It would produce output similar to:
  1087.  
  1088.             Desc: Listing of files available on the IBM Canada
  1089.                   BBS systems - Distributed via IBMNET from
  1090.                   40:649/312
  1091.  
  1092.             The left and right margins start at the count of zero, not
  1093.             one.  Thus, MARGINS:0:79 is a full 80 character line, from 0
  1094.             to 79.
  1095.  
  1096.        See the accompanying .TPL files for examples of actual usage.
  1097.  
  1098.  
  1099.        FAN Users Manual                                              Page 25
  1100.        ----------------------------------------------------------------------
  1101.  
  1102.        Sorting and Grouping File Announcements
  1103.  
  1104.        FAN can sort and/or group file announcements in the order they were
  1105.        received, or alphabetically by filename and/or TIC/FILESBBS tag name.
  1106.  
  1107.        Sort methods available are:
  1108.  
  1109.             None   :  No sort.  Files will be announced in the order they
  1110.                       are processed.
  1111.             Alpha  :  Files will be sorted alphabetically by filename.
  1112.             Group  :  Files will be sorted by group (TIC/FILESBBS) name,
  1113.                       tag and then alphabetically by filename within the
  1114.                       group.
  1115.  
  1116.        The sort method can also be Announcement Definition specific.  Thus,
  1117.        you can have different sorting/presentation strategies for different
  1118.        message areas.  If defined outside any Announcement Definition, this
  1119.        will become the default for any areas in which a SortMethod is not
  1120.        specified.
  1121.  
  1122.        When choosing a sort method Alpha or Group, the GroupTemplate, if
  1123.        defined, will be used.
  1124.  
  1125.  
  1126.        FAN Users Manual                                              Page 26
  1127.        ----------------------------------------------------------------------
  1128.  
  1129.        Testing Your Templates and Message Formats
  1130.  
  1131.        In order to experiment and refine the format of your messages, FAN has
  1132.        a "test" mode.  This test mode will enable you to test FAN without
  1133.        actually creating *.PKT's in your mailer's inbound directory, and
  1134.        possibly toss those messages by mistake.  In this mode, the following
  1135.        conditions apply:
  1136.  
  1137.             1.   All messages intended for a *.PKT will instead be written
  1138.             to an ascii text file.  This file will be the name of the echo
  1139.             area (MsgAreaName) meant to receive the message with an
  1140.             extension of *.TST, or if the MsgAreaName is ASCII, then
  1141.             MsgAreaPath will be used (the path will be stripped from the
  1142.             filename first).  If the name of the echo area exceeds 8
  1143.             characters, only the first 8 characters of the echo area name
  1144.             will be used.  Thus, if the echo area name is "LOCAL", the
  1145.             name of the file will be "LOCAL.TST".
  1146.  
  1147.             These files will be created in the current directory.
  1148.  
  1149.             2.   The log file name, if specified, will be overridden.  The
  1150.             new log file name will be "TEST.LOG" and will be created in
  1151.             the current directory.
  1152.  
  1153.             3.   No entries will be written to AnnounceList.
  1154.  
  1155.             4.   No entries will be written to AnnounceLogFile.
  1156.  
  1157.             5.   *.RAD files for locally hatched files using TIC will NOT
  1158.             be deleted.
  1159.  
  1160.             6.   FAN will look in the current directory for *.TIC or
  1161.             FILES.BBS files to create announcements.
  1162.  
  1163.             7.   Path names will be stripped from the template files
  1164.             defined in FAN.CFG.  FAN will look for these template files in
  1165.             the current directory.
  1166.  
  1167.        To invoke FAN in test mode, simply use the qualifier "/TestMode", or
  1168.        simply "/Test".
  1169.  
  1170.        For example:
  1171.  
  1172.             FAN /test [...]
  1173.  
  1174.        A quick, easy way to test your templates is to create a test directory
  1175.        and either save a few of your *.TIC files, or if you do not receive
  1176.        *.TIC files, create a test FILES.BBS file with a few entries.  Since
  1177.        FAN looks in the current directory for these files while in test mode,
  1178.        nothing in your "live", active directories will change.
  1179.  
  1180.  
  1181.        FAN Users Manual                                              Page 27
  1182.        ----------------------------------------------------------------------
  1183.  
  1184.        Defining a FILES.BBS Announcement Area
  1185.  
  1186.        It is possible to have FAN announce new files that are uploaded to
  1187.        your system by having it monitor one or more FILES.BBS files.  FAN
  1188.        keeps a database of files that have already been announced.  In this
  1189.        way, FAN can identify new FILES.BBS entries (see keyword
  1190.        'AnnounceList' in the configuration file).
  1191.  
  1192.        There are four parts to the FILES.BBS definition:
  1193.  
  1194.             FILESBBS_FileName [filename]
  1195.  
  1196.             This is the full path and file name of the FILES.BBS file.  On
  1197.             most systems, this will be [path]\FILES.BBS.  Some systems,
  1198.             however, use different file names.
  1199.  
  1200.             FILESBBS_Files [pathname]
  1201.  
  1202.             This is the path where the actual files listed in the
  1203.             FILES.BBS file reside.  Some systems keep all their
  1204.             downloadable files in one directory, which are referenced by
  1205.             different FILES.BBS files.
  1206.  
  1207.             FILESBBS_AnnounceName [name]
  1208.  
  1209.             When you are writing the Announcement Definition in the FAN
  1210.             configuration file, the TIC area tag name is specified on the
  1211.             'Announce' line.  Since there is no TIC area tag name
  1212.             associated with your FILESBBS file area, FILESBBS_AnnounceName
  1213.             is used to create a "dummy" TIC tag name to use on the
  1214.             'Announce' line.
  1215.  
  1216.             FILESBBS_Description [description]
  1217.  
  1218.             This is the description of the FILESBBS area.  It will be used
  1219.             when expanding the template macro [fileareadesc].
  1220.  
  1221.        All the above keywords MUST be used in the order that they are
  1222.        describe above (i.e., FILESBBS_FileName, FILESBBS_Files,
  1223.        FILESBBS_AnnounceName, and then FILESBBS_Description).
  1224.  
  1225.        Maximus CBCS and Opus Alternatives
  1226.  
  1227.        If you are running Maximus or Opus, FAN can read the path information
  1228.        directly from your file area control file.  Simply use the keywords
  1229.        MaximusFileAreaFileName and MaximusFileArea.  If you specify the
  1230.        FILES.BBS areas here, you do not have to define them using the
  1231.        FILESBBS FAN keywords.
  1232.  
  1233.        MaximusFileAreaFileName <file name>
  1234.  
  1235.        This keyword specifies the name of the control file which contains all
  1236.        the downloadable directory information for file sections on your BBS.
  1237.  
  1238.        MaximusFileArea <area name> <FAN announce name>
  1239.  
  1240.        This keyword attaches a specific "announce name" to each file area you
  1241.        wish FAN to monitor.  The announce name can be the same for every
  1242.  
  1243.  
  1244.        FAN Users Manual                                              Page 28
  1245.        ----------------------------------------------------------------------
  1246.  
  1247.        area, or different.  It is usually helpful to use different announce
  1248.        names for each area, since this announce name can be included in the
  1249.        text of the announcement message itself using the [areatagname] token
  1250.        (see section Message Construction).
  1251.  
  1252.        For example, if you had the following areas:
  1253.  
  1254.        MaximusFileArea             98          NEWOS2FILES
  1255.        MaximusFileArea             99          NEWGENFILES
  1256.        MaximusFileArea             20          OS2UTILS
  1257.        MaximusFileArea             21          OS2GAMES
  1258.        MaximusFileArea             50          OPUSBBSFILES
  1259.        MaximusFileArea            S01          SYSOPFILES
  1260.  
  1261.        You could then choose to announce all those areas to specific message
  1262.        bases in a variety of ways.  For example, if you wanted to publically
  1263.        announce the arrival of files in all the areas above except S01, which
  1264.        should be private to the Sysop only, the following Announcement
  1265.        Definitions could be constructed:
  1266.  
  1267.        MsgAreaName     LOCAL
  1268.        From            Dave Fisher
  1269.        To              All
  1270.        Subj            New files received
  1271.        Attributes      L
  1272.        Announce        NEWOS2FILES NEWGENFILES OS2UTILS OS2GAMES
  1273.        Announce        OPUSBBSFILES
  1274.  
  1275.        MsgAreaName     LOCAL
  1276.        From            Dave Fisher
  1277.        To              Dave Fisher
  1278.        Subj            New private sysop files received
  1279.        Attributes      LP
  1280.        Announce        SYSOPFILES
  1281.  
  1282.  
  1283.        FAN Users Manual                                              Page 29
  1284.        ----------------------------------------------------------------------
  1285.  
  1286.        Using the File Logging Feature
  1287.  
  1288.        FAN can create a log of all files found for announcement.  This log
  1289.        can be used for a variety of purposes.  It can be used as input for
  1290.        virus scanners, download/upload tracking programs, or simply as a
  1291.        historical reference of all files that have been received via TIC or
  1292.        user upload.
  1293.  
  1294.        The format of the log file is user-definable.  The same file macros
  1295.        that are available for announcements are also available here.
  1296.  
  1297.        Please note:  you may find that creating an ASCII formatted
  1298.        announcement area will better suit your needs.  The ASCII format was a
  1299.        later enhancement, and is more flexible than the file logging feature
  1300.        since you can have multiple ASCII formatted announcement areas (and
  1301.        consequently multiple "log" files) and also have the ability to define
  1302.        which file distribution areas will be included or excluded.
  1303.  
  1304.        AnnounceLogFile
  1305.  
  1306.        This keyword defines the actual file name of the log file.  This log
  1307.        file will be appended to each time FAN finds new files to announce.
  1308.  
  1309.        AnnounceLogTemplate
  1310.  
  1311.        This keyword defines the format of each file entry in the
  1312.        'AnnounceLogFile'.  If 'AnnounceLogTemplate' is not defined, the file
  1313.        will be formatted with one entry per line using the following macro
  1314.        format:  "[filename,12]  [filemonth]/[fileday]/[fileyear4]
  1315.        [filesize,RIGHT,7]  [areatagname,10]   [filedesc]".  This macro format
  1316.        will produce a listing of files as follows:
  1317.  
  1318.        FAN_146.ZIP   11/11/1992     150206 SDSMAX    New FAN release!
  1319.  
  1320.        AnnounceLogMonthIndex
  1321.  
  1322.        This keyword indicates which set of month names to use if
  1323.        [filemonthname] is specified in the AnnounceLogTemplate.  If it is not
  1324.        defined, the first set of month names will be used (index 1).
  1325.  
  1326.  
  1327.        FAN Users Manual                                              Page 30
  1328.        ----------------------------------------------------------------------
  1329.  
  1330.        Reading Tick's Configuration File
  1331.  
  1332.        FAN will read Tick's configuration file if you specify the path and
  1333.        name of the file using the keyword 'TickConfigurationFile'.
  1334.  
  1335.        You will want to use this feature only if you are "hatching" files
  1336.        into a file distribution network and want FAN to processes the
  1337.        resulting *.RAD files created by Tick.
  1338.        Bad Tick Files
  1339.  
  1340.        When Tick has trouble with an incoming file (bad CRC, invalid
  1341.        password, etc.), it will rename the *.TIC file to *.BAD.
  1342.  
  1343.        FAN can announce these files using the special TIC file area tag
  1344.        "BAD_TICS".  Simple specify BAD_TICS on the 'Announce' line in your
  1345.        Announcement Definition just as you would any other file area tag
  1346.        name.  Please see the example configuration file, FAN.CFG, for an
  1347.        example.
  1348.  
  1349.        I strongly recommend that Tick first be run in it's "check only" mode.
  1350.        In this mode, Tick will first check all the *.TIC files for valid
  1351.        CRC's, file names, password matches, etc and rename an invalid *.TIC
  1352.        files to *.BAD.  Then, FAN will announce these *.BAD files to you
  1353.        privately while announcing all the good *.TIC files publically.
  1354.        Otherwise, if you only run Tick once, FAN will possibly erroneously
  1355.        announce *.TIC files that are later renamed *.BAD by Tick.
  1356.  
  1357.        To use the "check only" mode, first run Tick with the /OC option on
  1358.        the command line.  Then run Tick again without that option.  See
  1359.        Appendix A for an example using this method.
  1360.  
  1361.        Announcing Locally "Hatched" Files
  1362.  
  1363.        If you enable the RAID keyword in your Tick configuration file, any
  1364.        files hatched from your system can also be announced using FAN.  With
  1365.        this keyword enabled, Tick will create *.RAD files in the Tick Hold
  1366.        directory.
  1367.  
  1368.        FAN will scan the Tick Hold Directory for *.RAD files.  After it reads
  1369.        the *.RAD files, it will delete them to prevent duplicate
  1370.        announcements.
  1371.  
  1372.        'TickConfigurationFile' must be defined in your FAN configuration file
  1373.        in order to process *.RAD files.
  1374.        Using SEAL's FileDesc Statement
  1375.  
  1376.        SEAL, an excellent echo/file remote management program by Robert
  1377.        Presland, supports file area descriptions.  If you use this utility,
  1378.        FAN will automatically read these descriptions from the ;FileDesc
  1379.        statements found in the TICK configuration file.  These descriptions
  1380.        are accessed using the [fileareadesc] token.
  1381.  
  1382.  
  1383.        FAN Users Manual                                              Page 31
  1384.        ----------------------------------------------------------------------
  1385.  
  1386.        Unresolved (Unresolvable?) Bugs
  1387.  
  1388.        The following bugs have been reported and are unresolved.  If you have
  1389.        any information that would be helpful in determining a solution to the
  1390.        following problem reports, please netmail me at any of the addresses
  1391.        listed at the top of this document.  Any help would be much
  1392.        appreciated!
  1393.  
  1394.        Using FAN with ZMail under DOS
  1395.  
  1396.        One beta tester using ZMail noticed that ZMail would report the error
  1397.        "Short Packet" when processing the mail packets (*.PKT files) created
  1398.        by FAN.  It would appear that this is a warning message only since
  1399.        ZMail then proceeded to process the packet and distribute the mail
  1400.        correctly.
  1401.  
  1402.        I have been unable to determine exactly what ZMail means by "Short
  1403.        Packet".
  1404.  
  1405.        Using FAN with AutoBoot 2.00 and Opus under DOS
  1406.  
  1407.        One beta tester noticed an odd memory corruption problem using FAN
  1408.        with AutoBoot and Opus.  After running FAN he tried to compile his
  1409.        Opus control (*.CTL) files.  The compiler would insert "garbaged"
  1410.        lines after some of his AREA statements.  If he first removed AutoBoot
  1411.        from his AUTOEXEC.BAT and rebooted, then everything worked normally.
  1412.        He could run FAN and the Opus compiler without errors.  Once he
  1413.        installed AutoBoot and ran FAN again, the errors returned.
  1414.  
  1415.        He is running the BBS on a 386 with 2MB RAM and QEMM memory manager.
  1416.  
  1417.  
  1418.        FAN Users Manual                                              Page 32
  1419.        ----------------------------------------------------------------------
  1420.  
  1421.        Future Possible Features/Enhancements
  1422.  
  1423.        + New configuration file keyword:  CatagoryCode
  1424.  
  1425.             Create a new token [catcode] which will expand to the catagory
  1426.             code for a particular file area.  For example:
  1427.  
  1428.             CatagoryCode       FTSC      001
  1429.             CatagoryCode       SDS-BBS   002
  1430.             CatagoryCode       SDSADMIN  003
  1431.             CatagoryCode       SDSBINK   004
  1432.             CatagoryCode       SDSMAX    005
  1433.             CatagoryCode       SDSRBBS   006
  1434.             CatagoryCode       SOFTDIST  007
  1435.  
  1436.             Thus, if a file was being announced from any of those areas,
  1437.             [catcode] would expand to the catagory code associated with
  1438.             appropriate area.
  1439.  
  1440.        + Multiple origin lines
  1441.  
  1442.             Add the ability to define multiple origin lines which can then
  1443.             be specified as an "index" in various announce areas, much as
  1444.             the Months keyword is used.  Thus, origin lines can be in
  1445.             different languages or have different "flavors".  For example,
  1446.             instead of:
  1447.  
  1448.        OriginLine   LiveNet!  Tulsa's OS/2 Warehouse.  918-481-5715
  1449.  
  1450.             you might have several different origin lines:
  1451.  
  1452.        OriginLine 1  LiveNet!  Tulsa's OS/2 Warehouse.  918-481-5715
  1453.        OriginLine 2  LiveNet!  South US ibmNET Host.  918-481-5715
  1454.        OriginLine 3  LiveNet!  An OS/2 dedicated system.  918-481-5715
  1455.  
  1456.             These origin lines can then be referenced in an Announcement
  1457.             Definition using the keyword OriginLineIndex.
  1458.  
  1459.        + Support to scan RA's new FILE database format
  1460.  
  1461.             Currently, FAN only processed *.TIC or FILES.BBS formatted
  1462.             files.  A future enhancement will be to also be able to read
  1463.             RA's 2.xx FILE database format.
  1464.  
  1465.  
  1466.        FAN Users Manual                                              Page 33
  1467.        ----------------------------------------------------------------------
  1468.  
  1469.        Appendix A - Example REXX procedure calling FAN
  1470.  
  1471.        /*------------------------------------------------------------*
  1472.         * TICK.CMD                                                   *
  1473.         *                                                            *
  1474.         * Rexx procedure to process *.TIC files                      *
  1475.         *------------------------------------------------------------*/
  1476.  
  1477.        echo off
  1478.  
  1479.        cls
  1480.  
  1481.        isfile "c:\binkley\inbound\*.tic"
  1482.  
  1483.        if ( rc <= 0 ) then
  1484.            return              /* No *.TIC files received */
  1485.  
  1486.        call bbslog "Tick", "Initiating TICK"
  1487.  
  1488.        /*
  1489.         * Run TICK in "check only" mode so that any bad *.TIC files are
  1490.         * renamed to *.BAD.  These files will then not be erroneously
  1491.         * announced using FAN later.
  1492.         */
  1493.  
  1494.        "c:"
  1495.  
  1496.        cd "\bbs\tick"
  1497.  
  1498.        TICP "/OC >> c:\bbs\logs\tick.log"
  1499.  
  1500.        if rc <> 0 then
  1501.            do
  1502.            call bbslog "Tick", "ERROR ", rc, " returned from TICK /OC"
  1503.            return
  1504.            end
  1505.  
  1506.        /*
  1507.         * Set the archive dates to the "True" archive date.
  1508.         */
  1509.  
  1510.        truedate "c:\binkley\inbound\* /Quiet"
  1511.  
  1512.        /*
  1513.         * Call FAN (File Announcement Utility) to send out announcement
  1514.         * messages.
  1515.         */
  1516.  
  1517.        "c:"
  1518.  
  1519.        cd "\bbs\fan"
  1520.  
  1521.        fan "/tosslog = c:\bbs\fan\fantoss.log"
  1522.  
  1523.        /*
  1524.         * Scan and Toss the newly created messages from FAN
  1525.         */
  1526.  
  1527.  
  1528.        FAN Users Manual                                              Page 34
  1529.        ----------------------------------------------------------------------
  1530.  
  1531.        "c:"
  1532.        cd "\bbs\squish"
  1533.  
  1534.        squish "IN OUT SQUASH -fc:\bbs\fan\fantoss.log"
  1535.  
  1536.        del "c:\bbs\fan\fantoss.log > nul: 2>&1"
  1537.  
  1538.        /*
  1539.         * Now call TICK to do the actual distribution
  1540.         */
  1541.  
  1542.        "c:"
  1543.  
  1544.        cd "\bbs\tick"
  1545.  
  1546.        TICP ">> c:\bbs\logs\tick.log"
  1547.  
  1548.        if rc <> 0 then
  1549.            do
  1550.            call bbslog "Tick", "ERROR ", rc, " returned from TICK"
  1551.            return
  1552.            end
  1553.  
  1554.        /*
  1555.         * Update Maximus's global download file database
  1556.         */
  1557.  
  1558.        "c:"
  1559.        cd "\bbs\max\system"
  1560.  
  1561.        fb
  1562.  
  1563.        call bbslog "Tick", "Completed TICK"
  1564.  
  1565.        exit
  1566.  
  1567.  
  1568.        FAN Users Manual                                              Page 35
  1569.        ----------------------------------------------------------------------
  1570.  
  1571.  
  1572.        Appendix B - Example DOS procedures calling FAN
  1573.  
  1574.             This is an example DOS batch file contributed by
  1575.             Raymond Beriau (1:242/90) meant to execute after your
  1576.             mailer recieves mail.
  1577.  
  1578.        echo Checking to see if there are .TIC files
  1579.        if exist c:\netfile\*.tic goto tick_ok
  1580.        if not exist c:\netfile\*.fle goto exit
  1581.  
  1582.        :tick_ok
  1583.        for %%d in (d: cd\max\tick) do %%d
  1584.        logentry TICK Checking Received Files... >> d:\bink\bink.log
  1585.        tick /ctic.cfg /oc >> d:\max\tickdir\tick.log
  1586.  
  1587.        :fan_fido
  1588.        logentry FAN  Creating File Announcements... >> d:\bink\bink.log
  1589.        fan /Config=fan.cfg /Quiet /TossLogFile=echotoss.log
  1590.  
  1591.        :tick
  1592.        logentry TICK Processing Received Files... >> d:\bink\bink.log
  1593.        tick /ctic.cfg >> d:\max\tickdir\tick.log
  1594.  
  1595.        :squish
  1596.        cd\max
  1597.        logentry TICK SQUISH Processing >> d:\bink\bink.log
  1598.        squish out squash -csquish.cfg -aareas.bbs -fechotoss.log
  1599.        if exist echotoss.log del echotoss.log
  1600.  
  1601.        :update
  1602.        logentry TICK Updating Maximus FileList... >> d:\bink\bink.log
  1603.        fb d:\max\area.dat
  1604.        x_list xlist.ctl
  1605.  
  1606.        :exit
  1607.        quit
  1608.  
  1609.  
  1610.        FAN Users Manual                                              Page 36
  1611.        ----------------------------------------------------------------------
  1612.  
  1613.             Another DOS batch file example executed after your
  1614.             mailer recieves mail.
  1615.  
  1616.        Rem     FAN Processing Following *.Tic File Arrivals
  1617.  
  1618.        :TOSS_IN
  1619.  
  1620.        Rem     Are There *.Tic Files?
  1621.  
  1622.         If Not Exist c:\In\*.Tic GoTo Mail
  1623.  
  1624.        Cd\Files
  1625.  
  1626.        Rem      Cyclical Redundancy Check (CRC) of file integrity, measured
  1627.        Rem      against CRC values listed in accompanying *.Tic files,
  1628.        Rem      renaming *.Tic to *.Bad if CRCs don't match.
  1629.  
  1630.            Tick /cC:\Cfg\Tic.cfg /oc >> D:\Bink\System.Log
  1631.  
  1632.        Rem      FAN Command Line
  1633.  
  1634.            Fan.Exe  /Conf=C:\Cfg\Fan.Cfg /Quiet
  1635.                       /TossLogFile=C:\Bink\EchoToss.Log
  1636.  
  1637.        Rem      TICK File Processing Command Line
  1638.  
  1639.            Tick /cC:\Cfg\Tic.Cfg
  1640.  
  1641.        Rem      Update Maximus FileList Database
  1642.  
  1643.            If NOT Errorlevel 1 Fb.Exe D:\Max\Area.Dat X_list Xlist.Ctl
  1644.  
  1645.        Rem      Turn Off Files.Bbs Archive Bit
  1646.  
  1647.            C:\Dos\Attrib -a D:\New\Files.bbs
  1648.  
  1649.        :MAIL
  1650.        CD\In
  1651.           For %%a In (mo tu we th fr sa su pk) Do If Exist *.%%a* GoTo UNPACK
  1652.  
  1653.        GoTo MAILER
  1654.  
  1655.        :UNPACK
  1656.        Rem      Toss & Link Inbound EchoMail, Net Mail Packing & Routing...
  1657.  
  1658.        Cd\Bink
  1659.  
  1660.        Squish In Squash Link -cc:\Cfg\Squish.Cfg -aC:\Cfg\Areas.Bbs
  1661.                              -fEchoToss.Log
  1662.        If Exist EchoToss.Log Del EchoToss.Log
  1663.  
  1664.        :EXIT
  1665.  
  1666.        GoTo MAILER
  1667.  
  1668.  
  1669.        FAN Users Manual                                              Page 37
  1670.        ----------------------------------------------------------------------
  1671.  
  1672.             A DOS batch file example to detect and announce new BBS
  1673.             uploads at logoff.
  1674.  
  1675.        Rem    The following TARGET and 4DOS command lines represent two
  1676.        Rem    ways to accomplish the same thing: execute a DOS command
  1677.        Rem    only if a check of specified Files.Bbs files reveals an
  1678.        Rem    archive bit turned off (-A). If the archive bit is on (+A),
  1679.        Rem    meaning no uploads recently modified the Files.Bbs, FAN
  1680.        Rem    doesn't waste its time thrashing disk for nothing.
  1681.  
  1682.        C:\Util\Target d:\new\files.bbs -z -c"GoTo FAN"
  1683.  
  1684.        Rem    -=-=-=-=-=-=-=-=-=-
  1685.        Rem    TARGET15.LZH   73907 07-21-92  File Locator & Manipulator.
  1686.                                              Target 1.5 (C) 1992, by McAfee
  1687.        Rem    -=-=-=-=-=-=-=-=-=-
  1688.        Rem    Opps, TARGET came up empty.
  1689.  
  1690.        GoTo MAIL_OUT
  1691.  
  1692.        If %@ATTRIB[d:\new\files.bbs,N] == 1 GoTo MAIL_OUT
  1693.  
  1694.        Rem      -=-=-=-=-=-=-=-=-=-
  1695.        Rem      4DOS401P.ARJ  263649 06-14-92  DOS Command.Com replacement.
  1696.        Rem                                     Program Executables &
  1697.        Rem                                     Support Files. 4DOS v4.01
  1698.        Rem                                     (C) 1988-1992, JP Software Inc.
  1699.  
  1700.        :FAN
  1701.        Rem      -=-=-=-=-=-=-=-=-=-
  1702.        Rem      FAN Command Line
  1703.        Rem      -=-=-=-=-=-=-=-=-=-
  1704.  
  1705.        Fan.Exe  /Conf=C:\Cfg\Fan.Cfg /Quiet
  1706.                   /TossLogFile=C:\Bink\EchoToss.Log
  1707.  
  1708.        Rem      Turn off Files.Bbs Archive Bit
  1709.  
  1710.        C:\Dos\Attrib -a d:\new\files.bbs
  1711.  
  1712.        :MAIL_OUT
  1713.  
  1714.        Squish Out Squash Link -cc:\Cfg\Squish.Cfg -aC:\Cfg\Areas.Bbs
  1715.                               -fEchoToss.Log
  1716.  
  1717.        If Exist EchoToss.Log Del EchoToss.Log
  1718.  
  1719.  
  1720.        FAN Users Manual                                              Page 38
  1721.        ----------------------------------------------------------------------
  1722.  
  1723.        Appendix C - Examples that place BBS caller information in DOS Environment
  1724.        Variables
  1725.  
  1726.        The following example was written with RemoteAccess v1.11 in mind but
  1727.        should work as well for any QuickBbs system or one of its clones.
  1728.  
  1729.        Hitting the [U]pload prompt should execute a (Type 12) questionnaire that
  1730.        looks something like this:
  1731.  
  1732.        ---------------------------| Begin Example |----------------------------
  1733.  
  1734.        ClearScreen
  1735.        ChangeColor 14 0
  1736.        Display "Please describe what you're sending.|"
  1737.        Display "       We haven't a clue.|"
  1738.        Display " Make it as detailed as you like.||"
  1739.        ;
  1740.        ;  Two choices here, each accomplish more or less the same thing:
  1741.        ;
  1742.        MenuCmnd 7 C:\COMMAND.COM /C Echo Set WHOUP=*F *L>C:\Qbbs\WhoUp.Bat
  1743.        ;
  1744.        ;                -   OR   -
  1745.        ;
  1746.        MenuCmnd 7 *SWhoUp.Bat
  1747.        ;
  1748.        ; This command looks in RA's system directory for the file called
  1749.        ; WHOUP.RAT, expands any 'User Parameter Codes' it finds within
  1750.        ; it and creates WHOUP.BAT in the same directory. My WHOUP.RAT
  1751.        ; file contains 'Full UserName', 'User Location' and 'User
  1752.        ; FirstName' codes and looks like this:
  1753.        ;
  1754.        ; Set whoup=A
  1755.        ; Set loc=B
  1756.        ; Set fn=W
  1757.        ;
  1758.        MenuCmnd 33 D:\New\ /L
  1759.        ;
  1760.        ; The '/L' upload switch above enables long descriptions.
  1761.        ;
  1762.        Quit
  1763.  
  1764.        ----------------------------| End Example |-----------------------------
  1765.  
  1766.        The following commands are executed at BBS logoff:
  1767.  
  1768.        ---------------------------| Begin Example |----------------------------
  1769.  
  1770.        If Exist C:\Qbbs\WhoUp.Bat For %%a In (Call Del) Do %%a C:\Qbbs\WhoUp.Bat
  1771.        Target D:\New\Files.Bbs -z -c"C:\Bink\FAN.Exe /Conf = C:\Cfg\Fan.Cfg"
  1772.        For %%a In (FN LOC WHOUP) Do Set %%a=
  1773.  
  1774.        ----------------------------| End Example |-----------------------------
  1775.  
  1776.        -------------------------| File: PRELOCAL.FAN |-------------------------
  1777.        This just in from %eLOC . . .
  1778.  
  1779.        ------------------------------| End File |------------------------------
  1780.  
  1781.  
  1782.        FAN Users Manual                                              Page 39
  1783.        ----------------------------------------------------------------------
  1784.  
  1785.        -------------------------| File: SUFLOCAL.FAN |-------------------------
  1786.        Total Kilobytes: %QKb
  1787.  
  1788.        (Thanks, %eFN!)
  1789.  
  1790.        ------------------------------| End File |------------------------------
  1791.  
  1792.        ---------------------------| File: FAN.CFG |----------------------------
  1793.  
  1794.        ;
  1795.        ; NetMail announcement area
  1796.        ; -------------------------
  1797.  
  1798.        MsgAreaName     NETMAIL
  1799.  
  1800.        AddressFrom     1:323/109
  1801.        AddressTo       1:323/108
  1802.        From            %eWHOUP
  1803.        To              His Dudeness
  1804.        Subj            Cosmic Debris Landed On The Mudflat
  1805.        Attributes      LPK
  1806.  
  1807.        Announce        MUDFLAT SHESAW Local_Uploads
  1808.  
  1809.        ;
  1810.        ;
  1811.        ; Local Upload announcement area
  1812.        ; ------------------------------
  1813.  
  1814.        MsgAreaName      ARRIVALS
  1815.  
  1816.        PrefixTemplate   C:\Cfg\PreLocal.Fan
  1817.        SuffixTemplate   C:\Cfg\SufLocal.Fan
  1818.        Announce         Local_Uploads
  1819.        From             %eWHOUP
  1820.        To               %eWHOUP
  1821.        Subj             Something I just uploaded...
  1822.  
  1823.        ;
  1824.        ------------------------------| End File |------------------------------
  1825.  
  1826.        Date:   Fri Feb 15 1993  15:42:00
  1827.        From:   Joe Blow
  1828.        To:     Joe Blow
  1829.        Subj:   Something I just uploaded...
  1830.        Attr:
  1831.        New File Arrivals              -------------------------------
  1832.  
  1833.        This just in from Pothole, R.I. . . .
  1834.  
  1835.        TEST            31 05-Feb-93 This is a test. Had it been an actual alert,
  1836.                                     you'd have been notified where to tune in
  1837.                                     your area...
  1838.  
  1839.        Total Kilobytes: 0.0Kb
  1840.  
  1841.        (Thanks, Joe!)
  1842.  
  1843.  
  1844.        FAN Users Manual                                              Page 40
  1845.        ----------------------------------------------------------------------
  1846.  
  1847.  
  1848.        --- FAN 1.63 beta
  1849.         * Origin: MudFlat File Distribution - Looking for a file? Ask! (1:323/109)