home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / TGFAQ_A2.ZIP / ALLTGFAQ.ZIP / ALLTGFAQ.DOC next >
Text File  |  1997-05-03  |  43KB  |  699 lines

  1.  
  2.  
  3.                     ░▒▓█ Allfix Setup for Telegard FAQ █▓▒░
  4.  
  5.   *  FAQ Overview
  6.       
  7.       This document details how to setup Allfix software so it works with
  8.   Telegard.  The primary scope of this document is to help assist on the
  9.   basic setup and processing of allfix.  This document will not go into
  10.   detail on many features of allfix that is left up for the reader to
  11.   investigate by reading allfix.doc or using the online help.
  12.  
  13.   *  Why use Allfix?
  14.       Have you ever been on a bbs and come across a echo that has alot of
  15.   weird looking echomail like the following:
  16.                                 
  17.  --------------------------------------------------------------------------
  18.  Today, Monday 21-04-97, XYZ BBS received the following files.
  19.  
  20.  Area : DFN_RPG         Comment : DFN: Role Playing Games
  21.  -----------------------------------------------------------------------
  22.  AB2V102A.ZIP   447,360    >>---> ARROWBRIDGE II <---<<
  23.                         Arrowbridge II - The Guardians  of
  24.                         Darkness, is a D&D style door.  It
  25.                         has active combat routines, built-
  26.                         in com routines up to 115,000bps &
  27.                         supports multinode systems.
  28.                         ...........and more file description....
  29.  -----------------------------------------------------------------------------
  30.  447,360     bytes in 1   file(s)
  31.  
  32.  Total of 447,360 in 1 file(s)
  33.  
  34.  File requests are welcome 23 hrs per day, not during Zone Mail Hour
  35.  
  36.  FREQ FILES for an allfiles listing from this system.
  37.  Files are held in Holding directories for a few days then moved.
  38.  
  39.  Thanks, The Sysop (Using ALLFIX v4.33 build 6, "Simply the Best")
  40.  
  41.  ... Information deteriorates upward through bureaucracies.
  42.  ---
  43.    * Origin: Some BBS 
  44.  
  45.  ---------------------------------------------------------------------
  46.       Have you ever been on a bbs that gets a ton of files but the sysop
  47.  or users aren't in the 'uploaded by ..' field?  But some weird name like
  48.  the above Echo Tag DFN_RPG is?  Well then that bbs is likely connected
  49.  to what is called the Filebone.  The filebone is just a term for a network
  50.  system that spreads or hatches files out to various bbses from one source.
  51.  It is similar to the Fidonet Backbone but instead of echomail its files.
  52.  IF you want to join such a FileBone or just one file echo that someone
  53.  you know has then Allfix is the best choice.  Why use allfix?  Well
  54.  there are other programs out there like TICK or such but allfix is in my
  55.  opinion the best overall and most user friendly.  It completely automates
  56.  the process for you.  It will receive files from your uplink (where you get
  57.  the files from) to your system then upload directly to your bbs so users
  58.  can download them immediately.  This FAQ will show you how to setup 
  59.  Allfix to work with Telegard and process such file activities as auto
  60.  uploading of new files to the bbs and file annoucements.  Advanced topics
  61.  like FileFind and such are beyond the scope of this document.  The new
  62.  (recent not really new) feature of the built in Request Processor is another
  63.  feature not covered here at this time.
  64.  
  65.   *  Needed Materials:
  66.      This document assumes you are using the following:
  67.      o Telegard v3.02 (Dos version is assumed)
  68.      o Gecho Tosser program using JAM bases for Telegard.
  69.      o Frontdoor Front end mailer
  70.      o Allfix v4.41 - Filename Afix_441.zip
  71.  
  72.      I am currently using 4.33 for Allfix at this time with Telegard v3.02
  73.  (multi-line setup).  I'm using Dos 6.22, so any OS/2 questions for Allfix 
  74.  are beyond the scope of this document but should be the same thing overall.
  75.  I'm using Desqview for my multi-tasker.  I have yet to upgrade my allfix
  76.  to v4.41 but it is the same overall.  This document does not guarrentee
  77.  a complete setup with your system.  I only do this FAQ to outline the
  78.  setup of Telegard that *I* have for my system as an outline to follow
  79.  for your system.  If any doubts backup your files.  I am setting up this
  80.  new v4.41 version on a test copy of Telegard that I run on another computer
  81.  so that I can follow the steps myself on setup to ensure it is proper (since
  82.  I've not setup Allfix on my bbs in a few years ago).  If you are using
  83.  Squish or some other tosser then I'm sorry.  This document is using info
  84.  for and about the above data.
  85.  
  86.   * Allfix Setup
  87.     You will see commands given in this manner like Asetup -> System Data.  
  88.   That means within the Asetup program (asetup.exe) you go to the System 
  89.   Data Option.  There are advanced topics I will touch on like if you wish 
  90.   to be a hub.  But for this document it won't be covered as extensive as 
  91.   the basic setup for Telegard.  I will only 'touch' on it so more advanced 
  92.   users can get an outline of an example setup.  For starting users only 
  93.   wishing to setup allfix for getting files then you can ignore those 
  94.   options.  Those items for advanced users will have ** near them.
  95.     First a minor note of terminology.  Throughout the doc you will see the
  96.   term Tick file or *.tic file.  Back when file distribution was just a
  97.   baby the program called TICK was it.  Basically a TICK file is a file 
  98.   of parameter info that allfix reads and helps it process it.  Take a look
  99.   at one or two when you get them.  It won't hurt you.  But basically it
  100.   tells allfix what file is being processed, what echo it belongs to,
  101.   any description and many other technical info.
  102.     For any shown directories or files mentioned it is assumed you will
  103.   make those directories or files.
  104.  
  105.     1) Step One - Basic Setup:
  106.        If you haven't yet download and obtain the allfix archive.  I suggest
  107.   you then unzip it into its own directory like c:\allfix.  Its a good thing
  108.   to add this directory to your Path statement in Autoexec.bat.  Note: If you
  109.   have limited environment space and a long path statement use something
  110.   shorter that you will know.  For example use c:\all instead if it helps
  111.   in every little bit of optimization.  Once you have unzipped the archive
  112.   you will need to read the Readme.1st file inside.  Without doing so your
  113.   lost.  Since there is a critical part in there (a password for the archive
  114.   unzipping) in the file.
  115.     2) Step Two - Get to know the files (optional)
  116.        Yes, we could just jump right in and get to work but I suggest that
  117.   you spend some time looking over the programs and files.  Skim the
  118.   documentation.  This is a benefit in the long run since there will be
  119.   sections of the setup program refered here and it will help you in the 
  120.   long run with pre-knowledge of those areas or key terms.  
  121.     3) Step Three - Basic Setup
  122.        At this point you should start a basic setup of the program.  I would
  123.   review the allfix.doc file to see what is needed on the basic setup.  The
  124.   basic setup program is asetup.exe.  The first time you enter it will
  125.   make you the setup config file for it.  At this point your ready to
  126.   configure Allfix to your liking.  At this point I assume you have 
  127.   configured some basic stuff already but if you haven't that's fine.
  128.   I only have this setup for more advanced people who like to jump ahead.
  129.     4) Step Four - Setup
  130.        At this point all the work is in Asetup.exe
  131.        1.  System Data -> Address Maintenence -> Network Addresses
  132.            If you are reading this echo (TG_SUP on Fidonet) I assume you
  133.   probably are in fidonet.  I would enter as the Main address your fidonet
  134.   number.  Then if you are in any other networks you should give each aka
  135.   slot the other addresses.  For example, for myself I enter Main->1:112/91
  136.   Aka 1-> 33:409/1 (AdventureNet), etc.  Without this info allfix doesn't
  137.   know how to process anything.  
  138.        2.  System Data -> Address Maintenance -> Site Information
  139.            Allfix is the basic user interface as that of Gecho and Frontdoor.
  140.   If you are used to those products this program should be a breeze.  You
  141.   will notice this group of items needs to be filled out.  The bbs name
  142.   and other info should be given.  This is just like Gecho and Frontdoor's
  143.   Site Information areas.  This is info used in file annoucements or 
  144.   templates (advanced topic).
  145.        3.  System Data -> Address Maintenance -> Aka Matching
  146.            This can be skipped as its not required for Telegard setup.  But
  147.   This is a feature you can read up on and return to at a later time.
  148.        4.  System Data -> Address Maintenance -> Domain Names **
  149.            Same as 3 above.  
  150.        5.  System Data -> Address Maintenance -> Uplink Manager **
  151.            This is used if you are a major file hub and YOU have an uplink
  152.   that you send requests for new file areas or such from YOUR downlinks.
  153.   This FAQ assumes that you are on the bottom level (a common node who
  154.   is only getting files) and not a hub.  Therefore treat as 3 above.
  155.        6.  System Data -> Pathnames (part 1) 
  156.            The program has got to know where things are so this is where
  157.   we supply it the info it needs to work.  Again, its very similar to that
  158.   of Gecho and Frontdoor.  
  159.            -> Msg Base - Skip at this time - not needed for Telegard
  160.            -> Netmail - Important since it has to know where your netmail
  161.   file attach messages are and such.  If your using the default Frontdoor
  162.   settings then this would be c:\fd\netmail\.
  163.            -> Netmail out - this is usually the same as Netmail. 
  164.            -> Inbound - This is vital because it tells where incoming
  165.   files and *.tic files are located so allfix can process them.  In this
  166.   example setup we'll use c:\newfiles\.  You should use the same inbound
  167.   directory that gecho and frontdoor points to.  For example c:\newfiles\.
  168.            -> Secure Inbound ** - usually the same as inbound unless you are
  169.   needing extra security precautions (advanced not covered here).
  170.            -> Outbound, Pkt In and Pkt Out not needed here - skip.
  171.            -> Tic path ** - this is where outgoing *.tic files are placed.  
  172.   But this is if you want to be a Hub and have downlinks get files.
  173.   But for this document you can skip it.  For myself I use c:\all\tick\.
  174.            -> Queue path ** - This is where pass through files are stored
  175.   until they are sent to downlinks.  For this document skip it.  For myself
  176.   (and for those who might want to start as a hub) I use c:\all\queue\.
  177.        7.  System Data -> Pathnames (part 2) 
  178.            -> List path ** - this is for CD-roms.  Since I do not have
  179.   such here online I suggest skipping it.
  180.            -> Rcvd Path - If a file is bad (lights went out during a 
  181.   transfer in FD and didn't complete coming across) or it is a orphan (ie
  182.   doesn't have a *.tic file with it) then allfix can move it to a directory
  183.   for later viewing or checking.  I suggest you have 2 holding directories
  184.   for this particular function.  I use c:\all\tick\hold\ for any such files
  185.   and it will move them here.  Of course its a good idea to check this
  186.   directory to make sure things aren't cluttered if you use this method.
  187.            -> Bad tics - This is the second directory I suggest.  But this
  188.   and the previous one are not required.  They only help you out in allfix
  189.   organization.  I use c:\all\tick\bad\ myself.  This directory will hold
  190.   any bad ticks.  Well for example if a file and a *.tic file comes in 
  191.   that you do not have IN allfix then allfix can't do much but move it
  192.   here.  So then at a later time when you do add that file echo to allfix
  193.   you can reprocess allfix using a parameter (run allfix by itself to
  194.   see the possible parameters) to re-process those files.  In the echomail
  195.   area this would be like a bad_msgs area for Frontdoor or gecho.
  196.            -> Dupe path - optional item but I leave mine blank so it
  197.   will move duplicate files (say you are connected to two filebone nets
  198.   and get the same file twice) to the Bad Tics holding directory.
  199.            -> Auto add ** - advanced feature.  Suffice it to say you should
  200.   read up on this it could be useful (G).  There is a program by the current
  201.   filename called AAdd120b.zip which supports Telegard and will do nifty
  202.   features like adding auto-added areas to allfix and TG.  Something to let
  203.   you do some research on (G).  Homework and a quiz will be given later.
  204.            -> Tag path ** - skip unless you want to be a file hub.
  205.            -> Tmp Path - I have c:\all\temp\ for mine.  This is an area
  206.   in which allfix can covert files say from zip to arj.  While I do not
  207.   handle that via allfix some might.  However, it is also used as a temp
  208.   directory for processing files for incoming and outgoing as well.  
  209.            -> Template - This is where your files that are contained in
  210.   template.zip are located.  The suggested I belive is c:\allfix\template
  211.   but myself I place them in the main allfix directory (c:\all\).  Templates
  212.   are just a way to give flavor and spice to file reports and annoucements.
  213.            -> Billing and Old Bills ** - Skip for this document not needed.
  214.        8.  System Data -> FileNames
  215.            -> Alias ** - This is a file like c:\fd\files.lst which contain
  216.   a list of files that people can file request (FREQ) from your system.
  217.   For this document you can skip it.  
  218.            -> Logfile - This is any record of allfix activity.  You should
  219.   place it and name it as you see fit (for example c:\fd\allfix.log).
  220.            -> Mgr Log ** - if your to be a hob this is any activity that
  221.   is caused by running the areamanger like Allfix Mgr command.
  222.            -> Echotoss - If you are using a file annoucement area that will
  223.   go out through a local net or whatever this is useful.  It should point
  224.   your echomail.jam file.  For example, c:\tg\echomail.jam.  However, if
  225.   you are not using that particular feature of Telegard skip it.  This
  226.   basically will add the new message (file annoucement post) to this file
  227.   so when Gecho runs next it will send it out.
  228.            -> Unwanted and Wanted ** - These files are for registered setups
  229.   of allix.  It is an advanced feature so you can skip it. 
  230.            -> Semaphore - This is the semaphore file to affect if outgoing
  231.   mail is created (ie file annoucements).  This is optional and may be
  232.   skipped if you wish.  I use c:\fd\fdrescan.now for my setup.
  233.        9.  System Data -> Origin Lines **
  234.            If you are to setup a file annoucement system for your bbs or
  235.   network then this should be given info.  IT is basically info to add
  236.   to the origin line of the mail.  It can be skipped as its advanced.
  237.       10.  System Data -> External Programs **
  238.            The default setup here should be kept and not modified.  Simply,
  239.   this area is used to add archiver or converter programs.  You will notice
  240.   Scan is one item.  It is a registered feature of allfix where you can let
  241.   Allfix Virus scan the files before uploading them to the bbs.
  242.       11.  System Data -> External Programs -> Options
  243.            -> Swapping method : Depending on your setup you should give it
  244.   the best method of swapping out.  For example if you use XMS more you 
  245.   ought to give XMS priority over EMS.  
  246.            -> Redirect output - I personally have this set at Yes while
  247.   the default is No.  Use the online help to see what it does.  Experiemnt
  248.   to fit what you like best.  But it has no bearing overall to the setup.
  249.            -> Virus Errorlevel, files to scan, EAC ** - The rest of the
  250.   options here can be ignored for this setup as they are advanced.
  251.       12.  System Data -> Global Options
  252.            -> Log Style - You should tell it what format you wish to use.
  253.            -> Mailer Mode - Give it the mailer you are using.
  254.            -> Date Format - optional, experiment.
  255.            -> Msg Compability - Fido is usually used here.  
  256.            -> Local requests ** - Advanced - can skip.
  257.            -> Replace Extension ** - Advanced - can skip.
  258.            -> Other options of this area - You can ignore or experiment
  259.   they are not crucial to the TG setup.  But are added spice to help you.
  260.       12.  System Data -> Miscellaneous
  261.            -> Log Options - You should go in here and set what you feel 
  262.   is useful to log.  The more info the bigger the log file.  It is useful
  263.   to have it all on for debugging the initial setup.
  264.            -> Areamgr options ** - If you are to be a hub this will be
  265.   the heart of your operation.  You should read about it for more details.
  266.            -> Edit Days, Months - No need to go here default is fine.
  267.            -> Exclude files ** - Advanced.  But Basically the jist of 
  268.   this option is say you wanted not to show that XXX*.gif is uploaded here
  269.   you can do that for file annoucements.  Ignore for basic setup.
  270.            -> Asetup colors - Obviously this is so you can have a better
  271.   interface of colors.  Its not required to enter but if you wish different
  272.   colors then by all means play with them.
  273.  
  274.                 Now the easy part is over.  Now we tackle the hard part.
  275.  
  276.       13.  [Main Menu] FileFind System **
  277.            This is an advanced section and will not be covered by the scope
  278.   of this document.  I would suggest reading on it if interested.
  279.  
  280.                 At this point I'm going to skip around the main menu.
  281.  
  282.       14.  [Main Menu] Utilities **
  283.            IF you wish to edit the sample templates (used in file reports)
  284.   you can do that here.  This section also allows you to export or import
  285.   data to let others see what your setup is for debugging.
  286.  
  287.       15.  [Main Menu] Node Manager
  288.            Since I'm assuimg you wish to get files from a uplink then you
  289.   will need to enter here next.  This area will contain master info on
  290.   your uplinks (or downlinks if your a hub).  I'm going to give you an
  291.   example of my file hub.  I get files from 1:112/101 (for Fidonet Filebone
  292.   related files).  Enter the node manager and lets insert your file uplink.
  293.   It is assumed you at this point KNOW your hub.  If you do not then find
  294.   one since you can't get files from thin air (G).  
  295.            -> System - This is the network address of your uplink (or if
  296.   you are to be a hub downlink).  For me its 1:112/101.
  297.            -> Sysop - the name of the sysop.  Its more a info to you and
  298.   for information on allfix request reports.  
  299.            -> Route Via - Rarely used so you can skip it.
  300.            -> Holding directory ** - Advanced but a nifty feature (G).
  301.            -> Authorized groups - This is like Gecho. It tells what group
  302.   (see later on group manager) the node can have access to.  For this
  303.   case lets say Group 1 is Fidonet.  It is not defined at this point so
  304.   we can come back to it but REMEBER to come back.  
  305.            -> Fileecho and areamgr passwords - are for security and you
  306.   can read on which pw protects what feature of allfix if you want them.
  307.            -> Use Aka - Keep the default here "Setup/aka matching" this
  308.   seems to work best for this field.  It basically allows allfix to figure
  309.   out which network the node belongs to (in this case uses setup info).
  310.            -> File Attach status and Other mail status - If your to be
  311.   just a node getting files then you can keep this at default.  However,
  312.   if you are to be a hub and send files out you might which to assign
  313.   CRASH or HOLD or other status bits to the mail.  In other words for a hub
  314.   this allows you to CRASH (send files out asap) or hold (so they are picked
  315.   up by a system calling in or for Long distance boards).
  316.            -> Tic File Mode ** - The default is fine but if you wish to
  317.   have an advanced setup (for hubs mainly) read up on this option.
  318.            -> Packing mode ** - This is the same as Tic File Mode.
  319.            -> Compression Type - Zip is default.  This tells allfix which
  320.   compression type the files coming in for THIS node are.  So it can then
  321.   test, scan, convert or whatever other process it might need easilly.
  322.            -> Advanced Options ** - These options can be skipped and
  323.   are mainly used for HUBS not nodes just getting files.
  324.            -> Cost sharing options ** - For hubs who which to have bills
  325.   and a Cost recovery program (CRP) system setup for files.  You can skip.
  326.  
  327.         At this point you should have your uplink in allfix or should.
  328.       
  329.       16.  [Main Menu] Request Processor **
  330.            This feature is for those who wish to have a built in FREQ (file
  331.   request) processor for their bbses instead of say Frontdoor's built in
  332.   ability.  Please note this is in 4.41 if using an earlier allfix you may
  333.   not see this and other features listed in the FAQ.
  334.  
  335.       17.  [Main Menu] Allfiles lists **
  336.            This is the same as 16 and is an advanced feature so you can 
  337.   skip #16 and #17 for this basic setup.
  338.  
  339.         At this point you have most of the setup complete however we now
  340.   need to get to the hard part of the setup and heart of the operation.
  341.     
  342.     4) Step Four - Fcomp
  343.        We must tell Allfix at this point what file bases you currently have
  344.   online on your bbs.  This is so when we get to the next step and we know
  345.   where files should go we can tell allfix the right data.  Whenever you
  346.   create new file bases you should run Fcomp.exe.  It comes with the
  347.   allfix and fully supports Telegard v3.02+.  To run it yuo type 
  348.   Fcomp 19 (Data directory) - Where 19 tells it for telegard and the
  349.   Data directory is where your fareas.dat is located like c:\tg\data\.
  350.   This information is also used in later steps as well as the next one.
  351.  
  352.     5) Step Five - File Echos
  353.        File Echos are just like Message echos but instead of echomail they
  354.   use files for the medium of exchange.  
  355.        1.  [Main Menu] File echo system
  356.            We now need to enter this series of menu items from the main
  357.   menu to start adding file echos to your setup.  A File echo is just like
  358.   a message echomail area but instead of messages its files that are used.
  359.            -> File Echo manager - We'll cover this in a minute.
  360.            -> Hatch Manager & Magic FileNames ** - Are advanced options and
  361.   are made for hubs mainly or file requesting.  Study them if interested.
  362.            -> Group manager -This is the editor that allows you to add
  363.   groups to allfix.  Just like Gecho's group manager a group allows you
  364.   to categorize sections.  For example if you are getting files from fidonet
  365.   filebone then create a group for each fileecho group.  When you join a
  366.   file distribution network you will get a list of file echos like
  367.   filebone.na for fidonet.  You will notice there are groups (in most
  368.   organized networks at least) like AD is a group for Author direct files
  369.   which might have a handful of file echos in it.  Another group is TG_SUP
  370.   which has only one file echo TG_SUP for this fine bbs software! This allows 
  371.   you to do things at a faster pace and organize things.  It allows you to 
  372.   make changes faster without worrying about conflicts.  Let's assume for 
  373.   this FAQ you are in Fidonet and getting files from the Filebone:
  374.               
  375.   Let's jump in and create a group while I explain the Group Manager itself.
  376.               
  377.        2.  [File Echo System Menu] Group Manager
  378.               -> Group - This is the slot that is used for group defaults.
  379.   It ranges from 0-255.  Lets say we use slot 1 for Fidonet.  
  380.               -> Name: This is the name of the File Echo group.  For example
  381.   TG_SUP or DDSDOORS or PDN.  Good way to use is to list the name with
  382.   the group tag and a short description like PDN: Programmer's Distribution
  383.   Network.  Here is a HINT to help things out.  If you have the filebone.na
  384.   or a similar formated file from a file hub you can import your areas from
  385.   that file INTO allfix.  This will save you time and speed things up.  
  386.   You should edit out any file groups or file echos you do not like from
  387.   the file and then using the Asetup -> Utilities -> Import Data you can
  388.   import using the Filebone.na feature!  Let's use TG_SUP for our example
  389.   Group name.  
  390.               -> Mask ** - This field is basically an advanced feature that
  391.   is used with auto-adding of file echos.  For example say a group tends
  392.   to have all its file echos with WIN_* well you can give it that very 
  393.   mask and when a new file echo say Win_New is added it will add it using
  394.   this group's pre-set info.  For now however, we'll leave it blank.
  395.               -> Unique, Add BBS and BBS Mask ** - Are advanced features
  396.   used in conjuction with auto-added areas.  You should skip it.
  397.               
  398.               The bottom of the manager says for defaults of auto-added
  399.   areas.  While this is true we should use this area as well since any echo
  400.   you add manually to allfix will use the defaults for THAT group slot you
  401.   pick.  This will help in saving time for alot of the information.
  402.               
  403.               -> File Echo Description - Actually it should say Group 
  404.   description.  Here you might say "AD: Author Direct files -" and leave
  405.   the rest blank.  This is so you could add in a specific echo description
  406.   after the dash.  For example "- Windows software".  The "AD:.." part
  407.   is a good technique to show which group it belongs to for viewing ease.
  408.               -> Dest - This tells (the group default - for more specific
  409.   areas for EACH file echo you can specify that in the file echo manager)
  410.   where to have allfix place the files after processing them from your
  411.   inbound area (c:\newfiles in my example above).  Allfix will create the
  412.   directory if it doesn't exist.  
  413.               -> Use FDB - If you do not see this you have not used the
  414.   Fcomp utility as directed, please redo step four.  Assuming you have
  415.   and allfix knows what directories TG is using for files then we can
  416.   figure out this item.  To be honest I'm using 4.33 and this toggle is
  417.   not there.  But if you select yes allfix will update TG data files and
  418.   show the file has been uploaded.  So I would toggle this yes.  
  419.               -> Use FDBS - This will either update (when a file comes in)
  420.   files.bbs with the new files or not.  If you have programs using this
  421.   file then you might want it yes otherwise no real need for it.
  422.               -> Keep # - This is just a feature used if you wish to delete
  423.   files that are overlly abundent in quantity.  But leaving it at default
  424.   should be sufficient with any setup unless you are hurt for space.
  425.               -> Template - If you select this item and you see no files
  426.   listed you should unzip template.zip where you told allfix to look for
  427.   them.  This allows you to assign (if you want) a file for netmails or
  428.   bbs file annoucement echos.  Typically reports is the template most use
  429.   for file annoucement echos and such.  This is a moderately advanced 
  430.   feature and only mess with it if you wish to do such activities.
  431.               -> Banner - This is a report or just a simple banner (see
  432.   banner.apl for example) that can be added to archives coming into your
  433.   bbs (like a bbs ad or a 'this file is virus scanned' message).  But
  434.   it is a registered only feature.
  435.               -> Use Aka - This tells allfix which network address to 
  436.   use (ie which network basically) this group is used for.
  437.               -> LongDesc - If you see files that come in with short
  438.   descriptions when you know they have longer ones this might be the cause.
  439.   You can toggle what you want to be shown in the data base (TG/allfix).
  440.   I find that the toggle 'File_id.diz/Ldesc' works the best since the FULL
  441.   file_id.diz is uploaded into TG for you.
  442.               -> Cost ** - Skip unless you want to charge downlinks.
  443.               -> Max Days - This is the max days to keep a file in this
  444.   group.  I find the default 0 (unlimited) to be the best solution.
  445.               -> Max Size and Max Files - Is just like max days but tells
  446.   if the size or # of files should be limited.  Again 0 works the best here.
  447.               -> Systems -This field allows you to edit system connections.
  448.   If you have an uplink or a downlink here is where you add them (or if they
  449.   use allfix requests its done automatically).  
  450.               -> Advanced Options [Menu]
  451.                  -> Convert - If you wish to have files converted to a 
  452.   preferred format say *.Rar here is how.  
  453.                  -> Convert all, inc ** - Advanced conversion features.
  454.                  -> Pass through - This is for systems who allow people to
  455.   get files (downlinks) from them but they themselves do not carry that file
  456.   echo online so it passes through their system only.  This is the toggle.
  457.                  -> Allow replace - If you wish to have files replaced like
  458.   when new fidonet.na files come out then this feature allows it.  
  459.                  -> Announce ** - If you are using file reports then this
  460.   is how you can include areas in those reports by this toggle.
  461.                  -> Add File_id.diz (!!!) - This is a super feature.  If
  462.   the archive does not have one it will add one based on the *.tic file that
  463.   it comes in with (assuming that tic file has a basic description).
  464.                  -> Virus scan - Reg only feature.  You can scan files 
  465.   that come in and then do various actions with them.
  466.                  -> Check dupes - If you have duplicate files this will 
  467.   either tell allfix to act on those or not. 
  468.                  -> Visible, Tiny SB, no touch ** - Advanced hub features.
  469.                  -> Security - Just a toggle that will verify things in
  470.   *.tic files are correct for this group.
  471.                  -> Send original ** - Advanced hub feature - skip.
  472.                  -> Add pic specs - If you have gifs and wish to add the
  473.   resolution and such info to the TG descriptions this will do so!
  474.                  -> Update magic ** - Magic aliases are used in the file
  475.   request abilities and should be read up on if you want such features.
  476.                  -> Touch AV - If you wish Allfix to affect (ie add a 
  477.   file to it or whatnot) AV files (those with security envelopes).
  478.  
  479.        3.  [File Echo System Menu] File Echo Manager -> Options
  480.            Let's cover the options menu for the file echos first before
  481.   we add any file echos.  These options cover all the file echos and
  482.   are vital for some operations.
  483.            -> Keep original file date - This toggle is for those who might
  484.   wish to make 'old' files 'new' ones (G).  Say a 1984 file coming in 
  485.   with this toggled yes will add the CURRENT date (ie 1997) to it.   
  486.            -> Download counters - Another way of cheating.  Say you want
  487.   a echo to seem active in downloads.  This allows you to add a download
  488.   counter say 12 for EVERY file echo file that comes in.  This could be
  489.   dangerous so use it wisely.  Default is perfect as well.
  490.            -> Update descript.ion - If using 4dos you should use this 
  491.   item otherwise for non-4dos systems default is fine.
  492.            -> Max # of systems ** - Advanced hub feature - skip.
  493.            -> Inv. ?lo files - I have no idea on this feature sorry.
  494.            -> Dupe checking - This toggle allows you to tell allfix by
  495.   which method you wish to have allfix check for duplicates.
  496.            -> Min HD space to import - For those limited with space allows
  497.   you to set a limit for allifix on imports.
  498.            -> Max tic file archive size - Rarely is *.tic files over a few
  499.   kilobytes but in case they are you can limit it.
  500.            -> max files to pack ** - Advanced tic packing feature - skip.
  501.            -> Sort file echo - Allows sorting by groups or not.
  502.            -> Tic archive specs ** - Advacned tic operations - skip.
  503.            -> Longdesc character - The default works most of the time but
  504.   if for some reason your long descriptions aren't importing it could be
  505.   the character that starts the description is different.
  506.            -> Longdesc width - Say you wish only a 10 character wide file
  507.   description for each file.  This is how!
  508.            -> Spaces to indent - Default works the best.
  509.            -> Filter Ansi, Longdesc - if your descriptions are showing up
  510.   oddly you might toggle these yes.  Otherwise the default works best.
  511.            -> one line longdesc - If you wish only one line file descriptions
  512.   this it your toggle!
  513.            -> max length of longdesc - Same as width but allows you to limit
  514.   the number of lines shown for that file.
  515.            -> Add tag - This is a nice feature as well.  If you wish to 
  516.   show the users that a file came from TG_sup you could toggle it to 
  517.   Uploader and it will add the tag to that file. 
  518.            -> Filter String - Say you wish to omit profanity or such words
  519.   from descriptions this allows it.
  520.  
  521.        4.  [File Echo System Menu] File Echo Manager 
  522.            The first time you enter the file echo manager to add or change
  523.   file echos it will ask for which group the file echo is to belong to.
  524.   This is why we covered groups first.  For our example lets use the
  525.   group we just setup.  This is the true heart of the program.  Alot of
  526.   the items below are the same for the Group manager but are for that
  527.   individual file echo and not for a group.
  528.  
  529.            -> Tag - This is your file echo tag.  For example say you are
  530.   in the Group TG_SUP that group has the echo TG_SUP (yes same tag) for
  531.   Telegard related support from fidonet.  This is where it goes.
  532.            -> Description - The new echo is using the group description
  533.   so you could edit it (unless you imported file echos from the Import Data
  534.   section of Utilities) to your liking.  If imported its already here.
  535.            -> Dest - The directory for this file echo to place files in.
  536.   This is just like the group manager and uses its default.  However, if
  537.   you wish to make it even more specfic say c:\dls\tg for the group you
  538.   could have c:\doors\tg\scripts for just scripts.  However, seeing as
  539.   TG_SUP only has one echo this example is of no use but there are plenty
  540.   of groups that do have specific setups like that.
  541.            -> Use FDB, Use FDBS - Same as group manager info above. 
  542.            -> Group - Tells which group this file echo belongs to.  If
  543.   you do not wish to use the one selected then you can change it.
  544.            -> Keep #, Template, Banner, Advanced options, Use Aka, 
  545.   LongDesc, Cost, Max Days, Max Size, Max Files and Systems are all 
  546.   identical information as above for group manager but are for the specific
  547.   file echo shown.  This allows you to customize each file echo if you
  548.   wish to diverge from the group defaults.  Say for example you could use
  549.   a different template and keep this file echo limits on max size if you
  550.   wish to do so.  The group defaults would be given here but these sections
  551.   are here for you to make your personal choices on setup.
  552.  
  553.     6) Step Six - Are we done yet?!
  554.        Well yes.  At this point you should know so much about allfix to
  555.   teach a class in it.  At least I hope so.  There is online help for
  556.   each item by pressing F1 at any time in the program.  So while my 
  557.   descriptions got intense the docs might just show more details that I have
  558.   or less details.  In the conclusion of this FAQ we have some last few
  559.   sections to help those who wish more advanced setups and lastly some
  560.   hints and batch file material of the more important areas as a general
  561.   outline for you to follow.  If at this point you are ready to go then you
  562.   do not need to read on.  However, there might be things more for you to
  563.   learn that will give that extra edge of working with allfix.  I will only
  564.   touch on certain things here and will rely on the reader to investigate
  565.   the documentation for further details.
  566.  
  567.        1) File Annoucements
  568.           As shown at the top of this FAQ I showed what a typical file
  569.   annoucement is.  It is a message posted just like a regular echomail
  570.   message posted say in TG_SUP (Telegard support for fidonet).  Instead
  571.   of a person doing it Allfix posts it to the bbs it is serving on.  IF
  572.   you wish to have such on your board say for a local fidonet echomail
  573.   base that has such reports here is the section how.  You will have to
  574.   go through the above information and find the various areas I mentioned
  575.   that a particular option was for file annoucements and then invoke those
  576.   options.  Then we shall go to the main menu section of "New File Reports"
  577.   and "BBS new file dirs".  They are used in conjuction with each other
  578.   to process new files.  It is required that you have already used Fcomp
  579.   as outlined above to use these features.
  580.           [Main Menu] -> BBS new File dirs - When you add a new entry. 
  581.             -> File area - When you select this field it will give you a 
  582.   list of directories you currently have online in Telegard (via the Fcomp
  583.   utility).  I would for sake of example since most people have one general
  584.   upload directory you select that directory.  IF you do not have such then
  585.   select a directory files are placed or held or uploaded to.  For me I use
  586.   the Upload file directory for myself.  
  587.             -> Desc - This is just a short description of that file area
  588.   if you wish to supply one for allfix (for easy reading).
  589.             -> Group - Since we've created one already in our examples above
  590.   lets select that one.  This just attaches this feature to a particular
  591.   group for different reports if you wish.
  592.                 Now that we've done that and assigned at least one new file
  593.   directory we can continue.  What we have done is whenever a new file is
  594.   uploaded to your bbs by a user and you run allfix File it will scan the
  595.   upload directory and if a new file is present make a report.  This report
  596.   could be in a local directory or a echomail base for everyone to view.
  597.  
  598.           [Main Menu] -> New File Reports
  599.             -> Groups - This field determines which group the file report
  600.   should be associated with.  Why have this?  Well say you have customized 
  601.   an adult file report, via the template editor, with sensitive info like
  602.   freq info that general users shouldn't see.  You could have say just the
  603.   adult groups have THAT report and the others use a standard report.  Then
  604.   the adult report could be shown only in the adult file annoucement echo
  605.   while the other is shown to everyone.  That is only one example of the
  606.   features of allfix.
  607.             -> Msg area - Since this report is going to be posted on your
  608.   bbs or a network you need to supply it what message area.  Selecting this
  609.   field will allow you to select the various formats.  But for myself, I 
  610.   use JAM and give it a name like c:\tg\msgs\fileinf where all local file
  611.   annoucements go to.  It seems squish is not supported.
  612.             -> Use Aka - This tells which origin address to add to the
  613.   origin line of the report (ie which network it belongs to if any).
  614.             -> Origin ** - If you wish to give customized origin lines 
  615.   here is how to do it.  These will be at the bottom of the file report.
  616.             -> Template - The standard file annoucement pre-made template
  617.   is REPORTS so I would use that unless you make one of your own.
  618.             -> From - Allows you to tell who "posted" the report.  Take for
  619.   example "BBS X File Reporter".
  620.             -> To - This is to who it is posted to.  Take for example you
  621.   could say "Everyone on BBS X" or "Everyone in Net 112".
  622.             -> Subject - Just like from and to, but is the subject line.  
  623.   You could do for example "New Files arrived on BBS X".
  624.             -> Inactive ** - Just use the default no for now.
  625.             -> Systems - This tells allfix which nodes (bbses) are connected
  626.   to receive the file reports (if given through a network).
  627.   
  628.         Now you should be able to generate a file report at this point.
  629.  
  630.        2) Utility programs
  631.           There are a group of associated programs with allfix that help
  632.   the user in various tasks. 
  633.           Fixutil.exe - This is a allfix maintenance utility that allows
  634.   you to do various things like make master file lists and such.  
  635.   For example fixutil describe allows you to import data from filebone.na.
  636.           Hatch.exe - allows you to hatch a file on the fly.  This is 
  637.   for downlinks mainly but if you wish to hatch a file out to friends
  638.   who are connected this is how.
  639.        
  640.        3) Batch files and Miscellaneous
  641.           One minor last thing that is vital to the allfix operation - the
  642.   batch file to run it!  You should study the commands of allfix for further
  643.   customization if you wish by simply running allfix by typing "allfix" in
  644.   the directory it is in.  I would suggest placing allfix in your PATH 
  645.   statement for easier processing as well.  Since most people will have
  646.   their files come WITH attached *.tic files then you can simple do the
  647.   following batch file segment:
  648.  
  649.           In the section at the top that runs before FD returns back after
  650.   say processing events include -
  651.  
  652.           If exist c:\inbound\*.tic       Goto Allfix
  653.  
  654.           Notes: Inbound is the directory where incoming files are stored
  655.   which was discussed back earlier in the FAQ.  Goto could be replaced with
  656.   a CALL if you wish to run a batch file like allf.bat which I do.  This
  657.   allows you to customize the batch file at will easier.  
  658.  
  659.           Once the batch file detects tick files it will go to that section
  660.   and run the next few lines.
  661.  
  662.           cd c:\allfix (or the directory where allfix is located)
  663.           Allifix F S A
  664.  
  665.           Complicated huh?  Read what each parameter does to see if you need
  666.   it.  For example if your not doing file annoucements A (annouce) is not
  667.   needed for this line.
  668.  
  669.           At this point you should be a fairly good person with allfix.
  670.   I know this FAQ was extremely long and I'm sorry, I tend to be over
  671.   technical so I don't have to repeat things later on (G).
  672.  
  673.   **************************************************************************
  674.  
  675.   ■ Contact Information
  676.     Fringe BBS - EWOG II (904) 733-1721 
  677.     Networks : Fidonet 1:112/91, AdventureNet 33:409/1, GamesNet 100:6607/1,
  678.                MirageNet 90:803/11 and a few others (G)
  679.     Echomail: TG_Sup fidonet echo frequent reader/poster
  680.     Internet: longshot@fringe.jax.fidonet.org (BBS email gateway)
  681.     
  682.   ----------------------= End of Allfix FAQ =------------------------------
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.