home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / s / sfa3b11.zip / SMARTFA.DOC < prev    next >
Text File  |  1993-02-14  |  36KB  |  736 lines

  1. ╓───────────────────────────────────────────────────────────────────╖
  2. ║   SmartFA v3.00ß11         by Bob Butcher         GTPN 050/059    ║
  3. ╙───────────────────────────────────────────────────────────────────╜
  4.  
  5.           SmartFA is Copyright (c) Bob Butcher 1992, 1993
  6.  
  7.                        GT Power Copyright of
  8.                       P & M Software Company,
  9.                        3104 E. Camelback Rd.
  10.                       #503 Phoenix, AZ  85016
  11.                                U.S.A
  12.  
  13.                   ARJ is Copyright Robert K. Jung.
  14.  
  15.            PKZIP and PKUNZIP are Copyright of PKWare Inc.
  16.  
  17.  ┌─────────────────────────────────────────────────────────────────┐
  18.  │                            Disclaimer                           │
  19.  └─────────────────────────────────────────────────────────────────┘
  20.   SmartFA is guaranteed to take up some disk space when not in use
  21.   and to take up some memory and disk space when in use. it may or
  22.   may not release the memory it uses depending on how it feels at
  23.   the time it finished operating. Other than that you are on your
  24.   own, I will not accept any responsibility for anything it may do
  25.   to your hardware, software, financial or mental well being. It
  26.   works here, most of the time <grin>.
  27.  
  28.  ┌─────────────────────────────────────────────────────────────────┐
  29.  │                             Money                               │
  30.  └─────────────────────────────────────────────────────────────────┘
  31.   Strictly speaking it's FREE, OK calm down I know that's the sort
  32.   of price we all like paying for software <grin>.
  33.  
  34.   I don't ask for money for SmartFA neither does it send any
  35.   messages to anyone (except when it is working normally) but if you
  36.   like it and wish to make some contribution then either send a few
  37.   pounds/dollars/yen (or whatever your local currency is) to your
  38.   local mail hub or, if you prefer, send a donation to the following
  39.   address.
  40.  
  41.                           MAKE A KID SMILE
  42.                          c/o Ernest Debakey
  43.                    The Bechtel Tower, Suite 1480
  44.                       3000 Post Oak Boulevard
  45.                        Houston, TX 77056-6582
  46.                                U.S.A.
  47.  
  48.  ┌───────────────────────────────────────────────────────────────────┐
  49.  │                            Purpose                                │
  50.  └───────────────────────────────────────────────────────────────────┘
  51.   SmartFA is designed to remove the need for the GT Power Sysop to
  52.   watch for incoming files and manually forward them to other nodes
  53.   and also to cut out some of the manual tasks of moving incoming
  54.   files into various areas on your GT Power BBS.
  55.  
  56.  ┌───────────────────────────────────────────────────────────────────┐
  57.  │                          How it Works                             │
  58.  └───────────────────────────────────────────────────────────────────┘
  59.   SmartFA works by matching the names of incoming files with entries
  60.   in a control file created by the Sysop. When it finds a match it
  61.   reads the instructions for that file and processes it as
  62.   instructed.
  63.  
  64.  ┌───────────────────────────────────────────────────────────────────┐
  65.  │                          Basic Setup                              │
  66.  └───────────────────────────────────────────────────────────────────┘
  67.   SmartFA should be copied into a directory on you hard disk where
  68.   it can access certain GT Power control files. You must then run
  69.   SmartFA with the command line parameter "setup".
  70.  
  71.     i.e.
  72.                            SmartFA Setup
  73.  
  74.   You will then be asked to answer certain questions, you may either
  75.   press enter to accept the default or type in a new entry.
  76.  
  77.     On what drive do you have your mailout directory?
  78.     Default = C
  79.  
  80.   This is used so SmartFA can locate incoming files, only the drive
  81.   letter is necessary.
  82.  
  83.     Please enter the full path for where you want SmartFA to
  84.     put the files when it moves them?
  85.     Default = C:\MAILOUT\FILEOUT
  86.  
  87.   This is the directory where SmartFA will put any incoming files
  88.   that it finds. This is a default directory, it may be changed for
  89.   each file area. See the Advanced Options section for more details.
  90.   The directory that SmartFA moves files to is known as the "Flip
  91.   directory".
  92.  
  93.     What Netmail area do you want SmartFA to use for outgoing messages?
  94.     Default = C:\MSG\NETMAIL
  95.  
  96.   This is the Netmail area where SmartFA will post File Attach
  97.   messages to other nodes.
  98.  
  99.     What Netmail area do you want SmartFA to check for auto-update
  100.     messages?
  101.     Default = C:\MSG\NETMAIL
  102.  
  103.   One of SmartFA 's functions is to allow systems connecting with
  104.   you to add or remove themselves from file echos. To do this the
  105.   remote node sends your system a netmail message so SmartFA needs
  106.   to know where to look for these messages. Full details of this
  107.   function are given later.
  108.  
  109.     What message area do you want SmartFA to use for messages to Sysop?
  110.     Default = C:\MSG\SYSOP
  111.  
  112.   When SmartFA processes a file it informs the Sysop of what it has
  113.   done in a message posted in this area.
  114.  
  115.     What do you want for the default auto-update password ?
  116.  
  117.   This is the default password used to validate requests from other
  118.   nodes.
  119.  
  120.     Please Enter file path and filename for SmartFA Bulletin.
  121.     Enter a SPACE if you don't want SmartFA to create a Bulletin.
  122.     Default = C:\GT\BBS\SMARTFA.BBS :
  123.  
  124.   SmartFA will optionally create a bulletin listing what files have
  125.   arrived and where they have been put.
  126.  
  127.   Once you have answered these questions SmartFA will create a
  128.   directory off of your GTPATH called SMART in here it will create a
  129.   file called SMART.INI.
  130.  
  131.   The SMART.INI will contain entries that look something like this:
  132.  
  133.          [SMARTFA]
  134.          MAILDRIVE=C
  135.          NETMAILMSG=C:\MSG\NETMAIL
  136.          INNETMAIL=C:\MSG\NETMAIL
  137.          FLIPDIR=C:\MAILOUT\FILEOUT
  138.          SFAPASSWORD=PASSWORD
  139.          SYSOPMSG=D:\MSG\SYSOP
  140.          BULLETINPATH=C:\GT\BBS\SMARTFA.BBS
  141.  
  142.   If you want to manually edit this file, the entries for SmartFA
  143.   may be in any order, so long as they are all there.
  144.  
  145.   Once the SMART.INI file has been created you have to create the
  146.   control file that tells SmartFA what files it should process. This
  147.   file is called SMARTFA.CTL.
  148.  
  149.  ┌───────────────────────────────────────────────────────────────────┐
  150.  │                SMARTFA.CTL, purpose and format                    │
  151.  └───────────────────────────────────────────────────────────────────┘
  152.   The SMARTFA.CTL is the file that controls most of SmartFA 's
  153.   functions, this section describes it's format and some basic
  154.   control entries.
  155.  
  156.   SMARTFA.CTL is a plain ASCII text file, located in the SMART
  157.   directory, with the following format:
  158.  
  159.                     SECTION TITLE
  160.                         Control Instructions
  161.                     END
  162.  
  163.   The Section Title may be up to 8 characters long and must start in
  164.   the first column of the line.
  165.  
  166.   The control instructions are indented by one or more spaces.
  167.  
  168.   The END is a keyword that must appear after the last of the
  169.   control instructions. Like the Section title it must start in the
  170.   first column of the line.
  171.  
  172.   The easiest way to show the basic control instructions is with an
  173.   example. So this is how I would distribute the GT Echolist file.
  174.  
  175.   First I would set up a section title for the GT Echolist
  176.   distribution
  177.  
  178.   i.e.
  179.                         GTEL
  180.  
  181.   Now I want to set up the people I am going to send the file to,
  182.  
  183.                         GTEL
  184.                             013/000 Oliver Bell
  185.                             013/100 John Whitney
  186.                             050/039 Dave Liquorice
  187.                         END
  188.  
  189.   This would send any incoming file that matched the file
  190.   specification GTEL*.* to the people at the nodes listed.
  191.  
  192.   With the entry set up as shown SmartFA will use the words "Auto
  193.   Distribute File" as a message title, I would really rather have
  194.   the title a little bit more descriptive. To do this I would modify
  195.   the entry like this:
  196.  
  197.                         GTEL
  198.                             MT=GT Echolist Files
  199.                             013/000 Oliver Bell
  200.                             013/100 John Whitney
  201.                             050/039 Dave Liquorice
  202.                         END
  203.  
  204.   The MT= line gives the Message Title. The message title may be up
  205.   to 30 characters long.
  206.  
  207.   If you want SmartFA to put files into a directory other than the
  208.   one you specified during the setup you can add a line to the
  209.   SmartFA.CTL to do just that. Using the previous example I now want
  210.   to put the GTEL files into a directory called C:\GTLISTS rather
  211.   than the default "flip directory" I would add a line starting with
  212.   "FD=".
  213.  
  214.                         GTEL
  215.                             FD=C:\GTLISTS
  216.                             MT=GT Echolist Files
  217.                             013/000 Oliver Bell
  218.                             013/100 John Whitney
  219.                             050/039 Dave Liquorice
  220.                         END
  221.  
  222.   The FD= is used to identify the alternative Flip Directory.
  223.  
  224.   A full list of options for the SmartFA.CTL file can be found in
  225.   Appendix A.
  226.  
  227.  ┌───────────────────────────────────────────────────────────────────┐
  228.  │                            Message Text                           │
  229.  └───────────────────────────────────────────────────────────────────┘
  230.  
  231.   You have probably seen files that have been sent out by SmartFA
  232.   appear with "banner screens". These screens are held in files in
  233.   the SMART directory and have the extension MSG. The name of the
  234.   message file must match the distribution entry in the SmartFA.CTL.
  235.  
  236.   For example:
  237.  
  238.   The message file for the GTEL distribution would be called
  239.   GTEL.MSG for SFA it would be SFA.MSG.
  240.  
  241.   The other way to provide custom messages is for the originating
  242.   system to send out two files, one being the archive the second
  243.   being the message file. This option is a bit complicated to
  244.   explain so this is how it works:
  245.  
  246.     If I sent out a file called SFA0101.ARJ and with it a file
  247.     called SFA0101.MES, when the files reach the next system SmartFA
  248.     will find the MES file first it will then set an internal flag
  249.     and copy the MES file to the SMART directory.
  250.  
  251.     SmartFA will then find and process the ARJ and MES files as
  252.     normal. If there are any systems to send the file to SmartFA
  253.     will use the text from the MES file for the message. After the
  254.     last file has been sent out the MES file in the SMART directory
  255.     will be deleted.
  256.  
  257.   Well I hope that explains it.
  258.  
  259.  ┌───────────────────────────────────────────────────────────────────┐
  260.  │                         FILES.BBS entries.                        │
  261.  └───────────────────────────────────────────────────────────────────┘
  262.  
  263.   After moving the files to the "flip directory" SmartFA will open
  264.   the FILES.BBS and add an entry containing the following
  265.   information:
  266.  
  267.   File Name  File Size  System Date  File Date  File Description.
  268.  
  269.   The file description used can come from a number of places:
  270.  
  271.     1. The coded default of Auto Distribute File.
  272.     2. The MT= line from the SmartFA.CTL file.
  273.     3. The DE= line from the SmartFA.CTL file (for a description of
  274.        the DE= line see Appendix A).
  275.  
  276.  ┌───────────────────────────────────────────────────────────────────┐
  277.  │                         File Descriptions                         │
  278.  └───────────────────────────────────────────────────────────────────┘
  279.  
  280.   This has taken a bit of work and there may be some changes yet.
  281.   The idea is to allow software authors to provide a file
  282.   description when they distribute a file. This is how it is done:
  283.  
  284.   The Utility writer has a file echo set up, when they send out a
  285.   new utility they make a "Distribution Archive". This File is
  286.   contains whatever program archives they are sending out with
  287.   corresponding DIZ files.
  288.  
  289.   A DIZ file is a plain ASCII file containing a the file description
  290.   for the file that is being sent out.
  291.  
  292.   The DIZ file should have the same name as the file it accompanies
  293.   but an extension of DIZ.
  294.  
  295.   The file can be any length but try and keep it to about 72
  296.   characters per line.
  297.  
  298.   Here's an example:
  299.  
  300.   I send out a file called SFA0101.ARJ inside that file I have the
  301.   latest versions of SmartFA and SmartMSG for this example we'll
  302.   call them SFA301.ARJ and SMSG101.ARJ. Also in the distribution
  303.   archive I have files called SFA301.DIZ and SMSG101.DIZ.
  304.  
  305.   When the SFA0101.ARJ is received on a system that has SmartFA's
  306.   unpack option set the following will happen:
  307.  
  308.         1. The distribution archive will be unpacked into the
  309.            destination directory specified in the SmartFA.CTL file.
  310.  
  311.         2. SmartFA will then check the destination directory for the
  312.            existence of any DIZ files. If it finds one it will mach
  313.            the name of the DIZ file with the name of the archive and
  314.            build a FILES.BBS entry as follows.
  315.  
  316.           File Name  File Size  System Date  File Date
  317.            | Text
  318.            | Text
  319.            | Text
  320.  
  321.         The "Text" will come from the DIZ file.
  322.  
  323.  
  324.  ┌───────────────────────────────────────────────────────────────────┐
  325.  │                            Batch Files                            │
  326.  └───────────────────────────────────────────────────────────────────┘
  327.  
  328.   To allow a little flexibility for the Sysop SmartFA will look for
  329.   a DOS BATCH file in the SMART directory that corresponds to the
  330.   name of the section it has processed. If one is found SmartFA will
  331.   run it after it has finished it's other functions.
  332.  
  333.         Two parameters are passed to each batch file run.
  334.  
  335.             %1  =  Name of the flip directory.
  336.             %2  =  Name of the file that just got flipped.
  337.  
  338.  ┌───────────────────────────────────────────────────────────────────┐
  339.  │                           Bulletin File                           │
  340.  └───────────────────────────────────────────────────────────────────┘
  341.   
  342.   If you chose a Bulletin Path during the setup SmartFA will have
  343.   created a file with a header like this:
  344.  
  345. ┌──────────────┬──────────────┬──────────────────────────────────────────┐
  346. │ Arrival Date │  File  Name  │ File Area                                │
  347. ├──────────────┼──────────────┼──────────────────────────────────────────┤
  348.  
  349.   When a file is processed by SmartFA it will add lines to the
  350.   bulletin file. The File Area name is read from the GTDIR.BBS file.
  351.   The entries look something like this:
  352.  
  353. │  01/05/1993  │ WIN19506.ARJ │ Windows Utilities File Echo.             │
  354.  
  355.   The date shown is in USA Month/Day/Year format, this will change
  356.   as soon as I figure out how to use the DOS country information.
  357.  
  358.   If you don't want SmartFA to update the bulletin for a particular
  359.   run you can use the command line parameter "NB" (No Bulletin).
  360.  
  361.   If you don't want a particular file distribution listed in the
  362.   bulletin you can add the entry NB=TRUE to that particular
  363.   distribution section in the SmartFA.CTL.
  364.  
  365.   If at any time you want to stop the bulletin from being created by
  366.   SmartFA simply edit the SMART.INI and remove the path to the
  367.   bulletin file. Your SMART.INI entry would then look like this:
  368.  
  369.                              BULLETINPATH=
  370.  
  371.  ┌───────────────────────────────────────────────────────────────────┐
  372.  │          Auto Updates (SmartFA's GM, GQ and GL Functions).        │
  373.  └───────────────────────────────────────────────────────────────────┘
  374.  
  375.   SmartFA will allow authorised Sysops that connect with your system
  376.   to add or remove themselves from the file echos you carry. To
  377.   perform this sort of operation the remote sysop has to send a
  378.   message to your system in much the same way as they would normally
  379.   GM and GQ normal echos.
  380.  
  381.   The message must be addressed to SmartFA, and the password should
  382.   be in the subject field. The text of the message then consists of
  383.   the add and remove commands, here's an example of the message
  384.   text:
  385.  
  386.   + GTEL             <-- Add me to GTEL DST
  387.   + VSHLD            <-- Add me to VSHLD DST
  388.   - TEST             <-- Remove me from TEST DST
  389.   - GTNL             <-- Remove me from GTNL DST
  390.   GL                 <-- Request a GL report from SmartFA
  391.  
  392.         ╒════════════════════════════════════════╕
  393.         │              PLEASE NOTE               │
  394.         ╞════════════════════════════════════════╡
  395.         │ 1. All entries must start in column 1. │
  396.         │ 2. There is no "." before the GL.      │
  397.         ╘════════════════════════════════════════╛
  398.  
  399.   After any add or remove function SmartFA will automatically send a
  400.   GL report so the last line is not really necessary.
  401.  
  402.  ┌───────────────────────────────────────────────────────────────────┐
  403.  │                        Auto Update Security                       │
  404.  └───────────────────────────────────────────────────────────────────┘
  405.  
  406.   There are three levels of security for SmartFA's auto update
  407.   functions. The first level is the default password stored in the
  408.   SMART.INI.
  409.  
  410.   The second level is provided by an optional file that resides in
  411.   the SMART directory called SMARTFA.PWD, this is a plain ASCII file
  412.   with each line in the following format:
  413.  
  414.                      nnn/nnn password
  415.  
  416.   Using this file you would set a password for each node that you
  417.   want to give auto-update rights. Here's the file I set up for a
  418.   test:
  419.  
  420.                       099/999 gobble
  421.                       001/007 Houston
  422.                       001/078 telepathy
  423.  
  424.   The first section is the net/node, the second is the password for
  425.   that node. Each line starts in the first column.
  426.  
  427.   If a node is listed in this file then it can not use the default
  428.   password. You can also use this file to stop a system that does
  429.   not connect with you from requesting files by adding their
  430.   net/node number and a password to this file.
  431.  
  432.   The third level involves a password for individual sections within
  433.   the SMARTFA.CTL file, this is know as "Section Passwords".
  434.  
  435.   If the Section Password is used by your hub to add yourself to the
  436.   distribution you must use the following format on the update
  437.   line:-
  438.  
  439.   + DST_NAME PASSWORD
  440.  
  441.   so if my hub had a DST called XXBETA with a password of authorize
  442.   I would use the line:
  443.  
  444.   + XXBETA authorize
  445.  
  446.   to add myself to the distribution.
  447.  
  448.  ┌───────────────────────────────────────────────────────────────────┐
  449.  │                      Duplicate File Checking                      │
  450.  └───────────────────────────────────────────────────────────────────┘
  451.  
  452.   By default SmartFa will try and stop duplicate files being sent
  453.   out from your system. It does this by keeping a log file (called
  454.   SMARTFA.LOG) in the SMART subdirectory.
  455.  
  456.   This file is a plain ascii file and keeps a record of the name
  457.   size and date of each file that goes through your system. If you
  458.   want you can disable the duplicate checking completely by using a
  459.   command line option as shown below.
  460.  
  461.                               SMARTFA NDD
  462.  
  463.   My advise it to use this option with care, or else you could
  464.   become very unpopular <grin>. If the NDD parameter is not used
  465.   duplicate files will be moved to the \MAILIN\PROBLEMS directory
  466.   and a message will be sent to let you know one has arrived.
  467.  
  468.  ┌───────────────────────────────────────────────────────────────────┐
  469.  │                     Alternate Source Directory                    │
  470.  └───────────────────────────────────────────────────────────────────┘
  471.  
  472.   By default SmartFA looks for files in the GT MAILIN\FILEIN
  473.   directory but you can specify an alternate directory by using the
  474.   command line parameter "SD=".
  475.  
  476.   For Example:
  477.  
  478.                      SmartFA SD=C:\NEW_SMART
  479.  
  480.   This would tell Smartfa to look for files in the C:\NEW_SMART
  481.   directory instead of \MAILIN\FILEIN.
  482.  
  483.   If any files are found they will be processed as normal. I use
  484.   this option to save myself from having to copy the files I want to
  485.   send out to the FILEIN directory.
  486.  
  487.  
  488.  ┌───────────────────────────────────────────────────────────────────┐
  489.  │                      SMARTFA.CTL Maintenance                      │
  490.  └───────────────────────────────────────────────────────────────────┘
  491.  
  492.   If you start SmartFA with the command line parameter SORT it will
  493.   sort your SMARTFA.CTL file in the following order.
  494.  
  495.         Section Headers in alphabetical order.
  496.         SmartFA Controls entries (MT=, DE= etc) in alphabetical order.
  497.         Subscribing nodes in ascending order.
  498.         Comment lines.
  499.  
  500.   For Example:
  501.  
  502.         If you current SmartFA.CTL contained the entries:
  503.  
  504.                 GTNL
  505.                     MT=GT Network Nodelist
  506.                     FD=C:\LISTS
  507.                     050/059 Bob Butcher
  508.                     013/000 Oliver Bell
  509.                 END
  510.                 GTEL
  511.                     MT=GT Network Echolist
  512.                     FD=C:\LISTS
  513.                     050/059 Bob Butcher
  514.                     013/000 Oliver Bell
  515.                 END
  516.  
  517.         after running SmartFA sort the result would be:
  518.  
  519.                 GTEL
  520.                     FD=C:\LISTS
  521.                     MT=GT Network Echolist
  522.                     013/000 Oliver Bell
  523.                     050/059 Bob Butcher
  524.                 END
  525.                 GTNL
  526.                     FD=C:\LISTS
  527.                     MT=GT Network Nodelist
  528.                     013/000 Oliver Bell
  529.                     050/059 Bob Butcher
  530.                 END
  531.  
  532.   N.B. SmartFA doesn't mind what order the SmartFA.CTL file is in,
  533.        this option is to ease any manual maintenance that needs to
  534.        be done.
  535.  
  536.        Before SmartFA begins the sort it will save the old
  537.        SmartFA.CTL file as SmartFA.BAK.
  538.  
  539.        Due to the way the sort routines I'm using work comment lines
  540.        will be put at the end of each section.
  541.  
  542.  ┌───────────────────────────────────────────────────────────────────┐
  543.  │                            Global Send                            │
  544.  └───────────────────────────────────────────────────────────────────┘
  545.  
  546.   If you use the word GLOBAL on SmartFa's command line it will
  547.   process the incoming file area normally and then send EVERY FILE
  548.   in the incoming directory to the people listed under the GLOBAL
  549.   section of the SMARTFA.CTL file.
  550.  
  551.   Be careful how you use this option <grin>.
  552.  
  553.  ┌───────────────────────────────────────────────────────────────────┐
  554.  │                        Environment Variable                       │
  555.  └───────────────────────────────────────────────────────────────────┘
  556.  
  557.   SmartFA will check for an environment variable called SMART. If
  558.   found SmartFA will use the directory specified instead of the
  559.   GTPATH to look for the SMART directory.
  560.  
  561.   An example, if I set the following:
  562.  
  563.                            set smart=c:\work
  564.  
  565.   Smartfa would look for c:\work\smart and check there for the
  566.   SMART.INI, SMARTFA.CTL and it's other files. This is intended for
  567.   those people who use multi-node systems.
  568.  
  569.  
  570. Appendix A.                 SmartFA.CTL control line options.
  571. ┌────────┬─────────────────────────────────────────────────────────────────┐
  572. │ Option │ Description                                                     │
  573. ├────────┼─────────────────────────────────────────────────────────────────┤
  574. │ ;      │ is used to tell the program that anything following the         │
  575. │        │ semi-colon is a comment and deserves no processing.             │
  576. ├────────┼─────────────────────────────────────────────────────────────────┤
  577. │ DE=    │ if you want a longer FILES.BBS description than allowed for     │
  578. │        │ the message title use this option. (150 characters is about     │
  579. │        │ the maximum for this line).                                     │
  580. │        │                                                                 │
  581. │        │ Please note this entry will go into the FILES.BBS as one long   │
  582. │        │ line you will need to use another utility to format it.         │
  583. ├────────┼─────────────────────────────────────────────────────────────────┤
  584. │ DF=    │ This is the delete flag. If set to TRUE any old files matching  │
  585. │        │ the section title that are currently in the flip directory      │
  586. │        │ will be deleted.                                                │
  587. │        │                                                                 │
  588. │        │ SmartFA will only delete old files once for each section each   │
  589. │        │ time it is run so if you receive multiple files they will be    │
  590. │        │ processed correctly.                                            │
  591. ├────────┼─────────────────────────────────────────────────────────────────┤
  592. │ DX=    │ This is a TRUE/FALSE flag. If it is set to true SmartFA will    │
  593. │        │ add a .DX to the end of the netmail message. The DX will mean   │
  594. │        │ that any node that is getting files from you must be a direct   │
  595. │        │ connect.                                                        │
  596. ├────────┼─────────────────────────────────────────────────────────────────┤
  597. │ FD=    │ is used to specify an alternative flip directory (where         │
  598. │        │ SmartFa will put the incoming file). By default SmartFA will    │
  599. │        │ use the directory specified in the SMART.INI file.              │
  600. ├────────┼─────────────────────────────────────────────────────────────────┤
  601. │ FR=    │ This option allows SmartFA to send a .FR message to a certain   │
  602. │        │ node on a certain day. This option will only work when SmartFA  │
  603. │        │ is run with the command line parameter FR.                      │
  604. │        │                                                                 │
  605. │        │ Example:                                                        │
  606. │        │                                                                 │
  607. │        │       GTEL                                                      │
  608. │        │          FR=Mon,032/001                                         │
  609. │        │       END                                                       │
  610. │        │                                                                 │
  611. │        │ If today is Monday and I have started SmartFA with the command  │
  612. │        │ line parameter FR SmartFa will send a message to 032/001 with   │
  613. │        │ the following line:                                             │
  614. │        │                                                                 │
  615. │        │          .FR GTEL*.*                                            │
  616. │        │                                                                 │
  617. │        │ Another Example:                                                │
  618. │        │                                                                 │
  619. │        │       GTEL                                                      │
  620. │        │          FR=10,032/001                                          │
  621. │        │       END                                                       │
  622. │        │                                                                 │
  623. │        │ In this case SmartFA would send out the message if today was    │
  624. │        │ the 10th.                                                       │
  625. ├────────┼─────────────────────────────────────────────────────────────────┤
  626. │ MT=    │ is used as the message title and the default FILES.BBS entry.   │
  627. │        │ This Entry is also used by early versions of SmartGL2 to give   │
  628. │        │ the description for the file echo. It is also used by SmartFA   │
  629. │        │ for it's GL report.                                             │
  630. │        │                                                                 │
  631. │        │ Please note that the GT Message title is limited to 30          │
  632. │        │ characters, if your MT= entry is longer than 30 characters it   │
  633. │        │ will be shortened.                                              │
  634. │        │                                                                 │
  635. │        │ If the line does not exist SmartFA will use "Auto Distribute    │
  636. │        │ File" as a default title.                                       │
  637. ├────────┼─────────────────────────────────────────────────────────────────┤
  638. │ NB=    │ If set to TRUE SmartFA will not include this file in the        │
  639. │        │ incoming files bulletin.                                        │
  640. ├────────┼─────────────────────────────────────────────────────────────────┤
  641. │ NG=    │ This can be set to TRUE or FALSE, if set to TRUE this file      │
  642. │        │ echo will NOT be listed in a SmartGL2 GL report.                │
  643. ├────────┼─────────────────────────────────────────────────────────────────┤
  644. │ PD=    │ A TRUE or FALSE flag to tell SmartFA to process or ignore a     │
  645. │        │ DIZ file that may be in the distribution archive.               │
  646. ├────────┼─────────────────────────────────────────────────────────────────┤
  647. │ PS=    │ This is another TRUE or FALSE flag. If set to anything it will  │
  648. │        │ stop SmartFA from sending out files that are associated with    │
  649. │        │ the particular DST section unless you also have the command     │
  650. │        │ line parameter PS set.                                          │
  651. │        │                                                                 │
  652. │        │ This may sound rather perverse for a program that is meant to   │
  653. │        │ send out files but if used it will prevent files being sent     │
  654. │        │ out accidentally.                                               │
  655. │        │                                                                 │
  656. │        │ For instance if a file SFABUG.RPT is sent to me at 50/59 I      │
  657. │        │ don't want to distribute it to everyone who gets the            │
  658. │        │ SFAmmdd.xxx distribution files from me.                         │
  659. │        │                                                                 │
  660. │        │ So I have this flag set to true, then if a file is found        │
  661. │        │ SmartFA will move it to the MAILIN\PROBLEMS directory and send  │
  662. │        │ a message to me with the file details.                          │
  663. │        │                                                                 │
  664. │        │ If I wanted to send out a SFAmmdd archive I would run SmartFA   │
  665. │        │ manually and use the command line switch PS to override this    │
  666. │        │ option.                                                         │
  667. ├────────┼─────────────────────────────────────────────────────────────────┤
  668. │ RA=    │ Another True/False option. If set to TRUE SmartFA will call     │
  669. │        │ Robert K. Jung's REARJ.EXE program to convert the incoming      │
  670. │        │ file to ARJ format. The REARJ Command line is:                  │
  671. │        │                                                                 │
  672. │        │               REARJ /a* /d <file name>                          │
  673. │        │                                                                 │
  674. │        │ This will convert the incoming archive and any archives it may  │
  675. │        │ contain to the ARJ format. For this option to work REARJ.EXE    │
  676. │        │ must be somewhere in your path.                                 │
  677. ├────────┼─────────────────────────────────────────────────────────────────┤
  678. │ RD=    │ Run Day, this can be set to a certain day of the week and       │
  679. │        │ SmartFA will only process the incoming if the day it arrives    │
  680. │        │ matches the day specified on this line. The day may be          │
  681. │        │ shortened to three letter for those of you who have as much     │
  682. │        │ trouble with spelling as me <grin>.                             │
  683. │        │                                                                 │
  684. │        │ If the days do not match the file will be ignored.              │
  685. ├────────┼─────────────────────────────────────────────────────────────────┤
  686. │ RR=    │ Add a .RR to the message sent to subscribing systems.           │
  687. ├────────┼─────────────────────────────────────────────────────────────────┤
  688. │ RZ=    │ Another True/False option. If set to TRUE SmartFA will call     │
  689. │        │ Robert K. Jung's REARJ.EXE program to convert the incoming      │
  690. │        │ file to ZIP format. The REARJ Command line is:                  │
  691. │        │                                                                 │
  692. │        │            REARJ /a* /d /tZIP <file name>                       │
  693. │        │                                                                 │
  694. │        │ This will convert the incoming archive and any archives it may  │
  695. │        │ contain to the ZIP format. For this option to work REARJ.EXE    │
  696. │        │ must be somewhere in your path.                                 │
  697. ├────────┼─────────────────────────────────────────────────────────────────┤
  698. │ SP=    │ Section password, this will stop the auto-add feature for a     │
  699. │        │ certain section from working unless the correct password is     │
  700. │        │ used.                                                           │
  701. │        │                                                                 │
  702. │        │ The section password may be up to 12 characters long.           │
  703. ├────────┼─────────────────────────────────────────────────────────────────┤
  704. │ UD=    │ is used to specify a directory where you would like the         │
  705. │        │ incoming archive unpacked to. Please note only ARJ and ZIP      │
  706. │        │ files are automatically unpacked.                               │
  707. │        │                                                                 │
  708. │        │ This option can be used to unpack echolist and nodelist files   │
  709. │        │ automatically for use by the system or may be used to unpack    │
  710. │        │ distribution archives.                                          │
  711. └────────┴─────────────────────────────────────────────────────────────────┘
  712.  
  713. Appendix B.                 SmartFA Command Line Parameters.
  714. ┌────────┬─────────────────────────────────────────────────────────────────┐
  715. │ Option │ Description                                                     │
  716. ├────────┼─────────────────────────────────────────────────────────────────┤
  717. │ DEBUG  │  Gives more info on what SmartFA is trying to do.               │
  718. ├────────┼─────────────────────────────────────────────────────────────────┤
  719. │  FR    │  Check and send out any File Requests. See the FR= entry in     │
  720. │        │  appendix A for more details.                                   │
  721. ├────────┼─────────────────────────────────────────────────────────────────┤
  722. │ GLOBAL │  Send all files in source directory to those sysops             │
  723. │        │  listed under the section GLOBAL in the SmartFA.CTL file.       │
  724. ├────────┼─────────────────────────────────────────────────────────────────┤
  725. │  NDD   │  Don't check for duplicate files.                               │
  726. ├────────┼─────────────────────────────────────────────────────────────────┤
  727. │  PS    │  Process sponsored echos. See the PS= entry in appendix A for   │
  728. │        │  more details.                                                  │
  729. ├────────┼─────────────────────────────────────────────────────────────────┤
  730. │  SD=   │  Used to specify an alternate Source Directory that SmartFA     │
  731. │        │  should scan for incoming files.                                │
  732. ├────────┼─────────────────────────────────────────────────────────────────┤
  733. │ SETUP  │  To create or update SmartFA entries in the SMART.INI file.     │
  734. └────────┴─────────────────────────────────────────────────────────────────┘
  735.  
  736.