home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MFB11.ZIP / MAKEFB.DOC < prev    next >
Encoding:
Text File  |  1994-01-06  |  5.5 KB  |  164 lines
  1.  
  2.  
  3.                                   M A K E F B
  4.  
  5.                                       v1.1
  6.  
  7.                       (c) Copyright 1993/94 Online Systems
  8.  
  9.  
  10. WARNING:  Use this software at your own risk.  The ONLY guarantee is that it
  11. works on the author's system.  We will not be responsible for damage to or loss
  12. of anything arising from your use of this program.  If you use it, you accept
  13. the risk.  It works here.
  14.  
  15. MAKEFB is FREEWARE.  There is no charge for use of this program.  All I ask is
  16. that if you use it and like it, please send me a netmail message.  It's nice to
  17. know if someone out there is actually liking and using something I've written.
  18.  
  19. Please do not delete, add, or alter the distribution archive in any way.  Files
  20. included in the distribution archive are:
  21.  
  22.            MAKEFB.CFG - a sample configuration file
  23.            MAKEFB.DOC - this documentation file
  24.            MAKEFB.EXE - the executable program
  25.            WHATSNEW   - a list of changes made since the previous version
  26.  
  27. MAKEFB is a Maximus utility that will create a batch file to run Maximus's File
  28. Build (FB.EXE) utility based on received TIC files.  It is a DOS program but
  29. works fine here in a DOS session under OS/2.
  30.  
  31. If you have a lot of file areas and/or they have a lot of files in them, it can
  32. take quite a while for Maximus's File Build utility (FB.EXE or FBP.EXE) to
  33. update the complete index after receiving new files via TICK in just a couple
  34. of areas.  Instead of having to run FB.EXE on all areas after receiving inbound
  35. TIC files, MakeFb will figure out which file areas the inbound TICs go with and
  36. create a batch file that will run FB.EXE on only those areas that have been
  37. updated with new files.
  38.  
  39. You must run MakeFb BEFORE running TICK (or other TIC compatible software).
  40. MakeFb is run using a configuration file.  The default name of the
  41. configuration file is MAKEFB.CFG in the current directory.  If you want to run
  42. MAKEFB from a different directory, or with a different configuration file name,
  43. then you can use the /C command line switch to specify the path and name of the
  44. file.
  45.  
  46.                                CONFIGURATION FILE
  47.                                ==================
  48.  
  49. An example configuration file (MAKEFB.CFG) is included in the distribution
  50. archive.  MAKEFB will ignore any line in the configuration file that does not
  51. start with a valid keyword.  Valid keywords are as follows:
  52.  
  53. FileBuild <drive:\path\filename.ext>
  54. ------------------------------------
  55.  
  56.   The "FileBuild" configuration keyword tells MAKEFB the name (and optional
  57.   path) of the program to write in the bat/cmd file that will run your file
  58.   build utility.  The file build utility comes as part of the Maximus CBCS
  59.   v2.xx package. For DOS systems it is called FB.EXE, and for OS/2 systems it
  60.   is called FBP.EXE.
  61.  
  62.   ie: FileBuild C:\Max\Fb.Exe
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Inbound <drive:\path\directory>
  71. -------------------------------
  72.  
  73.   The "Inbound" configuration keyword tells MAKEFB the location of your inbound
  74.   directory.  This is the directory that contains the TIC files right after you
  75.   have received them.
  76.  
  77.   ie: InBound C:\Inbound
  78.  
  79. Tick <drive:\path\filename.ext>
  80. -------------------------------
  81.  
  82.   The "Tick" configuration keyword tells MAKEFB the name (and optional path) of
  83.   your Tick configuration file.  If not specified, this will default to TIC.CFG
  84.   in the current directory.
  85.  
  86.   ie: Tick C:\Tick\Tic.Cfg
  87.  
  88. AreaDat <drive:\path\filename.ext>
  89. ----------------------------------
  90.  
  91.   The "AreaDat" configuration keyword tells MAKEFB the name (and optional path)
  92.   of your Maximus AREA.DAT file; the compiled version of your area definitions.
  93.   If not specified, this will default to AREA.DAT in the current directory.
  94.  
  95.   ie: AreaDat C:\Max\Area.Dat
  96.  
  97. Batch <drive:\path\filename.ext>
  98. --------------------------------
  99.  
  100.   The "Batch" configuration keyword tells MAKEFB the name (and optional path)
  101.   of the bat or cmd file you want to create.  For DOS systems using FB.EXE, use
  102.   a BAT extension.  For OS/2 systems using FBP.EXE, use a CMD extension.  If
  103.   not specified, this will default to RUNFB.BAT in the current directory.
  104.  
  105.   Batch C:\Max\RunFb.Bat
  106.  
  107. Log <drive:\path\filename.ext>
  108. ------------------------------
  109.  
  110.   The "Log" configuration keyword tells MAKEFB the name (and optional path) of
  111.   the MakeFb log file.  If not specified, this will default to MAKEFB.LOG in
  112.   the current directory.
  113.  
  114.   ie: Log C:\Tick\MakeFb.Log
  115.  
  116. Level <number>
  117. --------------
  118.  
  119.   The "Level" configuration keyword tells MAKEFB how much information to place
  120.   in the log file.  Valid numbers are 1, 2, and 3.  A level of 3 will give the
  121.   most information.  A level of 1 will give the least information.  A level of
  122.   2 is right in between.  If not specified, this will default to a level of 3.
  123.  
  124.   ie: Level 3
  125.  
  126.  
  127. If an error occurs while running MAKEFB or there were no areas to create a
  128. batch file with, MAKEFB will exit with dos errorlevel 1.  If MAKEFB makes a
  129. successful run it will exit with dos errorlevel 0.
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. An example of using MakeFb is as follows:
  137.  
  138. MAILER.BAT
  139. ==================================
  140. .
  141. .
  142.  
  143. :File-In
  144.   If Exist \Inbound\*.Tic Call Tic-In
  145.   .
  146.   .
  147.   .
  148. ==================================
  149.  
  150.  
  151. TIC-IN.BAT
  152. ==================================
  153. @Echo Off
  154. C:
  155. Cd \Tick
  156. MakeFb /cMakeFb.Cfg
  157. Tick >>Tick.Log
  158. Cd \Max
  159. If Exist RunFb.Bat Call RunFb
  160. ==================================
  161.  
  162. Comments, suggestions, bugs?  Netmail to: Wayne Thomson 1:267/154.0@fidonet.org
  163.  
  164.