home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / oct93 / comm / 4d-bbsdemo.lha / 4D-BBSDemo / Docs / 03.Getting_Started < prev    next >
Text File  |  1993-07-02  |  25KB  |  687 lines
  1. Chapter 3:
  2.  
  3.                Getting Started
  4.  
  5.  
  6.  
  7. 3.1.0 Command Line Parameters (CLP)
  8.  
  9.  
  10.      4D-BBS uses these command line parameters (CLP for short) to
  11. allow you to customize it's behavior to suit your needs right from
  12. startup! CLP's are basically arguments used in normal dos commands.
  13.  
  14.      4D-BBS also uses a configuration file that does just about the
  15. same thing the CLP's do, however a CLP will always override the setting
  16. of the cfg file.
  17.  
  18.      All parameters are proceeded with a / or - and should be spaced
  19. apart BETWEEN THE PARAMTERS.  NO spaces should be between the - or /
  20. and the actual command itself.  CLPS CAN NOT be stacked by using a
  21. single - or / with multiple commands.
  22.  
  23.      A # should be replaced by a numerical value, and a $ should be
  24. replaced by a character string.  The ! following a CLP denoted the CLP
  25. is switch.  Without anything following, or a 0 following, is
  26. considered off, while a 1 is considered on.
  27.  
  28.      In the event a space is needed for a parameter enclose JUST that
  29. parameter, including the /, within spaces. The commands ARE case
  30. sensitive.
  31.  
  32.  
  33.  
  34. Param    Description                                      
  35. -----     ------------------------------------------------ 
  36.  
  37. A!    Enter ARexx Port Server Mode, Wait for Commands.
  38.         
  39.     This brings ths bbs up in WAIT mode and does NOT monitor the
  40.      serial port.  This mode is used mainly as an ARexx server.
  41.  
  42.     Example:    4D-BBS -A
  43.  
  44.     
  45. a$    ARexx Port Name. 
  46.  
  47.     This will allow you to change the ARexx port name created when
  48.      4D-BBS is started up.  All AREXX doors and scripts should ADDRESS
  49.      this name if you want 4D-BBS to recognize the commands.  See
  50.      Chapter 10 for more information.
  51.     
  52.     Example:    4D-BBS -aMyNewName.Port
  53.  
  54.  
  55. B#    True Baud rate of a /o call.        
  56.  
  57.     Lets 4D-BBS know the true baud rate if different than the serial
  58.      baud rate.  Used for loggin, and tranfer time calculations.
  59.  
  60.     Example:    4D-BBS -o1 -b19200 -B2400
  61.      Range:    300-115,200
  62.  
  63.  
  64. b#    Lock the serial baud rate.
  65.  
  66.     This allows 4D-BBS and your modem to send information at a fixed
  67.     serial rate.  This is only needed for modems which have data
  68.      compression capabilities.  See Chapter 12 for more information on
  69.      this.
  70.  
  71.     W/O  /o parameter: Lock Serial Port at rate.        
  72.     With /o parameter: Serial Baud rate for call.
  73.  
  74.     Example:    4D-BBS -b38400
  75.     Range:    300-115,200
  76.  
  77.  
  78. C#   Number of Last callers saved.
  79.  
  80.     This allows you to set the number of callers saved to the file
  81.     "bbs:lastcall.t".  If you have low memory try to keep this
  82.     number as low as possible.
  83.  
  84.     Example:    4D-BBS -C10
  85.     Range:    1-30
  86.  
  87.  
  88. c#    Number of Bitplanes to use.  (Colors = 2^#)
  89.  
  90.     If you have low memory, run multiple lines, or are running on an
  91.      unacellerated Amiga, use 1 or two here to not only save memory,
  92.      but to speed up the BBS.  This setting has NO affect on the
  93.      user's color, as they will see the full set of colors.
  94.  
  95.     Example:    4D-BBS -c2
  96.     Range:    1-4 (2-16 colors)
  97.  
  98.  
  99. D$    Filename of Directories datafile.
  100.  
  101.      Datafile containg a list of alternative paths for 4D-BBS to use.  
  102.      The format of the file is:
  103.      
  104.           BBS    PATH OR ASSIGN
  105.           FILE   PATH OR ASSIGN
  106.           MENU   PATH OR ASSIGN
  107.           TEXT   PATH OR ASSIGN
  108.           USERS  PATH OR ASSIGN
  109.           BOARDS PATH OR ASSIGN
  110.           DOORS  PATH OR ASSIGN
  111.  
  112.     Example:    4D-BBS -DBBS:AltPaths.Dat
  113.  
  114.  
  115. d#    Hangup behavior of BBS
  116.  
  117.     0 - Don't do anything to hangup (used in a spawn mode)
  118.      1 - Drop DTR to hang up modem
  119.      2 - Use "+++,,,ATH" to hangup modem
  120.  
  121.     Example:    4D-BBS -d1
  122.  
  123.  
  124. f$   Font to use with 4D-BBS. 
  125.  
  126.     You can use just about any font you wish with 4D-BBS. It will
  127.      look in your FONTS: directory and append the ".font" on the end
  128.      if you if is not already there.  If the requested font is already
  129.     open in ram, it will use it.  If not, it will open your diskfont
  130.      and use it.
  131.  
  132.     Example:    4D-BBS -fMYCOOL4D.font
  133.  
  134.  
  135. G$    Configuration File to Use
  136.  
  137.      Instead of using the default S:4D.Config file, you can specify an
  138.      optional file for 4D-BBS to get its configuration settings from.
  139.      The FULl path must be given.
  140.  
  141.     Example:    4D-BBS -GS:4D2.config
  142.  
  143.  
  144. h!    Reset to SystemHighBaud After every caller.
  145.  
  146.          This is mostly used in conjuction with the other serial
  147.      and baud related CLP's.  When the BBS is running in continuous
  148.      answer modem, it will reset BACK to the system high baud after
  149.      each call when this parameter is given.  Normally it will stay
  150.      at the last caller's baud rate, until another call at a
  151.      diffrent baud rate comes in.
  152.  
  153.     Example:    4D-BBS -h
  154.  
  155.  
  156. H!    Hide screen and don't make active when starting.
  157.  
  158.     This CLP will tell 4D-BBS to open its custom screen in the back,
  159.     and NOT make it the active screen.  Normally used with /o1 when
  160.     being spawned by another program.
  161.  
  162.     Example:    4D-BBS -H
  163.  
  164.  
  165. I!    Open 4D-BBS in iconified mode instead of full screen.
  166.  
  167.     This is a very handy memory saving option. The user actually
  168.     receives a little faster response time because local screens and
  169.     windows are not updated. A small title bar will come up and give
  170.      you various system status reports including on-line users name
  171.      and what they are doing.  You can uniconify 4D-BBS by quickly
  172.      clicking the left then right mouse buttons while pointing in
  173.     the small window.  The close gadget will completely shutdown the
  174.      bbs, so be careful when using it.
  175.  
  176.  
  177.     Example:    4D-BBS -I
  178.  
  179.  
  180. K!    Turn keyboard input off when 4D-BBS is started.
  181.  
  182.     This options allows you turn off normal keyboard input, the
  183.      AMIGA key commands, and function keys. Your mouse or an ARexx
  184.      script is the only way to turn keyboard input back on.
  185.  
  186.     NOTE:  If you use the CLP of "-M" to turn your pull down menus
  187.      OFF to save memory and do not have an arexx script to turn
  188.     your keyboard back on 4D WILL NOT know your typing.  There is
  189.      an option in the "Defs" pull down menu to toggle this option.
  190.  
  191.     Example:    4D-BBS -K
  192.  
  193.  
  194. L#    Number of screen lines to use.
  195.     
  196.     This CLP will set the lines displayable to the SysOp. If your
  197.     screen/window is not large enough 4d will increase the size. A
  198.     number greater than 32 will cause an interlaced screen to be
  199.     opened.
  200.  
  201.     Example:    4D-BBS -L50
  202.     Range: 20-60
  203.  
  204.  
  205. M!    Diasable pull down menus.        
  206.  
  207.     This will save some memory if you can live without the pull
  208.     down menus. You cannot use them at all if you set this CLP.
  209.     The AMIGA key's will not work either (EX: AMIGA C to chat)
  210.     
  211.     The function keys are NOT disabled.
  212.  
  213.     Example:    4D-BBS -M
  214.  
  215.  
  216. m$    Replacement file for BBS:Modem.dat.    
  217.  
  218.     This allows you to use a different modem data file, in case you
  219.     have a few modems and don't want to edit the same file every
  220.     time you change the modem.  Can also be user in a multiline
  221.     situation, when different modems are being used.
  222.  
  223.     Example:    4D-BBS -mBBS:ModemUSR.dat
  224.     
  225.  
  226. N$    Forced User Name if using /o.        
  227.  
  228.     The string following N will be used as the user name, and the
  229.      user WILL NOT be prompted for one.  The CLP -P is normally
  230.      associated with this command.  If BOTH -N and -P are given with
  231.      the -o1 or -os CLP, and the name or password is is incorrect,
  232.      4D-BBS will quit, returning an error code.   If just -N and /o1
  233.      or /os is given, the user will be prompted for a password.
  234.      If the password is given incorrectly three times, 4D-BBS will
  235.      quit, returning an error.
  236.  
  237.      If you do not run your BBS constantly (IE: a network frontend
  238.      spanws the BBS) a nice srcipt can be made to automatically log
  239.      you into the BBS using the -N and -P parameters.  This would be
  240.      the exact same as hitting F10 for SysOp local logon at the BBS
  241.      wait screen.
  242.  
  243.      If the user name contains a space in it, surround JUST THIS CLP
  244.      with double quation marks.
  245.  
  246.     Example:    4D-BBS -os "-NJohn Doe" "-Pjane"
  247.  
  248.  
  249. o!    Logon once remote, without a waiting screen.
  250. os   Logon once local, without a waiting screen (can be -o2, also).
  251.  
  252.     This is mainly used by a network front end program to call up 
  253.      4D-BBS when an carrier is already present.  4D-BBS will send
  254.      the opening logon screen, and act as if it had answered the
  255.      phone.  Once the call is complete, the BBS will shut down, and
  256.      return control to the calling program.
  257.     
  258.      For a remote spawn, the calling program will need to pass the
  259.      -b CLP to tell 4D-BBS what serial rate to use.  The -B CLP should
  260.      also be passed to tell 4D-BBS what the TRUE carrier rate is.
  261.  
  262.      For a local spawn, 4D-BBS will not actually open the serial port.
  263.      No serial I/O will be checked during the session, but everything
  264.      else will function as a normal call.
  265.  
  266.      See chapter 14 on Networking for more detailed information about
  267.      this.
  268.  
  269.      Example: 4D-BBS -o1 -b19200 -B14400
  270.  
  271.     
  272. P$    Forced User Password if using /o.
  273.  
  274.     This works the same way as the "-N" CLP and is the user's
  275.      password.  This CLP is ONLY used is BOTH -o and -N parameters are
  276.      provided.  Otherwise it is ignored.  See the N CLP for more
  277.      information on this.
  278.  
  279.      Example:    4D-BBS -os "-NSysop" -PNotell
  280.  
  281. r!   Tranfer types: RZ/SZ Externals(0) or XPR Libraries(1).     
  282.     
  283.     This parameter will determine whether the BBS used the XPR
  284.      libraries when transfering files, or the two external programs
  285.      called RZ/SZ.  RZ/SZ can ONLY be used on serial port 0, but are
  286.      written in 100% assembler and very fast/efficient.  The XPR
  287.      libraries give the BBS more flexibility and a wider range of
  288.      transfer protocols to use.  They are not as efficient as RZ/SZ
  289.      but can be used on ANY serial port.
  290.  
  291.      If you are running a multiline BBS, you MUST use XPR libraries.
  292.  
  293.      Example:  4D-BBS -r1
  294.  
  295.  
  296. S$    Set the Announce string.
  297.  
  298.     If you want to get a quick message to the on-line user and don't
  299.     really want to enter into chat mode, you can use the pull down menu
  300.     command ANNOUNCE.  This command will first look in ram: for a file
  301.     called "Tellem" this file can be anything, and if it's there it
  302.     will be typed to the users screen.  If it is not found 4D-BBS will
  303.      send the string set by this CLP.
  304.  
  305.     This function is more for users that do not have Arexx, since the
  306.      ARexx "messqueue" command is a cleaner way to send messages to an
  307.      on-line user.
  308.  
  309.      The default string for this option is: "System request -> BBS will
  310.      be going down in a few moments."
  311.  
  312.     Example:    4D-BBS "-SI'm Sorry, I can not chat with you right now."
  313.  
  314.  
  315. s$    Serial Device Name for 4D-BBS to use.    
  316.  
  317.     If you wish to use a serial device other than "serial.device" you
  318.      can specify the particular device name here. 
  319.  
  320.      Example:  4D-BBS -sgvpser.device
  321.  
  322.  
  323. T#    Time added or subtracted with F7/F8 or menu commands.    
  324.  
  325.     When time is given to the on-line user via the function keys or
  326.      pull down menu comamnds this number will represent the amount of
  327.     time given or taken.  This number should always be a positive 
  328.     value.  The default is 10 minutes.
  329.  
  330.     Example:  D-BBS -T15
  331.     Range:    1-99
  332.  
  333.  
  334. t#    Inactivity timeout before auto-logoff.
  335.  
  336.     How long the user can stay on-line without any activity is
  337.      determined by this CLP.  The default is four minutes.
  338.  
  339.     Example:  4D-BBS -t7
  340.     Range:    1-99
  341.  
  342.  
  343. U#   Time awared to user for uploads.
  344.  
  345.      When a user uploads a file to the BBS, they can be rewarded by
  346.      being given extra time on-line for the upload.  This CLP allows
  347.      you to set how many extra seconds per kilobyte upladed the user
  348.      is given.  This function is defaulted to 0; now reward is given.
  349.     
  350.      Example:  4D-BBS -U
  351.      Range:    1-99
  352.  
  353. u#    Serial Unit Number.            
  354.  
  355.     This command allows you to use a unit other that 0.  This can be
  356.     be used in conjunction with the -s CLP, but does not have to be.
  357.  
  358.      Example:  4D-BBS -u2
  359.  
  360.  
  361. V#    Verbose listing of CLP settings and system information.
  362.  
  363.     Verbose can be used as a debugging mode.  4D-BBS will send much
  364.     information on the system status and defaults to the standard
  365.     output.  These can include where 4D-BBS is looking for files,
  366.      files it finds, current window positions, size and positions
  367.      of windows, fonts and sizes currently open, errors in data
  368.      files, menus, and other important sytem information.
  369.  
  370.     If you are running 4D-BBS and redirecting output to the NIL:
  371.      device, nothing will be echoed, since this suppressed output.
  372.      The number following the V parameter signifies the amount
  373.      of information 4D-BBS will display.
  374.  
  375.      If you are having problems with 4D-BBS or getting erratic results
  376.      from a function, turn on this mode, and see if any extra
  377.      information is given to help you solve the problem.  If you call
  378.      for support on a problem, you will be requested to run the BBS
  379.      in this mode to aid in problem solving.
  380.  
  381.      Example:  4D-BBS -V1
  382.      Range:    0-9
  383.  
  384.  
  385. v!   Enable 4D-BBS function announcements.
  386.  
  387.      This CLP tells 4D-BBS to "talk" about what the user is doing.
  388.      The SPEAK: device must be mounted for this to work properly.
  389.  
  390.      Example:  4D-BBS -v1
  391.  
  392.  
  393.  
  394.  
  395.      As many CLP's can be given as necessary.  Please look through a
  396. few of the scripts located in your "RunScripts" dir for more examples
  397. of using CLPs.
  398.  
  399. NOTE: If you have mutiple 4D-BBS's running it id necessary to set
  400. each of them to a different serial unit if you are not logging on
  401. locally.  4D-BBS will handle changing the ARexx port name so it is a
  402. unique name.
  403.  
  404.  
  405.  
  406. 3.2.0 Setting up 4D-BBS
  407.  
  408.  
  409.      4D-BBS is designed such that you can set up almost everything
  410. from within the BBS program. As a matter of fact, the only files that
  411. you need to edit outside the BBS program are the menu files and a few
  412. text files, such as one for logging off.  You still can edit all
  413. those files from inside the BBS program by using the text editor on
  414. the sysop menu, though it's more convenient to use your favorite text
  415. editor than the one built into the BBS program.
  416.  
  417.  
  418. 3.2.1 Understanding The System
  419.  
  420.      4D-BBS can be broken down into 6 different sections. These
  421. sections each have a directory or multiple directories that coincide
  422. with the section.  Although you can change these pointers using the
  423. /D parameter or the cfg_ed editor (see appendix B) the default
  424. directory pointers are:
  425.  
  426.     System Files Directory        BBS:
  427.   *    Message Bases Directory       BOARDS:
  428.   *    File Transfers Directory      FILE:
  429.   *    Text Files Directory          TEXT:
  430.     Menus Directory               MENU:
  431.   *    Users Directory               USERS:
  432.   *    Doors Main Directory          DOORS:
  433.  
  434. Note: As of V2.86 the mail directory is no longer needed/used, and the
  435.       local mail is stored in the BOARDS:Board_0/ directory. 
  436.  
  437.       Directories denoted with a * mean a second level of directories
  438.       exists inside this directory. Refer to chapters four through
  439.       seven for more information on an individual directory.
  440.  
  441.  
  442.      Each of the above directories contain specific data files for
  443. that section.  In most cases, 4D-BBS will not run, if the first six
  444. directories and appropriate data files are not found.
  445.  
  446.      All of the directories do not have to be on the same device, you
  447. may assign them to any kind of device: floppy drives, external memory,
  448. hard disks, etc.  However we DO NOT recommend you assign BBS: or
  449. USERS: to memory.  These directories contain important system and user
  450. data.  In the case of a power outage or system crash all these files
  451. would be lost.  On the other hand, assigning MENU: to memory would be
  452. an excellent idea! It will speed up the menus, 4D-BBS does not update
  453. anything in the MENU: dir's. 
  454.  
  455.  
  456. 3.2.0 Data Files:
  457.  
  458.      4D-BBS is smart enough to create it's own data files if you start
  459. from scratch, but the above assignments ARE necessary. In addition,
  460. you will need a few text files which reside in the TEXT: directory. A
  461. few are help files for the BBS system, and are supplied on the 4D-BBS
  462. disk.  You will need to create or modify other files, which are shown
  463. to the user upon logging on and off.
  464.  
  465.  
  466. Text: READMSG.HELP             Info on Msg's help commands
  467. Text: READMAIL.HELP            Info on Mail help commands
  468. Text: EDITOR.HELP              Info on the editors(4d's)   
  469. Text: LOGON.TXT.ASCII          Shown to user at logon
  470. Text: LOGON.TXT.ANSI
  471. Text: NEWUSER.TXT              Text sent when a new user logs on
  472. Text: STATS.TXT.ASCII          Also shown at logon (if created)
  473. Text: STATS.TXT.ANSI
  474. Text: LOGOFF.TXT.ASCII         Shown to user at logoff
  475. Text: LOGOFF.TXT.ANSI
  476.  
  477. Boards: origin.dat             Default random tagline file for Fido
  478. Boards: Board_1/origin.dat     Specific random tagline file for Fido
  479. Boards: board_1/entry.txt     *Text shown when user changes to Sub
  480.  
  481. File: Sect_1/FList.T          *BBS stores your file names and sizes              
  482. File: Sect_1/Entry.txt        *Text shown when user changes to sect
  483.  
  484. Users: new-list                New Users names ONLY
  485. Users: User-List               All users names,locations,computers
  486.  
  487. BBS: Def_say.t                Text strings for 4D-BBS to use
  488. BBS: Lastcall.t               Last callers and last words
  489. BBS: Modemresp.dat            Modem configuration
  490. BBS: Personal.menu            Pulldown menu (menu commands & DOS)
  491. BBS: Sysdefs.d                Default system Params
  492. BBS: Systotal.Dat             Pointers on system totals
  493. BBS: UserDefs.D               Default users Params
  494. BBS: Waitscreen.txt           Text shown upon startup
  495. BBS: XprSetup.dat             XPR Libraries configuration
  496. BBS: BoardDefs.d              All info about your custom board cfg
  497. BBS: NetDefs.d                Network Address and information
  498. BBS: FileDefs.d               All info about your custom file cfg  
  499.  
  500.      * The path is generic (Sect_1) can be anything.
  501.  
  502.  
  503.      The first three files are the help files, which you do not have
  504. to change.  The rest of the files you need to modify to suit your
  505. needs. Examples are included on the 4D-BBS disk to give you a good
  506. idea of what they are.  You may use these to start out.
  507.  
  508.      You may have noticed, some files have two versions; one for users
  509. who log on in ANSI mode and one who log on in ASCII mode. ".ANSI"
  510. files don't have to have ANSI sequences, but ".ASCII" files should
  511. have plain text only.  You can produce ".ANSI" files with an ANSI text
  512. editor (such as ANSI Master).
  513.  
  514.      The LOGON.TXT files are what the user sees after their modem
  515. connects to your BBS and before the logon prompt appears. STATS.TXT
  516. files, which usually show the user's stats such as how many calls have
  517. been made, how many downloads, etc, are shown after the user has
  518. typed in their password.
  519.  
  520.      If you do not want these files to be shown for any reason, just
  521. rename or delete them.  The BBS will continue withut producing an
  522. error message.
  523.  
  524.      The NEWUSER.TXT file (no .ASCII or .ANSI extensions here...just
  525. one file) is shown to the user after they log on as "NEW" and before
  526. the user registration procedure starts. This file is often used to
  527. explain what your BBS is all about and how the new user can sign up.
  528.  
  529.      As you may have already guessed, the LOGOFF.TXT file is shown
  530. when the user logs off.
  531.  
  532.  
  533. 3.2.1  Waiting Screen:
  534.  
  535.      This isn't required at the time of setting up, but if you have
  536. been running the BBS for a while and get tired of looking at the same
  537. old waiting screen you can actually design your own ANSI screen and
  538. put it in place of the default screen.  All you have to do is call
  539. your file "waitscreen.txt" and put it in the BBS: directory.  Be sure
  540. to look at the section on embedded instructonal codes, which will be
  541. veryt useful for your waiting screen.
  542.  
  543.  
  544.  
  545. 3.2.2  The Default Sayings File:  BBS:Def_Say.t
  546.  
  547.      About 95% of all messages displayed when a user is on-line are
  548. configurable.  To change this, there is a file in your bbs: directory
  549. called "Def_say.t".  Because this file is extremely long (about 300
  550. lines), trying to define all these would be impractical. You should
  551. make a backup copy of this file before editing it.  Most strings are
  552. direct and you shouldn't have any trouble figuring out what the
  553. string is saying and how you can alter it to meet your needs.
  554.  
  555.      This file cannot have ANY new lines or CTRL M's embedded in it.
  556. This will confuse 4D-BBS when reading in the file, and your string
  557. will not print out correctly.  The newline identifier is a "\n".  Use
  558. this when you wish to have a newline.  A clear screen can be
  559. accomplished by using a "\f". All Eic's and ANSI color codes and
  560. animation along with 4D-BBS's <CTRL>P color codes will work. DO NOT
  561. HAVE MORE THEN 99 CHARS TOTAL PER LINE!
  562.  
  563.  
  564. 3.2.3  Personal Pull Down Menus:  BBS:Personal.Menu 
  565.  
  566.      You can setup your own set of pull down menu commands on the
  567. 4D-BBS screen.  This allows the SysOp to execute any pre-defined menu
  568. command instantly.  AmigaDos commands are also accessable by 
  569. preceeding the command with an *.
  570.  
  571.      The first line of this file is the number of entries (we'll call
  572. this X).  This tells 4D-BBS how many commands will follow.  The next X
  573. lines are each command as it will be printed in the pulldown menu. A
  574. blank line will seperate these command from the next X lines.  The set
  575. is the actual string to be sent to the BBS.  All EIC's and color codes
  576. are allowed.
  577.  
  578.      An example file would like like:
  579.  
  580.  
  581.  6
  582.  Umm Show time
  583.  Show Sub #
  584.  Lets run SpcEmp!
  585.  Run Sysop ONCE
  586.  Lets do a newcli
  587.  Lets Run Ppaint!
  588.  
  589.  p 0
  590.  s s
  591.  c spcemp/SPCEMP
  592.  *DH0:4d -os -G -V 
  593.  *newshell
  594.  *DH0:Ppaint
  595.  
  596.  
  597. 3.2.4 External Transfer Libraries:  BBS:XPRSetup.dat
  598.  
  599.      This file is for the configuration of XPR libraries.  Each
  600. library which is references should be in your libs: directory.
  601. Normally case IS significant in using libraries.
  602.  
  603.      The first lint of the file is the the NUMBER of XPR libraries you
  604. system has.  There is a maximum of 10 libraries.  After the first
  605. line, each library will have 2 lines.  The first line will be the name
  606. of the library as presented to the user.  The second line is a
  607. combination of the FULL library name, a space, and any initialization 
  608. options which the library needs.  Refer to the individuals library's
  609. documentation for a listing of the initialization options.
  610.  
  611.      An example file would look like:
  612.  
  613. 7
  614. X-Compuserve
  615. xprquickb.library 
  616. X-Kermit
  617. xprkermit.library 
  618. Xmodem
  619. xprxmodem.library T0,C0,K0 
  620. Ymodem-1K
  621. xprymodem.library OFile:Sect_0
  622. Ymodem-Batch
  623. xprymodem.library YB,OFile:Sect_0
  624. Ymodem-G
  625. xprymodem.library YG,OFile:Sect_0
  626. Zmodem 1K
  627. xprzmodem.library T?,ON,B5,AN,DN,RN,SN,PFile:sect_0
  628.  
  629.  
  630. 3.2.5  Keyfile for Registered Users
  631.  
  632.      Registered users should have received a keyfile with 4D-BBS.
  633. This keyfile needs to be named "4D-BBS.Key" and placed into the BBS:
  634. directory.
  635.  
  636.      Without the keyfile, 4D-BBS will be locked into DEMO mode,
  637. allowing a maximum of 30 minute calls, 5 message bases, and 5 file
  638. transfer sections.
  639.  
  640.      Whenever a new version of 4D-BBS is released, you simple need to
  641. install it according to the instructions which accompany it, and you
  642. will be set.  The updates should be freely available from any BBS.
  643.  
  644.  
  645. 3.3.0  Executing the Program:
  646.  
  647.      Many scripts were included in the BBS package. These scripts can
  648. range from sysop one time startup with workbench screen to normal
  649. continual wait mode.  It is best if you familiarize yourself with the
  650. CLP list explained earlier, and write your own shell executable
  651. scripts.
  652.  
  653.      If you are using the default assigns from the cfg_ed editor, then
  654. you will need to make proper assigns for these.  If you are using full
  655. paths, rather than assigns, you can skip to section 3.3.1.
  656.  
  657.      To make the proper assigns, you need to execute (or type in) the
  658. following commands.  The last part of each command should be changed
  659. to match your system's setup.
  660.  
  661. Assign BBS:    DH0:4D-BBS/BBS
  662. Assign FILE:   DH0:4D-BBS/File
  663. Assign MENU:   DH0:4D-BBS/Menu
  664. Assign TEXT:   DH0:4D-BBS/Text
  665. Assign USERS:  DH0:4D-BBS/Users
  666. Assign BOARDS: DH0:4D-BBS/Boards
  667. Assign DOORS:  DH0:4D-BBS/Doors
  668.  
  669.  
  670.      So, now that 4D-BBS knows where the proper locations for its data
  671. files area you are ready to run it!
  672.  
  673.      A script is already setup called "Fast" that will bring the bbs
  674. up and automatically log you in.  This script passes to 4D-BBS your
  675. name and password and a few other params.  If you wish to logon
  676. yourself to see how things go, try the script "startnormal".
  677.  
  678.      Think of the CLP's like a cfg file, you can alter how the bbs
  679. runs without having to go into the CFG_ED program.  You can look at a
  680. few of the scripts found in your "RunScripts" dir and take a look at
  681. the section 3.1.0 again,  to get a better understanding of how to
  682. customize the execution of 4D-BBS to meet your needs.  Once you
  683. understand what parameters you use most frequently, you can use the
  684. CFG_ED program to make these the default.
  685.  
  686.      For a quick reference to the CLPs, see Appendix 3.
  687.