home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / RBTCH242.ZIP / EXTRA.ZIP / TIC2DOZ.ZIP / TIC2DOZ.DOC next >
Text File  |  1993-05-15  |  9KB  |  244 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                       ------------------------------------
  22.                       TIC2DOZ - A .TIC file processor for
  23.                        the RBatch file processing system
  24.                       ------------------------------------
  25.  
  26.  
  27.  
  28.  
  29.                               TIC2DOZ  Version 1.00
  30.                                    May 15, 1993
  31.                              (C) by Dan Shore - 1993
  32.                               By: Dan Shore - SYSOP
  33.                                 THE SHORELINE BBS
  34.                                  (301)  946-2771
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46. A:   What is TIC2DOZ.EXE
  47. ------------------------
  48. TIC2DOZ is a program that will prepare a .DOZ and a DSZLOG file so
  49. RBatch can process the files and post them to your BBS AUTOMATICALLY
  50. and UNATTENDED when your .TIC files arrive.  You can check each file
  51. through your own batch file testing with RBatch, and have the category
  52. and file description (even extended descriptions) posted to your
  53. FMS or .DIR file system.
  54.  
  55.  
  56. A-1:  What is a DSZLOG?
  57. -----------------------
  58. This is a file just like your XFER-?.DEF file that RBBS checks for
  59. file transfer success (you never can find one due to RBBS deleting
  60. the file after it checks it).  TIC2DOZ will create this file for RBatch,
  61. so RBatch can determine which files to process (check and post).  The
  62. name and location of this file (which should match the entry in your
  63. RBatch.Cfg file) is specified with the 2nd parameter on the TIC2DOZ
  64. command line.
  65.  
  66.  
  67. A-2:  What is a .DOZ file?
  68. --------------------------
  69. Without going into a long explaination about a .DOZ file since it is
  70. described in the RBatch distribution package (see WHATISA.DOZ), it
  71. basically is a text file with the FILENAME, CATEGORY CODE, & FILE
  72. DESCRIPTION in a special format for RBatch to read.
  73.  
  74. NOTE:  The default filename is TIC.DOZ but you can override this
  75.        by using the 3rd parameter on the command line.  See command
  76.        line syntax below.
  77.  
  78. MAKE SURE THAT THE .DOZ FILE IS IN THE SAME DIRECTORY AS THE FILES
  79. THAT ARE BEING PROCESSED BY RBATCH!!!  Here are some examples:
  80.  
  81. A.  If you run TIC2DOZ and RBatch BEFORE TIC then the directory to
  82.     create the .DOZ file in is the same directory as where your
  83.     incoming files are located in.
  84.  
  85. B.  If you run TIC2DOZ and RBatch AFTER TIC then the directory to
  86.     create the .DOZ file in is the same directory as where your
  87.     files get moved by TIC (usually the upload directory).
  88.  
  89.  
  90.                               - 2 -
  91.  
  92.  
  93. A-3:  What if the file has a FILE_ID.DIZ or DESC.SDI?
  94. -----------------------------------------------------
  95. After running TIC2DOZ, the .DOZ file will contain the description that
  96. was supplied in the .TIC file.  If the actual file contains a FILE_ID.DIZ
  97. or DESC.SDI then RBatch will post the file description from the .DIZ
  98. or .SDI instead of the .DOZ.  This means that you get the authors full
  99. description INSTEAD of the single line descriptions that are found in
  100. .TIC files.
  101.  
  102.  
  103. B:  TIC2DOZ Command Line Syntax
  104. -------------------------------
  105. The TIC2DOZ program is command line driven with the following syntax:
  106.  
  107. TIC2DOZ <Path/Filename of TIC.CFG>                ALL COMMAND LINE
  108.         <Path/Filename of FakeXfer to create>     PARAMETERS ARE ON
  109.         <Path/Filename of .DOZ to create>         THE SAME LINE!!!!
  110.                                                   See Below
  111.  
  112. Here is an example:
  113.  
  114. TIC2DOZ C:\RBBS\TIC\TIC.CFG C:\JUNK\TICXFER.DEF D:\UPLOADS\TIC.DOZ
  115.                 ^^^                ^^^                 ^^^
  116.                  A                  B                   C
  117.  
  118.  
  119. A.  This is the path/filename of your TIC.CFG file.  From this file
  120.     I will get the path to the .TIC files from the firstline
  121.     (Generally the "IN" parameter of this file).  I will also get
  122.     the AREANAMES from the AREA line and I will get the category
  123.     code from the line LOCAL LISTFMT.  If you do not have your
  124.     categories on the LOCAL LISTFMT line then the files will not
  125.     get categorized properly.  (If there is another format to .TIC
  126.     that I am not aware of for the categories, please let me know)
  127.  
  128. B.  This is the path/filename of the fakexfer to create.  This is the
  129.     filename that you should use in your RBatch.Cfg file in place of
  130.     the XFER-?.DEF path/filename.  Remember RBatch READS this file to
  131.     determine what files to process.  This fakexfer file is generated
  132.     from the filenames given within the .TIC files.
  133.  
  134. C.  [ OPTIONAL PARAMETER!!!! ] - If you specify something in this position
  135.     TIC2DOZ will make the .DOZ file in this specified directory INSTEAD
  136.     of the same directory as the .TIC's and files.  (same directory that
  137.     is listed as your IN specified in your TIC.CFG).  Why would you want
  138.     to use this parameter?  Good question - it depends on how you want
  139.     to process your .TIC files.
  140.  
  141.  
  142.                               - 3 -
  143.  
  144.  
  145. B-1: RBatch command line when using TIC2DOZ
  146. -------------------------------------------
  147. When running RBatch with .TIC files, you have to inform RBatch of this
  148. with a command line switch.  Here is an example of a "standard" RBatch
  149. command line and then one that is processing .TICs
  150.  
  151. Standard:
  152. ---------
  153. RBatch Rbatch.Cfg %1 %4 %3
  154.  
  155. .TIC Processing:
  156. ----------------
  157. RBatch Rbatcht.Cfg %1 %4 %3 TIC
  158.  
  159.   *****
  160.   Note: The word TIC is the last parameter on the command line.
  161.   *****
  162.  
  163.  
  164. C:  Which do I run first RBatch or TIC?
  165. ---------------------------------------
  166. 1.  If you want to have the CRC checking be done by TIC then you
  167.     should run RBatch AFTER YOU RUN TIC, hence you want the .DOZ
  168.     file to be in the same directory that you have the files moved
  169.     to by TIC (most of the time this is your BBS upload dir).  If
  170.     TIC moves files to DIFFERENT DIRECTORIES, then you will have
  171.     to use step 2 here, since the files are not in one directory.
  172.  
  173. 2.  If you wish RBatch to check the files BEFORE RUNNING TIC, then
  174.     you need not use the third parameter on the command line.
  175.  
  176.     If you execute TIC after RBatch, and your batch files "modify"
  177.     your files (ie.  converting, rezipping, adding zip comments,
  178.     etc.) then you want to run TIC FIRST.  If you change the
  179.     compression type of the file TIC will not move the file, so
  180.     make sure you run TIC first, then TIC2DOZ, then RBatch.
  181.  
  182.     NOTE:  Both ways work and it is up to you to decide which
  183.            is best suited for your setup.
  184.  
  185.  
  186. D:  Warranty and Disclaimer
  187. ---------------------------
  188. THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  189. INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  190. PURPOSE.  THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
  191. PROGRAM IS ASSUMED BY YOU.  FURTHERMORE, I THE AUTHOR DO NOT WARRANT,
  192. GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE
  193. RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN WITHOUT
  194. ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR OWN RISK.
  195. I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF
  196. PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  197. RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT.
  198.  
  199.                               - 4 -
  200.  
  201.  
  202. E:  Problems that may arise:
  203. ----------------------------
  204. I do not run a system that is on a file network, hence I do not
  205. use .TIC files.  I have had to rely on the beta testers of this
  206. program to inform me of any mistakes in assuming things with TIC.
  207. Please let me know of other setups that I do not support.
  208.  
  209.  
  210. F: Support:
  211. -----------
  212. If you do encounter any problems with the program, or have suggestions
  213. on improvements, you can call my BBS 24 hrs a day, and leave a message
  214. for me, or leave a message on the RIME Network in the RBBS conference,
  215. or in the RBBS-PC conference on the RBBS-NET Network.  I get this
  216. echo through my FIDO feed.  I will consider the enhancements and of
  217. course try to fix any problems encountered with the program.
  218.  
  219. Note that I support both Registered and Non-Registered users of the
  220. program.  Support is a NUMBER ONE priority for me and my programs,
  221. and I think you will be impressed with the support that I give.  You
  222. are welcome to call me voice if you have any problems between 7-10:00pm
  223. weekdays and between 9am-10pm on the weekends.
  224.  
  225.  
  226. My BBS name & number:
  227.  
  228.                               Dan Shore
  229.                           "THE SHORELINE BBS"
  230.                      Located in Silver Spring, MD
  231.                           3/12/24/9600/14.4k
  232.                              301-946-2771
  233.  
  234.                           Proud Member of the
  235.                      - DGS Systems Group (Wonder) -
  236.                          RBBS-PC  Beta Test Site
  237.  
  238.                          Proudly Running RBBS-PC
  239.                    "The Best BBS Software in the World"
  240.  
  241.                      Member of the RIME & FIDO Network
  242.                          RelayNet ID = SHORELINE
  243.                           FIDO Net#  = 1:109/458
  244.