home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / rbbs_pc / rbbtic39.zip / RBBTIC.DOC < prev    next >
Text File  |  1993-04-06  |  16KB  |  385 lines
  1.                             Version 3.9 of
  2.  
  3.  
  4.           █▀▀▀█    █▀▀▀▄    █▀▀▀▄   ▀▀▀█▀▀▀   ▀▀▀█▀▀▀    ▄▀▀▀▀▄
  5.           █ ▄▄█    █ ▄▄·    █ ▄▄·      █         █      █
  6.           █  ▄     █   █    █   █      █         █      █
  7.           █   ▄    █▄▄▄▀    █▄▄▄▀      █      ▄▄▄█▄▄▄    ▀▄▄▄▄▀
  8.  
  9.  
  10.                         Copyright 1993  David Remer
  11.  
  12.  
  13.                          RBBTIC was written by
  14.                               David Remer
  15.                                    at
  16.                            The Morning Sun BBS
  17.                  8:931/697 and 1:387/697 in San Antone, Tx.
  18.  
  19.                        Registration is only $8.00.
  20.                        The registered version requires
  21.                        no sysop intervention.
  22.  
  23.  
  24.  
  25. i.   The Legal Stuff
  26. ii   Registration Information
  27. I.   Introduction
  28. II.  Setup
  29. II.  Credits
  30.  
  31.  
  32.  
  33. i.                             The Legal Stuff
  34.  
  35. RBBTIC, Copyright 1993 DAVID R. REMER. All Rights Reserved.
  36.  
  37. No part of this publication may be reproduced, transmitted,
  38. transcribed, stored in a retrieval system, or translated into any other
  39. language or computer language in whole or in part, in any form or
  40. by any means, whether it be electronic, mechanical, magnetic,
  41. optical, manual or otherwise, without prior written consent of
  42. David R. Remer.
  43.  
  44. Permission is granted to distribute the unregistered version of 
  45. RBBTIC by way of modem and electronic transfer from an individual 
  46. to a Bulletin Board Service or, from a Bulletin Board Service to 
  47. an individual, or via a non-profit file distribution network,
  48. provided the contents of the original RBBTIC program package, 
  49. to include its' support files and this documentation file, are not 
  50. altered in anyway prior to, or, during distribution. Distribution 
  51. of a registered version of RBBTIC is a clear violation of the 
  52. authors copyright and is subject to remedial action to the fullest 
  53. extent of the law.
  54.  
  55. David R. Remer disclaims all warranties as to this software, whether 
  56. express or implied, including, without limitation, any implied 
  57. warranties of merchantability, fitness for a particular purpose, 
  58. functionality, data integrity or protection.
  59.  
  60. RBBTIC is released under the Shareware concept, meaning that users of 
  61. RBBTIC are permitted to use and evaluate RBBTIC's usefulness, for a 
  62. period of 30 days from the time of acquiring RBBTIC. If the user makes 
  63. use of RBBTIC beyond the 30 day evaluation period, they are required to 
  64. register it. If the user does not wish to register their copy of RBBTIC 
  65. with the author by the end of the 30 days trial, the user is obligated 
  66. to cease using RBBTIC and delete it from their system except in an
  67. archived/compressed form for distribution purposes. 
  68.  
  69.  
  70.  
  71. ii                              REGISTRATION
  72.  
  73.         Registration is ONLY $8.00. It is worth registering.
  74.         The registered version does not require the Sysop to enter
  75.         a randomly generated number to continue RBBTIC operation.
  76.         In other words, the Registered version is fully automated.
  77.         Besides, you are an honest person who I am sure won't mind
  78.         registering both to be legal and to be fair to the author
  79.         who spent over 100's of hours writing, debugging and 
  80.         perfecting RBBTIC, a program written specifically for RBBS-PC 
  81.         sysops and, which, will save you a lot of time and effort from 
  82.         having to hand edit extended Tic file descriptions to function
  83.         in an FMS.DIR format. 
  84.  
  85.         SEE the end of this file for a registration form printout.
  86.         Thank you very much in advance for registering RBBTIC. I am
  87.         currently unemployed and struggling to make ends meet for 
  88.         my 2 year old daughter, Hannah, and myself.
  89.  
  90.         Upon receipt of your registration, I will netmail (or postal
  91.         send) your Registration number to you. You simply place it in the
  92.         appropriate place in the RBBTIC.CFG file and RBBTIC will
  93.         function in auto mode for unattended batch file operation.
  94.  
  95.  
  96.  
  97. I.                               INTRODUCTION
  98.  
  99.         RBBTIC is a program that processes incoming .TIC files and creates
  100.         an output file that is 100% compatible with RBBS-PC's FMS.DIR
  101.         format. This includes extended file descriptions in forward or
  102.         reverse order, as well as the category code for each file.
  103.         Currently, the output format for extended descriptions is in the
  104.         format of FMS.DIR's original description line (i.e. extended
  105.         descriptions begin in column 34).
  106.  
  107.  
  108.    RBBTIC Features:
  109.  
  110.         *Very easy to set up and configure
  111.  
  112.         *Handles description line lengths of 40 to 46
  113.  
  114.         *Handles word-wrap, so, no words at the end of a line will
  115.          be cutoff in the middle and continued on the next line.
  116.         
  117.         *Handles forward or reversed extended descriptions. In REVERSED,
  118.          this means Date ordered FMS.DIR's, which are read from bottom up,
  119.          will be in proper reading order for callers.
  120.  
  121.         *Handles Letter or Number FMS Category codes.        
  122.  
  123.         *Fairly extensive error handling with errors displayed with
  124.          recommendations, both to screen and a log file.
  125.  
  126.         *Registered version requires no SYSOP input and runs unattended
  127.  
  128.         *Choice of whether output is to be reviewed by sysop for file
  129.          category code editing (e.g. SDN files); or by way of bat file,
  130.          output may be directly appended to existing FMS.DIR.
  131.  
  132.         *Version 3 now renames older FMS?.APP files which may not have
  133.          been appended to the FMS.DIR file before writing the current
  134.          output FMS1.APPend file.
  135.          
  136.         *Detects absent areatags in TICK.CFG or RBBTIC.AREA file                
  137.          by putting ... in place of the FMS category code. Means
  138.          you have incoming Tick files not yet configured or 
  139.          improperly configured in TICK.CFG if that is what you 
  140.          told RBBTIC to read for areatags.
  141.  
  142.         *Registration is only $8.00. Registration number can be netmailed
  143.          to you, or sent by postal mail. (See the end of this file
  144.          for the registration form.)
  145.  
  146.         *Prompt netmail reply support for Registered Users.
  147.  
  148.  
  149.  
  150. II.                              SETUP
  151.  
  152.                       !!!!!!!! IMPORTANT !!!!!!!!!
  153.  
  154.                MAKE A BACKUP OF YOUR TICK.CFG FILE, NOW!
  155.  
  156.     Setting up RBBTIC is as easy as ABC. Follow the instructions
  157.     in sections A, B and C below. It is easier to set up than to 
  158.     explain, so if the explanations are confusing, muddle through
  159.     them then see the sample files included with RBBTIC.
  160.  
  161.  
  162.     System Requirements: IBM-PC compatible machine. A front end
  163.     mailer and Tick software already setup. I prefer to have
  164.     RBBTIC setup in my TICK sub-directory, however, you may place
  165.     it anywhere on the same drive as your Mailer Software's Inbound
  166.     directory, and, the RBBTIC.CFG and RBBTIC.EXE must be kept
  167.     together in the same Sub-directory. 
  168.     
  169.     RBBTIC.EXE MUST NOT BE 
  170.     **********************
  171.     PLACED IN THE SAME DIRECTORY THAT THE FMS1.APP OUTPUT FILE
  172.     **********************************************************
  173.     WILL BE WRITTEN TO. RBBTIC MUST BE LOCATED ON THE SAME DRIVE 
  174.     ************************************************************
  175.     AS YOUR MAILER'S INBOUND DIRECTORY!!!
  176.     *************************************
  177.        
  178.        
  179.  
  180.     A.  RBBTIC expects to find either:
  181.  
  182.          1) a fully configured TICK.CFG file (whose drive\sub-directory
  183.             and filename are indicated in the RBBTIC.CFG file, and)
  184.             whose format is similar to the following for each file
  185.             area to be processed:
  186.  
  187.              AREA F:\DL ACAD_MSC
  188.                   Local Listname d:\rbbs\dir\fmsadd.dir
  189.                   Local Listfmt %100:33%3:-12%4:9  %5:8.3  %1:-45.2 160
  190.                   Address  PW  &C
  191.  
  192.         The the crucial elements are: a) 1st line for the file echo
  193.         beginning with AREA (in all caps) and b) the LOCAL LISTFMT line
  194.         being the 3rd line down for each area and c) the FMS category code
  195.         being the last item on the LOCAL LISTFMT line. (Note: many
  196.         sysops will have a 3 letter code, instead of a 3 number code,
  197.         at the end of the LOCAL LISTFMT line, and this presents no problems.)
  198.  
  199.                                     OR
  200.  
  201.         2) A RBBTIC.AREAS file you create whose format is as follows:
  202.  
  203.              AREA **** ACAD_MSC
  204.              ******************
  205.              ****************** 160
  206.  
  207.            with the crucial features being a) that there are 3 words on
  208.            the AREA, the first being "AREA", the second single word
  209.            you want, and the areaname (filetag) is the 3rd word with a space
  210.            between each of the 3 words on the 1st line, and 2) a second 
  211.            line be present with anything typed in except leading spaces 
  212.            and 3) the 3rd line contains some characters prior to a space 
  213.            and the FMS category code on the end of the line (numbered or
  214.            lettered).
  215.  
  216.  
  217.         If Tick's Config file is at all confusing to you, I recommend
  218.         you set up the RBBTIC.AREAS files in option 2 above. 
  219.         
  220.         If you already have a TICK.CFG file setup as in example #1 above
  221.         you simply need to copy it to another "filename" for use by
  222.         RBBTIC, and enter the new path and "filename" in the RBBTIC.CFG 
  223.         file for RBBTIC's use or, RBBTIC and TICK may share the Tick.CFG
  224.         file. See the sample TICK.CFG file that came with RBBTIC.
  225.       
  226.         Since RBBTIC will now do what Tick's LOCAL LISTFMT line did, 
  227.         (but, specifically for RBBS-PC's FMS.DIR needs),  the
  228.         LOCAL LISTFMT lines in your TICK.CFG are no longer required
  229.         EXCEPT, that Tick will produce a Files.BBS file by default even
  230.         if the Local Listfmt lines are removed. Therefore, I recommend
  231.         changing the Local Listfmt lines of the TICK.CFG file and 
  232.         directing all areas that RBBTIC will now handle to one file,
  233.         which you may delete using your TickRun.Bat file after
  234.         it calls Tick. (If this sounds confusing, see the sample
  235.         TickCfg.Sam file enclosed for examples and explanations.
  236.  
  237.  
  238.     B.  Make a backup of the RBBTIC.CFG file that came with the RBBTIC
  239.         program. Then edit the RBBTIC.CFG file to reflect your particular
  240.         paths, file names and choices regarding FMS.DIR format.
  241.         The RBBTIC.CFG file should not be altered in anyway other than
  242.         replacing the existing example parameters with ones that match
  243.         your particular setup. The RBBTIC.CFG file is fully commented
  244.         with explanations for each parameter. The order of the parameters
  245.         in the RBBTIC.CFG file are crucial to the proper function of
  246.         RBBTIC. If you have any problems with the RBBTIC.CFG file or
  247.         the comments regarding it's parameters are unclear to you, please
  248.         netmail me your question or problem and I will respond
  249.         as soon as is practical.
  250.  
  251.      C. Edit the Bat file that calls up TICK so that RBBTIC IS CALLED
  252.         FIRST. I repeat, RBBTIC must be called to run before TICK
  253.         since RBBTIC will read your mailers inbound file directory
  254.         (where your mailer puts incoming Tick program and description
  255.         files when received) and use that information to complete its
  256.         tasks. If Tick is run 1st, RBBTIC will no longer be able to
  257.         get the program file's size to output for your FMS.DIR.
  258.  
  259.         In my situation, I have Tic files coming in that I do not make
  260.         available to my callers for download. Files like the Backbone
  261.         files and the Fidonet.N? files, I treat as exclusions in the 
  262.         following manner. I edit the Bat file that calls RBBTIC and then
  263.         TICK, to copy the program files (not the .TIC description files)
  264.         to a sub-directory off my Binkleyterm "IN" directory. I tell
  265.         the bat file to do this BEFORE RBBTIC is called because, by 
  266.         default, RBBTIC will not process a TIC description file if the
  267.         Program file is not in the sub-directory with it. After RBBTIC
  268.         is done and control goes back to the Bat file, I copy those
  269.         excluded program files back to my "In" directory and then the
  270.         Bat file calls TICK which processes them in the normal fashion
  271.         it always did. (See the sample bat file included with RBBTIC
  272.         named RBBTIC.BAT.)
  273.  
  274.  
  275.         The flow of my setup is diagrammed as follows:
  276.          
  277.             Mailer receives incoming Program and *.TIC files and deposits
  278.             them in the Mailers "IN" sub-directory (Lets say, F:\BT1\IN)
  279.             |
  280.             |
  281.             Mailer calls its scheduled event bat file which calls the
  282.             TICK bat file. The TICK Bat File:
  283.                    |
  284.                    |
  285.                    Copies all PROGRAM files NOT to be included in the
  286.                    FMS.DIR file, to F:\BT1\IN\TICTMP.
  287.                    |
  288.                    |
  289.                    Calls RBBTIC which creates the FMS1.APP file which
  290.                    you may review and edit or simply append to your
  291.                    FMS.DIR, complete with correctly formatted extended
  292.                    descriptions, and FMS file category codes obtained
  293.                    from either the TICK.CFG file or the RBBTIC.AREAS
  294.                    file that mimics the TICK.CFG file.
  295.                    |
  296.                    |
  297.                    Copies all excluded Program files back to the
  298.                    F:\BT1\IN sub-directory so TICK can process them.
  299.                    |
  300.                    |
  301.                    Calls TICK which tosses all the program files to 
  302.                    their respective sub-directories (i.e. RBBS-PC's
  303.                    download directory and SYSOP only program directory).
  304.                    |
  305.                    |
  306.                    Delete Tick's FMS description file.         
  307.                    |
  308.                    |
  309.             Return control back to the Mailer and await next call.
  310.                    
  311.  
  312.  
  313. III                            CREDITS
  314.  
  315. RBBS-PC Bulletin Board software contains the following credits:
  316. Copyright 1983-1992
  317.               by
  318.  
  319.               D. Thomas Mack
  320.               39 Cranbury Drive
  321.               Trumbull, Connecticut 06611
  322.  
  323.               Ken Goosens
  324.               5020 Portsmouth Road
  325.               Fairfax, Virginia 22032
  326.               DATA  #1,2,3 -- (703) 978-6360
  327.  
  328.               Doug Azzarito
  329.               2399 N.W. 30th Road
  330.               Boca Raton, Florida 33431-6212
  331.               DATA  #1 -- (407) 487-3441
  332.                     #2 -- (407) 487-3442
  333.                     
  334.  
  335.  
  336.  
  337. TICK, the File Tosser software was written and is owned by,                    
  338.                     
  339.                     Barry Geller
  340.                     Maple Shade Opus
  341.                     Copyright 1989
  342.  
  343. My warm thanks to Lars Olson and Dave Hughes for assisting 
  344. me in working out some bugs. Thanks guys.
  345.  
  346.  
  347. -----------------------------------------------------------------------------
  348.                        
  349.                     RBBTIC VERSION 3.0 REGISTRATION
  350.  
  351.  
  352.         Please mail this form with your $8.00 registration fee to:
  353.  
  354.  
  355.                         David R. Remer
  356.                         The Morning Sun BBS
  357.                         13126 Maple Park
  358.                         San Antonio, Tx. 78249
  359.  
  360.         
  361.  
  362.         
  363.         Date:_____________
  364.         
  365.         
  366.         Your Name: ___________________________________
  367.  
  368.         
  369.         Your mailing address or phone number ______________________________
  370.  
  371.  
  372.         Your Fidonet or RBBS-Net address: (e.g. 1:387/697) ________________
  373.  
  374.  
  375.         If you do not have a Netmail address, your registration number
  376.         will be mailed to you. Be sure your mailing address is complete
  377.         and accurate.
  378.  
  379.  
  380.         My 2 year old daughter, Hannah and I thank you very, very
  381.         much for registering your copy of RBBTIC. 
  382.  
  383.  
  384. -----------------------------------------------------------------------------
  385.