home *** CD-ROM | disk | FTP | other *** search
/ Amiga Times / AmigaTimes.iso / programme / trionbbs110 / Trion / docs / Utils / tick.doc < prev    next >
Encoding:
Text File  |  1998-10-06  |  6.6 KB  |  195 lines
  1.  
  2.  
  3.  
  4.    =====( TrionTick V1.10 )===========================================
  5.  
  6.  
  7.         Trion 'TickProcessor' Utility.
  8.  
  9.         (c) Copyright Paul Spijkerman, '94-'98. All rights reserved.
  10.  
  11.         Written for use with the Trion BBS package.
  12.  
  13.  
  14.    ===================================================================
  15.  
  16.  
  17.     The trion BBS has a simple Tick processor.
  18.     Tick's are files that come with the mail, during a mail call
  19.     session. With every file there is al little data files,
  20.     which tells the BBS what to do with the file.
  21.     This file usually has a name ending in ".TIC" and contains
  22.     a description of the file, the systems where it has arrived
  23.     and a section name and some other data needed to for the
  24.     tick processor. What normally happens is that a sysop
  25.     sends a file away in a mail network. Because that file has
  26.     a section name attached to it .. it is easier to have
  27.     only send certain files to you .. and you can let the
  28.     tick processor add the file to a certain section of
  29.     the file catalogue.
  30.  
  31.     The Tick processor has the ability to send netmail with
  32.     files to the recipient to attention him that he received
  33.     a new file. The message contains file name, file size,
  34.     section name and a description.
  35.  
  36.     The Tick processor can process compressed archives with
  37.     files and the .tic files that were send with the files
  38.     as sometimes generated by PC tick processors.
  39.     It can Unpack archives with an .Cnn extension where nn
  40.     is a number. It will start with the lowest nn number.
  41.     Also it can unpack archives with extensions ending in .?IC
  42.     like .ZIC
  43.     Note that it won't try to unpack files with .TIC extension
  44.     but only process them.
  45.  
  46.  
  47.  
  48.  
  49.     The tick processor has 2 modes, the "process" mode which is used
  50.     to process incoming TIC files and send them to other connected
  51.     systems and there is the "send" mode which is used if you want
  52.     to send (hatch) a (fysical) file in a file net.
  53.  
  54.  
  55.     Process mode:
  56.     -------------
  57.  
  58.     TrionTick -P
  59.  
  60.  
  61.     In process mode you can use the -B flag to backup incoming .TIC
  62.     files to the "trion:inbound/backup/" directory.
  63.  
  64.     When TrionTick encounters a problem then the .TIC file and 
  65.     (if available) the fysical file are moved to the 'BAD' directory
  66.     "trion:inbound/bad/" so the mail script doesn't process the
  67.     files over and over if it was started and it only is shown
  68.     once in the maitenance monitor.
  69.  
  70.     Note that files added to the file catalogue are not validated
  71.     unless they are added to a section that has the auto-validate
  72.     flag set.
  73.  
  74.     When a tick file contains a "replace" line .. it means that
  75.     the file is an update for an old file. Before the new file is
  76.     added the old file is removed from the file catalogue and
  77.     moved to directory "trion:killedfiles/".
  78.  
  79.  
  80.     Send mode:
  81.     ----------
  82.  
  83.  
  84.     TrionTick -s FILE TICKAREA "DESCRIPTION" [REPLACES]
  85.  
  86.  
  87.     Note: When you want to use the "send" option you have to be
  88.     in the directory where the fysical file is you want to send.
  89.  
  90.     If you "send" (hatch) a file it is added to you file catalogue
  91.     and it is Validated , you don't have to validate the file
  92.     by hand in an editor or file list.
  93.  
  94.     When you "send" a file it is copied to the filecatalogue directory
  95.     note that the original file is not deleted.
  96.  
  97.  
  98.     Configuring:
  99.     ------------
  100.  
  101.     For TrionTick to work you need 2 configuration files in 
  102.     the directory "Trion:cfg/".
  103.  
  104.  
  105.  
  106.     The first is "Trion:cfg/filenet.cfg" .. and it contains all
  107.     the tick file sections.
  108.  
  109.     The file can consist of empty lines, comment lines that start
  110.     with a ";" character and area sections.
  111.  
  112.     The format of an area section is like this:
  113.  
  114. AREA <areaname>  <origin NodeNum>  <FileAreaNumber>
  115. <send to NodeNum>
  116. #
  117.  
  118.     A section starts with an "AREA" line, it contains 5 fields,
  119.     the first field contains the word "AREA" in capital letters.
  120.  
  121.     The second field is a unique section number, which is used
  122.     to reference to it from the areafix.cfg
  123.     In the Areafix config you will make groups of tick file
  124.     sections by using ranges of numbers. So it is the easiest
  125.     if you give sections in the same net numbers in the
  126.     same range. Even better is just to reserve ranges for
  127.     certain nets.
  128.  
  129.     The third field is the areaname, which is the name of the
  130.     tickarea, note that is case-sensitive and that most names
  131.     are in capitals.
  132.  
  133.     The fourth field the origin nodenumber, which means it is
  134.     your nodenumber for the net this tick section is part of.
  135.  
  136.     The fifth field is the FileAreaNumber, which means it is
  137.     the number of a file section from the fileareas.cfg,
  138.     here go all the files which arive in this tick section.
  139.  
  140.     After the AREA line follows a list of nodenumbers of the
  141.     systems that get mail from you and your bosses that are
  142.     connected to this area.
  143.     Note that the list is vertical, it consists or lines with
  144.     one nodenumber, and it is terminated with a line with a "#" on it.
  145.     Note that <send to NodeNum> symbolises a list of nodenumbers.
  146.  
  147.  
  148.  
  149.  
  150.     The second file is "Trion:cfg/filenodes.cfg" .. it contains a list
  151.     of all the nodes that tick can send files to.
  152.  
  153.     The file can consist of empty lines, comment lines that start
  154.     with a ";" character and lines with node information.
  155.  
  156.     The format of a line with node information is like this:
  157.  
  158. PASSWORD  <NodeNumber>  <Password>  [flags]
  159.  
  160.     A node line contains 4 fields.
  161.     the first field contains the word "PASSWORD" in capital letters.
  162.     (so don't replace it with an actuall password)
  163.  
  164.     The second field contains the nodenumber of one of the
  165.     points, nodes or bosses you get mail from or suply mail.
  166.  
  167.     The third field contains a password that is used for
  168.     this node, note that passwords are case-sensitive but they
  169.     are almost always in capital letters.
  170.  
  171.     The (optional) fourth field contains the flags, at this
  172.     type there is only one flag which controls if there is
  173.     netmail send with a .tic file or not.
  174.  
  175.     Suply an empty flag field "[-]" if no netmail is needed, or
  176.     a use an "[M]" flag when netmail is wanted.
  177.  
  178.  
  179.     Netmail:
  180.  
  181.     If a node has a [M] flag instead of a [-] flag in the
  182.     filenodes.cfg, it means that the with every tic file for
  183.     that nodenumber TrionTick will send a simple netmail so
  184.     the sysop on the other side is notified of a new file.
  185.  
  186.     The "to" name for the netmail message is found in the
  187.     nodelist or pointlist ... if you want to use this option
  188.     and one of your nodes or points is not in a nodelist you
  189.     should enter a line like this to the pointlist:
  190.  
  191.     Point,14:103/300.1,BBS_Name,City,Name,Tel_Number,baud,flags
  192.  
  193.  
  194.  
  195.