Beijing Paradise BBS Backup/PARADISE.ISO/software/BBSDOORW/MFB11.ZIP/MAKEFB.DOC

Text File | 1994-01-06 | 6KB | 164 lines

                                  M A K E F B

                                      v1.1

                      (c) Copyright 1993/94 Online Systems


WARNING:  Use this software at your own risk.  The ONLY guarantee is that it
works on the author's system.  We will not be responsible for damage to or loss
of anything arising from your use of this program.  If you use it, you accept
the risk.  It works here.

MAKEFB is FREEWARE.  There is no charge for use of this program.  All I ask is
that if you use it and like it, please send me a netmail message.  It's nice to
know if someone out there is actually liking and using something I've written.

Please do not delete, add, or alter the distribution archive in any way.  Files
included in the distribution archive are:

           MAKEFB.CFG - a sample configuration file
           MAKEFB.DOC - this documentation file
           MAKEFB.EXE - the executable program
           WHATSNEW   - a list of changes made since the previous version

MAKEFB is a Maximus utility that will create a batch file to run Maximus's File
Build (FB.EXE) utility based on received TIC files.  It is a DOS program but
works fine here in a DOS session under OS/2.

If you have a lot of file areas and/or they have a lot of files in them, it can
take quite a while for Maximus's File Build utility (FB.EXE or FBP.EXE) to
update the complete index after receiving new files via TICK in just a couple
of areas.  Instead of having to run FB.EXE on all areas after receiving inbound
TIC files, MakeFb will figure out which file areas the inbound TICs go with and
create a batch file that will run FB.EXE on only those areas that have been
updated with new files.

You must run MakeFb BEFORE running TICK (or other TIC compatible software).
MakeFb is run using a configuration file.  The default name of the
configuration file is MAKEFB.CFG in the current directory.  If you want to run
MAKEFB from a different directory, or with a different configuration file name,
then you can use the /C command line switch to specify the path and name of the
file.

                               CONFIGURATION FILE
                               ==================

An example configuration file (MAKEFB.CFG) is included in the distribution
archive.  MAKEFB will ignore any line in the configuration file that does not
start with a valid keyword.  Valid keywords are as follows:

FileBuild <drive:\path\filename.ext>
------------------------------------

  The "FileBuild" configuration keyword tells MAKEFB the name (and optional
  path) of the program to write in the bat/cmd file that will run your file
  build utility.  The file build utility comes as part of the Maximus CBCS
  v2.xx package. For DOS systems it is called FB.EXE, and for OS/2 systems it
  is called FBP.EXE.

  ie: FileBuild C:\Max\Fb.Exe







Inbound <drive:\path\directory>
-------------------------------

  The "Inbound" configuration keyword tells MAKEFB the location of your inbound
  directory.  This is the directory that contains the TIC files right after you
  have received them.

  ie: InBound C:\Inbound

Tick <drive:\path\filename.ext>
-------------------------------

  The "Tick" configuration keyword tells MAKEFB the name (and optional path) of
  your Tick configuration file.  If not specified, this will default to TIC.CFG
  in the current directory.

  ie: Tick C:\Tick\Tic.Cfg

AreaDat <drive:\path\filename.ext>
----------------------------------

  The "AreaDat" configuration keyword tells MAKEFB the name (and optional path)
  of your Maximus AREA.DAT file; the compiled version of your area definitions.
  If not specified, this will default to AREA.DAT in the current directory.

  ie: AreaDat C:\Max\Area.Dat

Batch <drive:\path\filename.ext>
--------------------------------

  The "Batch" configuration keyword tells MAKEFB the name (and optional path)
  of the bat or cmd file you want to create.  For DOS systems using FB.EXE, use
  a BAT extension.  For OS/2 systems using FBP.EXE, use a CMD extension.  If
  not specified, this will default to RUNFB.BAT in the current directory.

  Batch C:\Max\RunFb.Bat

Log <drive:\path\filename.ext>
------------------------------

  The "Log" configuration keyword tells MAKEFB the name (and optional path) of
  the MakeFb log file.  If not specified, this will default to MAKEFB.LOG in
  the current directory.

  ie: Log C:\Tick\MakeFb.Log

Level <number>
--------------

  The "Level" configuration keyword tells MAKEFB how much information to place
  in the log file.  Valid numbers are 1, 2, and 3.  A level of 3 will give the
  most information.  A level of 1 will give the least information.  A level of
  2 is right in between.  If not specified, this will default to a level of 3.

  ie: Level 3


If an error occurs while running MAKEFB or there were no areas to create a
batch file with, MAKEFB will exit with dos errorlevel 1.  If MAKEFB makes a
successful run it will exit with dos errorlevel 0.






An example of using MakeFb is as follows:

MAILER.BAT
==================================
.
.

:File-In
  If Exist \Inbound\*.Tic Call Tic-In
  .
  .
  .
==================================


TIC-IN.BAT
==================================
@Echo Off
C:
Cd \Tick
MakeFb /cMakeFb.Cfg
Tick >>Tick.Log
Cd \Max
If Exist RunFb.Bat Call RunFb
==================================

Comments, suggestions, bugs?  Netmail to: Wayne Thomson 1:267/[e-mail]