home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / BFE3100P.ZIP / BFE3100P.EXE / DOCS / SETUP.DOC < prev    next >
Text File  |  1994-03-12  |  34KB  |  813 lines

  1.  
  2. ─────────────────────────────────────────────────────────────────────────────
  3.                      ▄   ▄▄▄ ▄▄▄     ▄▄▄ ▄▄▄  ▄  ▄ ▄ ▄▄▄
  4.                      █▄▄ █▄  █▄█     █▄▄ █▄█ ▀█▀ █ █ █▄█
  5.                      █▄█ █   █▄▄     ▄▄█ █▄▄  █▄ █▄█ █
  6.  
  7. ─────────────────────────────────────────────────────────────────────────────
  8.  
  9.                            What is BFE/Setup?
  10.  
  11. As mentioned earlier in this document, BFE/Setup was designed to provide an
  12. intuitive, easy-to-use method of configuring and customizing BFE to suit your
  13. needs.  A lot of time has been spent on ensuring that BFE/Setup provides you
  14. with the tools necessary to allow you to maximize your use of the BFE
  15. package.
  16.  
  17. In earlier releases of BFE, all of the options and functionality of the
  18. package was configured via the manual editing of numerous control and
  19. configuration files.  This was often very tedious work for the aspiring
  20. sysop, and many begged for something easier.  Once again, we have listened to
  21. our users and have provided an easy-to-use, menu-driven setup facility
  22. entitled BFE/Setup. Through the use of this revolutionary new setup system,
  23. sysops can now configure and customize their BFE system with little or no
  24. effort at all.
  25.  
  26.                           NAVIGATIONAL CONTROLS
  27.  
  28. BFE/Setup will automatically make use of a mouse if one is detected.  By
  29. default, it runs in standard 16 color mode, but can be forced into monochrome
  30. mode by passing a "-m" on the command line (i.e. BFESETUP -m).
  31.  
  32. To start BFE/Setup, simply type BFESETUP while in the BFE directory.
  33.  
  34. Left mouse button used as "select" button, while right mouse button is used
  35. as the "ESC" button.
  36.  
  37.                           THE .CTL FILE SCHEME
  38.  
  39. Before you begin your first session with BFE/Setup, a brief overview on
  40. the .CTL file scheme utilized by BFE is in order.  The contents of each of the
  41. menus you will create with BFE/Setup are stored in a CONTROL file (files with
  42. a .CTL extension).  When BFE is started, you will pass the name of your
  43. "main" .CTL file on the command line.  This is the menu that BFE will first
  44. prompt your users with.  From there, however, based on user selections, you
  45. can jump to other menus (up to 10 levels of nesting).
  46.  
  47. All global system settings (Sysop information, global color settings, etc)
  48. are stored in your Global Configuration file, which defaults to GLOBALS.CFG.
  49. If, for some reason, you wish to use a different name, you may pass this
  50. filename on the command line of BFE/Setup by using the "-g" option.
  51.  
  52.         Example: BFESETUP.EXE -gMYBBS.CFG
  53.  
  54. This would be useful if you run BFE as a front end, as well as a door from
  55. your BBS, and have different settings for each.
  56.  
  57. That's it!  No voodoo involved in this concept at all.  In fact, this is not
  58. a new concept, as this is the way that most BBS systems function anyway!
  59.  
  60.  
  61.                      OPENING AND CREATING .CTL FILES
  62.  
  63. To create new .CTL files or open existing ones for maintenance, simply select
  64. "Open .CTL File" from the main menu.  A popup box will soon appear, prompting
  65. you for the type of .CTL to open (i.e. new or existing).
  66.  
  67. If you choose to create a new .CTL file, you will then be prompted for the
  68. name of the control file.  You need not enter an extension, as .CTL will be
  69. appended to the name you enter.  We recommend you name your .CTL files in
  70. some sensible manner, perhaps using the name MAIN as your first menu.
  71.  
  72. If you choose to open an existing .CTL file, a file selector box will appear,
  73. and you may then traverse the directory structure of your system in order to
  74. find the appropriate .CTL file to open.
  75.  
  76. After providing a new .CTL file name, or choosing an existing one, the name
  77. of this file will appear at the top of the main menu window, to help you keep
  78. track of which file is in memory at any given time.
  79.  
  80.  
  81.                           SAVING .CTL FILES
  82.  
  83. After making any changes to your .CTL files, you will need to select this
  84. option to save them permanently.  Simply select this option, and your menu
  85. will be updated for you in the blink of an eye!
  86.  
  87.  
  88.                              NODE MACRO
  89.  
  90. A special macro is available for use in most fields.  This macro will be
  91. substituted at runtime for the appropriate value.  Simply place a "%n" or
  92. "%N" to force BFE to provide the node number of the current node.  By using
  93. this macro, it makes it easier to implement different menus, screens, etc
  94. for larger multiline BBS systems.
  95.  
  96.  
  97.                             GLOBAL OPTIONS
  98.  
  99. Your first stop in BFE/Setup should be here, as this is where you will
  100. configure BFE with all of its internal default options.  All global options
  101. are stored in a file called GLOBALS.CFG.  After selecting this option from
  102. the main menu, you will be presented with the Global Options Menu:
  103.  
  104.  
  105.                       PATH/SWAPPING CONFIGURATION
  106.  
  107. DROPFILE PATH
  108.  
  109. This field, when filled in, enables BFE's internal BBS dropfile routines.
  110. If you are running BFE as a front-end from a mailer such as FrontDoor or
  111. BinkleyTerm, you should leave this field blank!  Only fill this field in when
  112. you wish BFE to operate by reading a BBS dropfile (DORINFO1.DEF, DOOR.SYS,
  113. etc).  See the section on using BFE with BBS dropfiles for more information
  114. on the automatic dropfile recognition system used in BFE.
  115.  
  116. BFE SYSTEM DIR
  117.  
  118. This should point to your BFE directory.  Plain and simple.
  119.  
  120. LOGFILE
  121.  
  122. If this field is filled in, BFE will maintain a log of events in the path and
  123. filename specified by its contents.  To disable BFE's internal logging,
  124. simply leave this field blank.  The logfile is in the same format used by
  125. Joho's FrontDoor Netmailer.  A special macro (%N) is available to specify the
  126. node number for multinode systems.  For instance "BFE%N.LOG", would create a
  127. logfile called BFExxx.LOG, where "xxx" is the node number.
  128.  
  129. WELCOME SCREEN
  130.  
  131. BFE has the ability to display an ANSI, ASCII, AVATAR, or RIP screen to your
  132. users upon startup.  Simply specify the path and filename of this file.  BFE
  133. has a few unique features when displaying external files to your users!  See
  134. the section on the DISPLAY FILE type for more information.
  135.  
  136. SWAP PATH
  137.  
  138. BFE has the ability to make use of memory and disk swapping when calling
  139. external processes.  By default, BFE will attempt to swap itself to EMS, but
  140. will resort to disk swapping should not enough memory be available.
  141.  
  142. This field should contain a list of valid swap paths, separated by commas
  143. (i.e. C:\TEMP;D:\TEMP;E:\SWAP ).
  144.  
  145. SWAP WITH EMS?
  146.  
  147. To prevent BFE from swapping to EMS, place a "N" in this field.
  148.  
  149. EXTERNAL EDITOR
  150.  
  151. Currently, two of the selections from BFE/Setup are configured through the
  152. use of an external editor (the Custom Dropfile Editor and the BFE Language
  153. Editor).  These will eventually be permanent residents of
  154. BFE/Setup, but for now, simply place the path and name of your favorite
  155. external text editor.
  156.  
  157. LOGON SCREEN
  158.  
  159. If you are using the internal BFE user system, this field should point to the
  160. full path/base filename of a screen to be shown at login.  In the typical BFE
  161. system, this should describe your system.
  162.  
  163. NEWUSER SCREEN
  164.  
  165. If you are using the internal BFE user system, this field should point to the
  166. full path/base filename of a screen to be shown to new users who have logged
  167. in to BFE for the first time.  This screen is shown after
  168. they enter their name and location, but right before they enter their
  169. password.
  170.  
  171.                            PAGER/PASSWORDS
  172.  
  173. One of the things that BFE allows your users to do is "page" the sysop for a
  174. chat session.  This menu selection allows you to specify the hours and days
  175. that chatting is available.
  176.  
  177. CONFIGURING PAGING HOURS
  178.  
  179. Once you enter this selection, you will be presented with a small entry form
  180. which has two entries per day-of-the-week.  Simply fill in the hours in which
  181. paging will be available (in 24 hour military format).  To disable paging for
  182. a given day, enter 00:00 for the starting time, and 00:01 for the stopping
  183. time.
  184.  
  185. NUMBER OF BEEPS
  186.  
  187. Whenever the sysop is paged, BFE will present a series of beeps on the PC
  188. speaker, to attempt to gain the attention of the sysop.  This setting
  189. controls the number of beeps that BFE will perform during a page attempt.
  190.  
  191. PASSWORD ATTEMPTS
  192.  
  193. When faced with a BFE password prompt, the number of attempts they are given
  194. to supply a valid password is governed by the value of this field.
  195.  
  196. HANG UP ON USER?
  197.  
  198. If a user fails to enter a valid password within the specified number of
  199. attempts (above), should BFE hang up on the user ("Y"), or simply return
  200. him/her to the BFE menu system ("N").
  201.  
  202.  
  203.                         CUSTOM DROPFILE EDITOR
  204.  
  205. Custom door information file support. BFE automatically recognizes most door
  206. information file (drop file) formats, including DORINFO?.DEF, EXITINFO.BBS,
  207. DOOR.SYS, SFDOORS.DAT, CALLINFO.BBS and CHAIN.TXT. However, to permit BFE to
  208. operate on BBS systems that produce a different format file, you may define a
  209. custom door information file format. A custom door information file format
  210. can be defined in a file called CUSTOM.BFE.  When BFE starts, this file is
  211. read in and a dynamic dropfile type is created and looked for by BFE.  BFE
  212. will enable dropfile mode if it finds a valid custom dropfile.
  213.  
  214. The "CustomFileName" option specifies the filename used to distinguish this
  215. file format from other file formats. This filename should not include a path.
  216. To specify the path where the door information file is located, use the
  217. BBSDir setting, near the beginning of this file. If the filename of the
  218. custom format is the same as that of one of the built-in formats, the custom
  219. format will override the built-in format.
  220.  
  221. See the BFE Reference Section on "Custom Dropfiles" for more information on
  222. the format used.
  223.  
  224.  
  225.                        FILE LIST/CHAT COLOR DEFAULTS
  226.  
  227. Select this option to setup the default color scheme to be used when in a
  228. chat session with a user.  There are also options to configure the various
  229. colors used to display a BFE style FILES.BBS file listing.
  230.  
  231.                           BFE MENU COLOR DEFAULTS
  232.  
  233. If using the built-in BFE menu style, you may want to change the default
  234. color scheme used to display the menus.  Unless a specific override has been
  235. enabled in either MENU OPTIONS or a COLOR OVERRIDE on a particular menu
  236. option, the colors defined here will be used to display all menus.  It is
  237. suggested to go ahead and set these colors to the colors which will be used
  238. in most of your menus.  This makes maintenance a bit easier!
  239.  
  240.                            MISCELLANEOUS OPTIONS
  241.  
  242. SYSOP NAME
  243.  
  244. The contents of this field should match *exactly* with the name that you
  245. have/are planning to register BFE with!  This field is case-sensitive!
  246.  
  247.  
  248. SYSTEM NAME
  249.  
  250. This field is purely an informational field, and should contain the name of
  251. your BBS system or communications site.
  252.  
  253. NODE #
  254.  
  255. Enter the node number of your BBS (i.e. 1, 2, 3), or leave blank if running
  256. on a multinode BBS system.
  257.  
  258. REGISTRATION #
  259.  
  260. Upon registering BFE, you will receive a key number which should be entered
  261. into this field.
  262.  
  263. BFE/PERSONALITY
  264.  
  265. There are several options available to the Sysop while the user is in the BFE
  266. Door.  These options and hotkeys differ from BBS "personality" to
  267. "personality".  BFE currently supports three BBS personalities (WildCat!,
  268. RemoteAccess 2.0x, and the default style).  For more information on the RA
  269. and WildCat! hotkeys, consult the documentation which accompanied the BBS
  270. software.  The sysop keys for the default personality are outlined later in
  271. this manual.  Valid values are (RA, WC, or DF).
  272.  
  273. TIMELIMIT
  274.  
  275. This is the default BFE time limit given to all callers.  If you are not
  276. running BFE via a bbs dropfile, BFE has no way of knowing how much time the
  277. user has online!  Specify the amount in minutes.
  278.  
  279. INACTIVITY TIMEOUT
  280.  
  281. This value specifies the amount (in seconds) that BFE will allow a user to
  282. sit idle at the keyboard before hanging up.
  283.  
  284. FREEZETIME
  285.  
  286. When BFE calls protocols and other external tasks, you can have the user's
  287. remaining time temporarily "frozen", which means no time will be taken away
  288. while in an external task of any kind.
  289.  
  290. LOCKED BPS
  291.  
  292. If running with a locked serial port, specify the locked baud rate of your
  293. system here.
  294.  
  295. FOSSIL PORT
  296.  
  297. Enter the port number (0, 1, 2, etc) that your fossil driver is active on.
  298.  
  299. USER SYSTEM?
  300.  
  301. If you wish to make use of the internal BFE user system, this field should be
  302. set to "Y".  See the section entitled "BFE User System" for more information
  303. on implementing the user system.
  304.  
  305. SCROLLER DELAY
  306.  
  307. This setting is used to adjust the speed of the scrolling message at the top
  308. of the BFE/Setup display area.  Setting this to a value of 0 will effectively
  309. disable the scroller.
  310.  
  311. HIDE PASSWORDS IN MENU EDITOR?
  312.  
  313. If enabled ("Y"), BFE/Setup will "mask" all passwords as they are being
  314. entered into the menu builder.  This is great if you do not wish for someone
  315. to look over your shoulder while you are entering the password!
  316.  
  317.  
  318.                               STARTUP OPTIONS
  319.  
  320. AUTO DETECT ANSI?
  321.  
  322. To have BFE attempt to automatically detect whether or not the user is
  323. running an ANSI capable terminal, enter a "Y" in the field, or a "N" to
  324. disable this feature.  If this option is disabled, the default graphics
  325. mode will be ASCII/TTY.
  326.  
  327. AUTO DETECT RIP?
  328.  
  329. To have BFE attempt to automatically detect whether or not the user is
  330. running a terminal capable of emulating the RIP graphics protocol, enter a
  331. "Y" in this field, or a "N" to disable this feature.  If you do not plan on
  332. supporting RIP on your system, you should disable this feature, as it takes a
  333. second or two up front.
  334.  
  335. STARTUP SCRIPT
  336.  
  337. BFE has the ability to execute a "startup script" when the user connects. The
  338. startup script will be shown after the user logs on (if you are using the BFE
  339. user system), and after the welcome screen is displayed, but before they hit
  340. the first .CTL file menu.  Simply enter the path and/or filename of the
  341. script in this field.  Leave the field blank to disable this feature.
  342.  
  343.  
  344. EXIT SCRIPT
  345.  
  346. BFE has the ability to execute an "exit script" when the user logs off
  347. normally (i.e. the Goodbye command).  Simply enter the path and/or filename
  348. of the script in this field.  Leave the field blank to disable this
  349. feature.
  350.  
  351. RE-ENTRY SCRIPT
  352.  
  353. If BFE is started up in "re-entry" mode by using the -r switch on the command
  354. line, it will attempt to execute this script in lieu of the normal startup
  355. script listed above.  Simply enter the path and/or filename of the script in
  356. this field.  Leave the field blank to disable this feature.
  357.  
  358. PRIVATE ENTRY SYSTEM
  359.  
  360. How many times have you been down at the office, or over at a friend's house,
  361. and needed to connect to your system ASAP?  Once again, we listened to our
  362. users, and voila! The BFE Private Entry System!  Through the use of this
  363. feature, you can configure BFE with a "system entry password", between
  364. certain hours of certain days of the week.  Simply enter the starting time
  365. and ending time for the Private Entry System next to the appropriate day of
  366. the week.  The system entry password can also be configured at this screen.
  367. To disable the Private Entry System for a particular day of the week, simply
  368. enter a value of zero (0) for the starting and ending times.  All times are
  369. in 24 hour military format!
  370.  
  371. When the BFE Private Entry system is in effect, BFE will attempt to display
  372. a file called PVTENTRY.??? (ASC/ANS/AVT - no RIP!).  This file should be used
  373. to explain to your callers that your system is down temporarily for whatever
  374. reason or another.  It will then ask them for the system entry password.
  375.  
  376. Please note that if BFE is started with the "-r" (re-entry) switch, this
  377. feature will not appear, as BFE will assume that the user has been down that
  378. path already.
  379.  
  380.  
  381.                                 MENU EDITOR
  382.  
  383. BFE/Setup's menu editor provides an intuitive method of constructing your BFE
  384. menus, allowing you to concentrate on the flexibility and functionality of
  385. the front end setup, rather than the semantics of a cryptic text-based
  386. configuration file.
  387.  
  388.                             MENU ITEM SELECTOR LIST
  389.  
  390. Upon selecting this option, you will be presented with a list of the menu
  391. items for the currently active menu (i.e. a .CTL file menu which has been
  392. recently created or opened).  Here is where the fun begins!
  393.  
  394. When the list of menu items appears, simply use the cursor keys (or the
  395. mouse) to select a menu option to edit.  All unused menu items will be marked
  396. as so.  Press ENTER or the LEFT mouse button to confirm your selection.
  397.  
  398. You will then be presented with the menu option editor screen.  From here,
  399. you tailor this particular menu option for an active role in your front end.
  400. After you have made your changes or additions, pressing ESC will return you
  401. to the menu item selector list, and will automatically retain your changes.
  402. These changes are *not* written to disk, however, until you actually SAVE the
  403. .CTL file from the main menu!
  404.  
  405.                             REARRANGING MENU ITEMS
  406.  
  407. There will be times when you need to re-arrange existing menu items to insert
  408. new ones, etc.  To do this simply hit the space bar on one menu item, move to
  409. the menu item you wish to swap positions with, and hit the space bar again.
  410. The screen will flash, letting you know that the switch was made.
  411.  
  412. DESCRIPTION
  413.  
  414. Selecting this item will prompt you for a textual description which more or
  415. less describes this option to your users.  The contents of this field will be
  416. presented to your users at show time.  This field also serves the role of
  417. "deleting" menu items, or making them temporarily inactive. By removing the
  418. description, BFE will not activate this option for your users.
  419.  
  420.    Examples:     Select me to enter Southeastern DataLINK BBS!
  421.                  Download our master file listing
  422.                  Receive subscriber information
  423.  
  424. For options which make use of BFE's SlashCommand(tm) mode, the slash command
  425. text should be entered in this field, before the description, and separated
  426. from the actual description with a pipe sign (|).
  427.  
  428.    Examples:    BBS|Select me to enter the BBS!
  429.                 FILES|Download master file listing
  430.                 SHELL|Remote shell to DOS
  431.  
  432. SlashCommands can appear in any .CTL file, including the special GLOBAL
  433. control file (more on this guy later).
  434.  
  435. HOTKEY
  436.  
  437. The hotkey field is a simple, yet necessary one.  The keystroke you enter in
  438. this field will be displayed next to the textual description entered above in
  439. the DESCRIPTION field.  The "hotkey" field represents the keypress needed to
  440. activate the option.  You may use any character for this, however, if you
  441. chose an alpha character (A through Z), it will use the uppercase form of the
  442. character.  In other words, if you put a lowercase letter in as a hotkey,
  443. BFE/Setup will convert it to uppercase.
  444.  
  445. This setting does not matter if the menu item is a SlashCommand(tm).
  446.  
  447. FLAVOR
  448.  
  449. BFE currently supports four option "flavors":
  450.  
  451. NORMAL and HIDDEN
  452.  
  453. All items marked as NORMAL will be displayed to your users.  Any items which
  454. are labeled as HIDDEN will remain active, but will not be displayed to your
  455. users.  This field serves no special purpose if you are using custom user-
  456. defined menus!
  457.  
  458. SLASH/NORMAL and SLASH/HIDDEN
  459.  
  460. As part of BFE's SlashCommand(tm) technology, options can be marked with a
  461. flavor of either SLASH/NORMAL or SLASH/HIDDEN.  When the user hits the '/'
  462. key, he will be prompted for the SlashCommand to use, as opposed to simply
  463. hitting a hotkey.
  464.  
  465. OPTION TYPE
  466.  
  467. This is perhaps the most critical part of configuring your new BFE system.
  468. Each menu option must have a valid TYPE.  This type determines the action
  469. that BFE will take if and when a user selects this menu option from the menu.
  470. This action can range from something as simple as exiting on an errorlevel to
  471. the calling batch files, to more complex actions, such as remote shells to
  472. your operating system!
  473.  
  474. Keep in mind that the contents of this field determine the meaning and use of
  475. other fields on the menu option editor screen.  See the BFE Reference Section
  476. for a detailed listing of the menu types available for use within the BFE
  477. system.
  478.  
  479. SECURITY
  480.  
  481. If a certain security level is needed to access a particular menu item,
  482. specify this level here.  
  483.  
  484. PORTSPEED
  485.  
  486. The PORTSPEED option was provided to allow Sysops who lock their serial ports
  487. to pass either the TRUE port speed (i.e. 9600), or the LOCKED speed (i.e
  488. 38400).  This comes in handy when combined with download types or when
  489. calling another BBS door from a BFE menu option.
  490.  
  491.  * NOTE:  Be sure to check the additional serial port locking options that
  492.  appear in the global options menu in BFE/Setup! These must be set as well!
  493.  
  494. PASSPARMS
  495.  
  496. This option will force BFE to pass pertinent communication information on the
  497. command line in type "R" menu items.  The parameters are passed in the
  498. following order:
  499.  
  500.          %1 = port (1-4) (0 if local)
  501.          %2 = speed (baud rate) (0 if local)
  502.          %3 = time to next event
  503.          %4 = node number (0 if not known)
  504.  
  505. PROMPT
  506.  
  507. The PROMPT keyword will force BFE to stop and get input from the current
  508. user, and will store the results of his data entry into the PROCESS field,
  509. which is described next.  This information is then passed on the command line
  510. in type "R" menu options.  Using this option will override anything that you
  511. have entered into the PROCESS field!
  512.  
  513. SECONDARY FIELD
  514.  
  515. The SECONDARY field is used as a catch-all field in BFE.  Its contents and
  516. internal use are based solely on the menu type.  It can contain anything from
  517. a simple errorlevel (for type "E" items), to a filename to be downloaded in a
  518. download type (type "F").  The relevance of this field is described in the
  519. BFE Reference Section, for each menu type that uses it.
  520.  
  521. PROCESS
  522.  
  523. The PROCESS field was designed to pass parameters to external tasks (other
  524. than the default communication parameters toggled by PASSPARMS).  This field
  525. is used automatically by the PROMPT feature.  The following macros are
  526. available for use in this field:
  527.  
  528.          %p = port (1-4) (0 if local)
  529.          %s = speed (baud rate) (0 if local)
  530.          %t = time to next event
  531.          %n = node number
  532.  
  533. SHOWAFTER
  534.  
  535. This field is used to display an ANSI/ASCII/AVATAR screen to your users AFTER
  536. they select the menu item, but BEFORE the task is carried out.  See the
  537. description of the type "D" option for more information on how BFE handles
  538. the display of external files.
  539.  
  540. PASSWORD
  541.  
  542. Any menu item in BFE can be password protected!  Simply place the desired
  543. password in this field.  When the user selects an option that has an
  544. associated password, BFE will prompt him/her for the password.  After 3
  545. failed attempts, BFE hangs up on the user and returns control to the calling
  546. batch file.
  547.  
  548. COLOR OVERRIDE
  549.  
  550. When using BFE's internal menus (i.e. no custom user menus), the menus will
  551. be displayed using the default menu color scheme configured under the Global
  552. Options menu.  Should you wish to override any or all of those colors, simply
  553. select this item!  A color picklist will appear, and will allow you to select
  554. the appropriate color for the current menu item.  While in the picklist,
  555. pressing PGUP/PGDN will toggle between the blinking colors (flashing) and the
  556. constant colors.  Does not apply to internal RIP menus!
  557.  
  558. CREATE DROPFILE
  559.  
  560. This option, when enabled, will force BFE to create a bbs dropfile based on
  561. the current user's settings.  This dropfile will be created in the directory
  562. pointed to by the DROPFILE PATH field. This can be particularly handy when
  563. running other doors from your BFE menus.
  564.  
  565.    Currently, the following dropfile formats are supported:
  566.  
  567.          - Standard DORINFO?.DEF
  568.          - SFDOORS.DAT (Spitfire BBS)
  569.          - DOOR.SYS (Both WildCat! and GAP/PCBoard flavors)
  570.  
  571. DROPFILE PATH
  572.  
  573. This should point to a directory in which BFE-generated dropfiles will be
  574. created (Backslash optional).  One macro is available in this field.  By
  575. placing a "%n" in the this field, you will force BFE to replace it with the
  576. current node number at runtime.  For instance:
  577.  
  578.         \FD\BFE\WORK%n
  579.  
  580. on node 1 would essentially be
  581.  
  582.         \FD\BFE\WORK1
  583.  
  584.  
  585.                                 MENU OPTIONS
  586.  
  587. Under the MENU OPTIONS selection from the main menu, you are able to further
  588. tailor the current menu to your liking.
  589.  
  590. REGISTRATION MESSAGE
  591.  
  592. By default, BFE displays its own registration message at the top of the
  593. screen (both local and remote).  If BFE is unregistered, it will display "***
  594. Unregistered Evaluation Copy **".  Upon registering BFE, this will be
  595. replaced by "Registered to: <your name>".  However, registration of BFE
  596. allows you to change this default registration message to whatever you like,
  597. and since the message appears at the top of each menu, you could give a
  598. different message for each menu, providing a title line.
  599.  
  600. CUSTOM USER MENU
  601.  
  602. By default, BFE will make use of an internal menu scheme.  This scheme is
  603. very attractive to the eye and easy to follow.  However, at some point, you
  604. may wish to create "custom" user menus.  These custom menu screens can be
  605. created using your favorite ASCII editor, ANSI paint program, and/or a RIP
  606. graphics paint package.  Simply place the full path and filename in this
  607. field (path optional).  If you do not specify an extension to the file, BFE
  608. will insert the extension at runtime, based on the user's graphic settings
  609. (i.e. ASCII/ANSI/AVATAR/RIP).  See the section on the type "D" menu option
  610. for more information on how BFE handles the displaying of external files.
  611.  
  612. CUSTOM MENU PROMPT
  613.  
  614. By default, BFE will use it's own internal "Selection" prompt at the bottom
  615. of the default internal menus.  To override this for each menu, simply
  616. place your custom menu prompt here!
  617.  
  618. CUSTOM COLORS
  619.  
  620. You may select custom colors for each "piece" of the default menu set.  These
  621. settings are initialized to the settings which were configured in the GLOBAL
  622. OPTIONS menu, but can be overriden for each of your menus to provide a custom
  623. look.
  624.  
  625. ** NOTES **
  626.  
  627. The custom menu prompts and registration messages are not enabled when using
  628. a custom user menu!  These items may be added directly into your custom
  629. screens via your favorite RIP/ANSI editors.
  630.  
  631.                                  MENU EVENTS 
  632.  
  633. Under the MENU EVENTS selection from the main menu, you are able to further
  634. tailor the current menu to your liking.
  635.  
  636. Each individual menu option can be configured with an optional event
  637. "schedule", which in turn controls the items accessability to users.  These
  638. schedules are local to each menu item.  In other words, each menu item has 
  639. its own set of scheduling times and dates.
  640.  
  641. By default, each menu item has a starting time and ending time of "00:00",
  642. for each day of the week.  By setting these values to zero, the menu item
  643. will be available at all times under normal BFE operation.  To limit a
  644. particular item, simply place the appropriate starting and stopping times
  645. next to the appropriate days of the week.  All times should be in 24 hour
  646. military format (00:00 - 23:59).
  647.  
  648. ** NOTES **
  649.  
  650. Keep in mind that the internal event scheduler for menu items is directly
  651. tied to the default internal menus!  Essentially, we had to come up with
  652. a work around for the fact that certain menu items would still be visible
  653. to callers in a custom menu, even though the item may not be available at
  654. the time of the user's call.  In this event, BFE will attempt to display a 
  655. file called NOTNOW.(ASC/ANS/AVT/RIP) in the BFE directory.  This file should
  656. essentially explain to the user that the option is not currently available,
  657. etc.  If this file is not found, the menu option will simply not do 
  658. anything.
  659.  
  660.                                   PROTOCOLS
  661.  
  662. Here is where all external protocols are configured for use within BFE.  This
  663. is a very painless process, as you will soon find out!  You may configure up
  664. to 10 external protocols.  There are three fields for each:
  665.  
  666. MENU NAME
  667.  
  668. Textual description which will describe this protocol to your users (i.e.
  669. ZModem, YModem, etc).
  670.  
  671. BATCH PROCESSOR
  672.  
  673. The full path and filename of a batch file which will be called when a user
  674. selects to transfer a file with this
  675. protocol.
  676.  
  677. PROMPT FOR FILE
  678.  
  679. Some protocols automatically recognize the filename being uploaded (i.e.
  680. ZModem), others do not (XModem).  If BFE needs to ask the user for the
  681. filename, specify a "Y" in this field.
  682.  
  683.  BFE passes the following parameters to the configured batch file(s):
  684.  
  685.                %1 - Node number
  686.                %2 - Port number (1-4)
  687.                %3 - Serial Speed
  688.                %4 - Filename (complete path, if specified in SEC.)
  689.                %5 - U = Upload D = Download
  690.  
  691. It is up to you to put these batch files together (although the DSZ sample
  692. set should suffice for all but the most giving of sysops!).  Also, since the
  693. file transfer hook is provided in batch, this affords you the opportunity to
  694. do additional processing, such as scanning uploads for viruses, or moving
  695. uploads to another area on your system.  Endless.
  696.  
  697.                                 LOCAL TEST
  698.  
  699. From this option, you can test out your BFE configuration in local mode, to
  700. test your menu sets.  BFE looks for a batch file called BFELOCAL.BAT in your
  701. BFE directory.  It is up to you to place the necessary call to BFE in this
  702. batch file.  A sample BFELOCAL.BAT file has been included in the
  703. distribution archive.  The only thing you need to change (essentially) is the
  704. name of the .CTL file to start with.
  705.  
  706.                                MESSAGE BASES
  707.  
  708.                                  OVERVIEW
  709.  
  710. BFE has the ability to make use of Fidonet *.MSG or Squish message areas. You
  711. can configure up to 20 message areas by selecting the MESSAGE BASES option
  712. from the BFE/Setup main menu.  After selecting this option, you will be
  713. presented with a picklist of the available areas.  To configure an area,
  714. simply select the area to edit by using the cursor keys (or mouse) and
  715. pressing RETURN.  This pulls up the Message Area Editor.  There are a number
  716. of options which need to be configured for each message area that
  717. you wish to use with BFE.
  718.  
  719. PATH/FILENAME OF AREA
  720.  
  721. This setting depends upon the message base format you intend to use.
  722. Currently, the fidonet *.MSG format and the Scott Dudley's Squish format are
  723. supported.  Fidonet style areas should point to the directory to hold the
  724. messages.  Squish areas should point to the path and *base* name of the
  725. squish base.
  726.  
  727.          Examples:  C:\FD\PVTMAIL
  728.                     C:\BINKLEY\NETMAIL
  729.  
  730. DESTINATION ADDRESS
  731.  
  732. This is the fidonet style network address which represents the destination of
  733. the message.  To keep messages locally, simply enter your own address.
  734.  
  735. ORIGINATING ADDRESS
  736.  
  737. This is the fidonet style network address which represents YOUR network
  738. address.
  739.  
  740. NORMAL OR UUCP?
  741.  
  742. If the message is destined for a UUCP mail gateway, specify a "U" in this
  743. field.  In this scenario, BFE will insert the now-infamous "To:" line in the
  744. first line of the message text.
  745.  
  746. MESSAGE ATTRIBUTES
  747.  
  748. The following message attributes may be enabled:
  749.  
  750.          - PRIVATE
  751.          - CRASH
  752.          - HOLD
  753.          - KILL/SENT
  754.          - FILE ATTACH
  755.          - FILE REQUEST
  756.  
  757. Additional message attributes may be added in the future.  Simply answer "Y"
  758. or "N" for each attribute.  Any message that BFE generates for this area will
  759. have the configured attributes.
  760.  
  761. DEFAULT "TO" FIELD
  762.  
  763. To provide a default "to" field for the message, simply enter this here.  If
  764. you leave this field blank, BFE will prompt the user for a recipient's name
  765. before he/she enters the message.
  766.  
  767.          Examples: Sysop
  768.                    areafix
  769.                    Scott Burkett
  770.  
  771. DEFAULT "FROM" FIELD
  772.  
  773. To provide a default "from" field for the message, simply enter this here.
  774. If you leave this field blank, BFE will prompt the user for their name before
  775. he/she enters the message.  If you are using the BFE user system, or are
  776. running BFE via a BBS dropfile, you can have BFE use the user's logon name
  777. for this field by simply placing a tilde (~) as the contents of this field.
  778.  
  779.          Examples: ~
  780.                    Sysop
  781.                    areafix
  782.                    Scott Burkett
  783.  
  784. DEFAULT "SUBJECT" FIELD
  785.  
  786. To provide a default subject field for the message, simply enter this here.
  787. If you leave this field blank, BFE will prompt the user for a subject before
  788. he/she enters the message.
  789.  
  790.          Examples: Feedback
  791.                    mypass -R -Q
  792.  
  793. BRIEF DESCRIPTION
  794.  
  795. A brief description is required for each of your configured message areas.
  796. This description is the same text used in the message area selector list.
  797.  
  798.          Examples: Feedback to Sysop Area
  799.                    Areafix Request Area
  800.  
  801. EXTERNAL EDITOR
  802.  
  803. If you wish to use an external full screen editor in lieu of the limited
  804. internal BFE line editor, simply place the name of the batch file or the
  805. executable in this field.  BFE will automatically look for an "import"
  806. file in the IPC directory called "MSGTMP.nnn", where nnn is the node number
  807. (i.e. MSGTMP.1, MSGTMP.2, etc).  This file will be imported into the body
  808. of the message.
  809.  
  810.          Examples: C:\UTILS\EXTEDIT.BAT
  811.                    C:\UTILS\TOPED.EXE
  812.  
  813.