home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / ticrb101.zip / TICTOSS.DOC < prev    next >
Text File  |  1994-05-25  |  11KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.          TicToss for RBBS-PC
  8.  
  9.          Release 1.00
  10.  
  11.          May 25, 1994
  12.  
  13.          (c) Copyright 1994 WER Development, All Rights Reserved.
  14.  
  15.          WER Development
  16.          500 Roselawn, Suite 4
  17.          Monroe, LA 71201
  18.  
  19.          BBS:         (318) 325-6608 (v.32bis/V.FC 28.8)
  20.          Fidonet:     WerDev@Fidonet#1:136/1.0
  21.          Internet:    WerDev@Aol.Com
  22.          Fax:         (318) 387-1085
  23.  
  24.  
  25.          WHAT IS TICTOSS for RBBS-PC?
  26.  
  27.          TicToss allows RBBS-PC sysops to participate in File Distribution
  28.          Networks (commonly referred to as FDNs or simply File Echos).
  29.          File Distribution Networks distribute software in archived form
  30.          and distribute TIC files with the archive that contains
  31.          information about the archive.  TicToss processes the TIC files so
  32.          the archives are copied to the proper download path for RBBS
  33.          callers, and imports descriptions for the archives into your FMS.
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.          TicToss for RBBS-PC                                       Page 1
  70.  
  71.  
  72.  
  73.          COPYRIGHT AND LICENSE
  74.  
  75.          TicToss for RBBS-PC is (C) Copyright 1994 WER Development, All
  76.          Rights Reserved.
  77.  
  78.          TicToss for RBBS is a fully functional shareware package.  After
  79.          a reasonable evaluation period to ensure it meets your needs, you
  80.          are obligated to register the application with WER Development by
  81.          completing the ORDER.FRM and returning it to WER Development with
  82.          payment.
  83.  
  84.  
  85.          WARRANTY
  86.  
  87.          No warranty of any kind is offered on TicToss for RBBS-PC.
  88.          Furthermore, you use this program AT YOUR OWN RISK.  Under no
  89.          circumstances shall the author be liable for damage this software
  90.          may inflict upon you or your property -- either by itself or with
  91.          your help.
  92.  
  93.  
  94.          SNAPSHOT of KEY FEATURES OF TICTOSS for RBBS-PC
  95.  
  96.          *  Automatically determines the FMS description widths (40-46)
  97.          *  Automatically determines the FMS order (reverse or forward)
  98.          *  Elegantly wraps the description text without truncation
  99.          *  Supports using TICK for Hubbing Files
  100.          *  Supports Planet Connect Downlinks
  101.          *  Supports ftp.fidonet.org Downlinks
  102.  
  103.          LIMITATIONS OF TICTOSS for RBBS-PC
  104.  
  105.          *  Maximum of 150 different AreaNames/File Echos currently
  106.          *  Maximum of 10 lines of extended description currently
  107.  
  108.  
  109.          SOFTWARE REQUIREMENTS
  110.  
  111.          TicToss for RBBS-PC has been tested with RBBS-PC 17.4 and
  112.          currently requires the use of the FMS (File Management System).
  113.          Additional versions of TicToss are being developed for other BBS
  114.          packages.  Currently we have versions for Spitfire, TriBBS, and
  115.          FeatherNet PRO under development.
  116.  
  117.          TicToss for RBBS-PC is currently a DOS only application.  TicToss
  118.          has been tested under DESQview 2.4x as well as OS/2 2.1's DOS
  119.          support.
  120.  
  121.  
  122.          ACKNOWLEDGMENTS
  123.  
  124.          Barry Geller, author of the TICK package.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.          TicToss for RBBS-PC                                       Page 2
  136.  
  137.  
  138.  
  139.          TICTOSS.CFG INSTALLATION
  140.  
  141.          TicToss compiles its TICTOSS.CFG before processing new arrived
  142.          files and their TICs.  TicToss's configuration file works off the
  143.          keyword concept currently used by most Fidonet related utilities.
  144.          A sample TICTOSS.CFG should be present in our distribution archive
  145.          with much of its information duplicated from this section of our
  146.          documentation.
  147.  
  148.          First, TicToss needs to know where to expect to find the TICs &
  149.          the archived files that arrive from your Fidonet Host.  The
  150.          "Inbound" keyword should be set to the path where TicToss will
  151.          find the arriving TICs and Files.  For BinkleyTerm users this will
  152.          be the setting you have for "NetFile", "KnownInbound", or
  153.          "ProtInbound" depending on your configuration.  For FrontDoor
  154.          users this will be the FILES directory.
  155.  
  156.          (We STRONGLY suggest the usage of session level passwords with
  157.          your mailer to prevent someone trying to send you files which you
  158.          do not expect.  Session Level Passwords are a feature of your
  159.          mailer -- refer to your mailer's security section for help in
  160.          setting up.)
  161.  
  162.          TicToss currently supports only ONE "Inbound" directory.
  163.  
  164.          Example:  Inbound d:\binkley\inboundp
  165.  
  166.          Next, TicToss needs information about how it should process the
  167.          TIC files.  The "AreaName" is the name each File Distribution
  168.          Network uses for its various File Echos.  The AreaName should be
  169.          unique for each file echo.  TicToss currently supports the
  170.          commonly used limitation of 8 CHARACTERS for the AreaName.  There
  171.          should not be any spaces as part of the AreaName -- underline
  172.          characters are substituted. (ie RBBS UTL would be RBBS_UTL)
  173.  
  174.          TicToss currently supports up to 150 AreaNames which translates
  175.          into 150 different File Echos.
  176.  
  177.          Example:  AreaName UTILNET
  178.  
  179.  
  180.          The "FilePath" is the full path where TicToss will copy the files
  181.          after their TIC information has been verified as valid &
  182.          description added to your FMS.  (After copying the file, TicToss
  183.          deletes the file in your Inbound directory.)
  184.  
  185.          Example:  FilePath D:\FileBone\Utility
  186.  
  187.  
  188.          The "FMSCode" is the Category Code to assign files received in the
  189.          current AreaName.  Generally most assign a unique Category Code
  190.          for each AreaName, but often the AreaNames of a FDN are not
  191.          different enough to warrant their own category code so you may
  192.          wish to use the same Category Code for an entire FDN.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.          TicToss for RBBS-PC                                       Page 3
  202.  
  203.  
  204.  
  205.          RBBS is limited to three characters for Category Codes, so
  206.          likewise you should limit your FMSCode to three characters.  Be
  207.          sure that the FMSCode used here is the SAME as those used in your
  208.          RBBS setup or callers will be faced with mixed up files, and/or
  209.          not see some files at all.
  210.  
  211.          Note:  You may use the same FMSCodes for multiple FMS files --
  212.          this would require Subboards on RBBS's part.
  213.  
  214.          Example:  FMSCode UTL
  215.  
  216.  
  217.          The "FMSFile" is the FMS file where the descriptions will be
  218.          written.  Most new RBBS sysops use the same FMS for all their
  219.          files, but others may choose to use MANY FMS files for various
  220.          reasons such as Subboards.
  221.  
  222.          Example:  FMSFile D:\Rbbs\Fms\OS2.Dir
  223.  
  224.  
  225.          The "Host" is the Fidonet address of the system which sends the
  226.          files and their associated TIC file.  As far as we know the Host's
  227.          address is specified in the 3D form of Zone:Network/Node, but
  228.          there isn't any manipulation done on TicToss's part to break an
  229.          address apart -- TicToss just compares the string of characters
  230.          for a proper match when verifing TIC files.  If you find yourself
  231.          on the receiving end of a different address format, just note the
  232.          format and use it instead.  We would also appreciate hearing about
  233.          this variation to help alert others.
  234.  
  235.          Note:  The Host keyword works in conjunction with the Password
  236.          keyword.
  237.  
  238.          Example:  Host 1:136/2
  239.  
  240.  
  241.          The "Password" is the password your Host adds to the TIC file
  242.          before forwarding the TIC and its file to your system.  This
  243.          password is generally agreed upon by mutual consent, but if your
  244.          Host assigned your password at random, you may have to do a bit of
  245.          detective work.  Using a text file browser (such as LIST), look at
  246.          the very last line of the TIC file.  The last line should begin
  247.          with "Pw" which is short for Password -- the word that follows
  248.          "Pw" is the Password for AreaName.  Most sysops receive files from
  249.          only one system, but since each Password is associated with an
  250.          AreaName you may receive different file echos from different Hosts
  251.          if you so desire.  Just remember to use a UNIQUE and DIFFERENT
  252.          Password for each system sending you Files.
  253.  
  254.          Note:  The Password keyword works in conjunction with the Host
  255.          keyword.
  256.  
  257.          Example:  Password LetMeIn
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.          TicToss for RBBS-PC                                       Page 4
  268.  
  269.  
  270.  
  271.          TICTOSS.CFG INSTALLATION (Optional Parameters)
  272.  
  273.          In addition to the above required configuration information for
  274.          your TICTOSS.CFG, there are a couple of optional keywords which
  275.          may be of use to some TicToss users.
  276.  
  277.          The "Preprocess" keyword is a temporary work around for those who
  278.          need support for hubbing of files (which will be included in a
  279.          future release).  Using "Preprocess" allows for adding file
  280.          descriptions to your FMS, but TicToss will NOT copy the file, NOR
  281.          will it delete the TIC file.  Immediately AFTER running TicToss
  282.          you need to run TICK and let it take care of sending to your
  283.          downlinks as well as copying the file to the appropriate download
  284.          path for your BBS callers.  The "Preprocess" keyword is targeted
  285.          primarily towards current TICK users who find its "support" of
  286.          RBBS lacking.
  287.  
  288.          Example:  Preprocess
  289.  
  290.  
  291.          The "DeleteUnknown" keyword is a option which is intended for
  292.          Planet Connect subscribers or those with ftp connectivity.  (Note
  293.          there are no spaces between "Delete" and "Unknown".)  Planet
  294.          Connect subscribers and ftp users receive ALL the areas from their
  295.          "host" no matter how few they actually process for their BBS.
  296.          Using "DeleteUnknown" causes TicToss to delete BOTH the TIC and
  297.          the file in the event it cannot find a match in your TICTOSS.CFG.
  298.          Normally, TicToss leaves the TIC file as well as the file attached
  299.          to the TIC file alone if it cannot find a matching AreaName in the
  300.          TICTOSS.CFG -- ie. TicToss assumes you have requested new areas
  301.          from your host and have not configured the areas in your
  302.          TICTOSS.CFG yet.
  303.  
  304.          Example:  DeleteUnknown
  305.  
  306.  
  307.          MULTINODE CONSIDERATIONS
  308.  
  309.          TicToss does NOT include any type of file locking support at this
  310.          time.  In order to ensure no loss of data, TicToss should only be
  311.          run during maintenance events in which there is both no access to
  312.          your BBS and no possibility of TicToss being run while your mailer
  313.          is still online receiving files from your host.
  314.  
  315.          WER Development has invested significantly in software and
  316.          hardware to attempt to duplicate the environments used by our
  317.          clients.  While this is expensive, it helps ensure reliability as
  318.          well as reducing incompatibilities.  Tentative plans call for
  319.          utilizing Personal Netware (Novell) to facilitate the
  320.          implementation of file locking during the 3rd Quarter of 1994.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.