
-------------------- MAIN CONFIGURATION MENU -----------------------------

When entering data, the present value for each option is shown so that you
may edit it; just press Enter if you want to leave it alone. Press CTRL/X
any time to skip the rest of the parameters and return to the main menu.

      Section number          Contents
      --------------          --------
           1                  General
           2                  Modem and communications           
           3                  Directory configuration
           4                  Multinode and node specific stuff
           5                  Conference configuration
           6                  File system configuration
           7                  External programs
           8                  Keyboard macros
           9                  Timed events

:1

-------------------- GENERAL ---------------------------------------------

The BBS name is the name you wish to identify your system with. It will be
displayed as the first thing users ringing into your system will see.

>1,Please enter your system name:

The SYSOP name is the name you wish to use when logging into the system
with special privileges. It has a special password associated with it
that is not saved on the users file, for extra security.

>2,Please enter your SYSOP name:

The SYSOP password is a special password you can use when signing onto
the system locally as the SYStem Operator, or SYSOP.

>3,Please enter SYSOP password:

You may run your system as an OPEN system (i.e. anybody who logs on
will be given the opportunity of registering) or as a closed system.
If you run a closed system then users who ask to register will have
to supply a 'registration' password which you will have to supply
them with beforehand (if you don't want even this to be possible
then specify a blank password).

>45,Run a CLOSED system:
>46,Password for new user registration:

The system as delivered supports messages up to 99 lines in length. If
you wish to limit your users to smaller messages then you may use the
next option to set a smaller value:

>10,Maximum number of lines in a message:

When a new user registers, their daily time limit on the system is set
in their user profile. If you don't want to use time limits then just
set the new user time limit to zero and the system will not check this
for you. Otherwise new users will get the value set here. You can
'upgrade' them later using ths sysop menu.

>18,New user time limit (minutes):

New users are usually set into 'read marked messages' mode, where
messages are presented in the order they are marked. In other words
new messages are shown in numerical order. If you want new users to
be set into 'read reference' mode immediately, then just turn on 
this next option.

>58,Set Read Ref mode for new users:

Users who are logged into the system have to type something now and
again to keep the system alive. If it looks as though they have fallen
asleep over the keyboard then we pull the plug on them. The time we
wait before doing this is what the next parameter is about (set it
to zero if you want to disable the feature).

>20,Sleep time disconnect (Seconds):

If you do not have enough room on your disk for saving of the
scratchpad or to receive an uploaded file then your system may 
hang because it cannot write any more data to your disk. Here 
you may set a parameter which will stop people dumping or 
uploading once a certain limit has been reached. Setting a value 
of 3 here for example will stop users uploading or dumping if 
there is less than 300K bytes availlable on your disk. Setting a 
value of zero will disable the check.

>48,Necessary space on disk for DUMP/UPLOAD in 100K units?

The system supports several different character sets for users.
To ensure that the transliteration is done correctly for all you
norwegians (where IBM has done the dirty by changing their standard
character set) you should turn the next option on if you see the
following character as a norwegian letter : . If you see a japanese
Yen sign (a capital Y with a line through it) then leave the option
off.

>55,Is your computer using the norwegian character set?

You must also configure the 'default' mode that your users will get
when they first register (they can change it via the utility menu
later). This will normally be the same as the mode that you are
running in locally, but you can choose any of the following:

    IBM : standard IBM        IBN : norwegian IBM 
    ISO : the ISO standard    US7 : ASCII, standard US
    UK7 : british 7 bit       GE7 : german 7 bit
    FR7 : french 7 bit        SF7 : swedish/finnish 7 bit
    NO7 : norwegian 7 bit     DE7 : danish 7 bit
    IT7 : italian 7 bit       SP7 : spanish 7 bit

>56,Default character set for users:

DOORS gives you the possibility of letting users run external
batch files and games if they have permission to do so. If you
are using this function then you must specify the number of doors
you are using. Setting a value of zero disables the function
altogether, setting it to more than requires that you make a list
of available doors on the menu file DOORMENU. When the DOOR is
started the command DOOR n d will be executed, where n is the node
number and d is the door number.

>67,Number of doors being used:

:2

-------------------- MODEM and COMMUNICATIONS ----------------------------

Now we must configure the MODEM, that all-important piece of equipment.
The first thing we need is which communications port it is attached to
(surprise, surprise!). If you are configuring a purely local node then
enter 0 as the answer to this question; in this case you may choose to
have a system that skips the sysop menu and just goes directly to a
user login (useful for networked systems..). If you have a strange COM
port that is not COM1 or COM2, enter 3, the system will then ask you 
for the necessary information (base address and IRQ).

>4,Communications port (0, 1 or 2):
>47,Login directly (skipping menu):
>62,Comms port base address (hexadecimal):
>63,Comms port IRQ number:

When the system starts up, it will send commands to the line. We now
need to know what speed to use when sending commands to the line (this
may affect what kinds of caller the modem will accept, and will also be
the speed used on a direct connect line).

>5,Speed to open modem:

Normally you will be using a smart modem on the comms port. The BBS
also supports direct connect between two PCs, in which case we don't
need to use a modem of course (Login is then started by pressing CR).

>65,Direct connect (no modem):

The modem init string is almost the most important parameter of the system,
as it is the one that will tell your modem how to react to a telephone call.
You may have to consult your manual to get this one exactly right. Two
popular modems in Norway work with the following strings:

    Quattro SB2422 : AT&FS0=0&C1&D2H0E0&G0&K0&I0&A1
    UniMod 4161    : AT&FS0=0&C1&D2H0E0&G0+C0+M2
    Discovery      : AT&FS0=0C1E0G0B0Q0V1X3H0
    CTS Datacomm   : AT&FB0E0Y1&C1&D2&S1M0

>6,Please enter modem init string:

When a caller has dialled in the modem should send the text 'RING' to
the system. When the system sees this it will tell the modem to answer
the phone. The modem answer string does this, usually with 'ATA'.

>7,Please enter modem answer string:

A couple more control strings are used when talking to the modem; these
tell the modem either to take the phone offhook so that anybody calling
will get a busy signal, or to put it back on again (when the system has
finished whatever it was doing). You should probably not need to change
these from the standard settings either.

>8,Please enter modem offhook string:

>9,Please enter modem onhook string:

If you are sharing a voice line with your computer then you
should have a modem with a bypass function to connect the call
on to your phone. Modems that do this sometimes return NO CARRIER
to the system as they pass on the call (if you have one that can
return VOICE then the system will delay for 30 seconds anyway),
and this next option allows you to set a configurable delay after
an unsuccessful connect to give you time to pick the phone up.
LEAVE this option at zero unless you absolutely need it; setting
it above zero will slow down the recycle time for the BBS!

>66,Delay in seconds after unsuccessful connect:

The system uses interrupts to send output to the communications 
port in order to provide 'smooth' output. Most IBM compatibles 
can do this but some do not. If your machine seems to 'hang' when 
it tries to write data on the comms line then try turning on 
this option. If you want to run at constant speed between your
modem and the PC (and have set the modem up correctly) you must also
turn on this option, as it also enables RTS-CTS checking.

>57,Disable interrupted output mode:
>61,Constant speed modem <-> PC:

Mike is playing with connecting this system to a mini: please don't
turn on the next option!!

>23,Use experimental packet switcher?

:3

------------------------ DIRECTORIES --------------------------------------

The system uses three main directories in its operation apart from the
BBS directory itself. These are the MAIN directory which contains the
message databases and users file, the MENUS directory which contains the
system menus, and the FILES directory where user upload are placed. You
may wish to use a RAM disk for your main directory and/or your menus,
so these options permit you to do this.

NOTE! the trailing \ on the directory names is REQUIRED!

The MAIN directory is the directory where the CALLERS, MESSAGE, and
USER files are to be found. It should NOT be placed on a RAM disk
unless your backup procedures are reasonably safe.

>30,MAIN directory name:

The FILES directory is the directory where files uploaded by users
are stored. This should probably also be on your hard disk.

>32,FILES directory name:

You may have two separate menu directories. There are two basic uses
for this. Firstly, you may wish to have the primary directory with
your most used menus on a RAM disk, while having the little-used ones
on the hard disk (so as to save space on your RAMdisk). Secondly, you
may wish to use the primary directory for those menus (like CONFER,
DIRLIST) that you have modified yourself, so that you can unpack a new
release directly into your secondary menu directory without over-
writing your own menus. The system will always look for a menu on the
PRIMARY directory first, going to the secondary directory only if it
is not found there.

>31,MENUS primary directory name:

>35,MENUS secondary directory name:

The 'hold' functions in the file menu use a special directory as a
temporary holding area for the files the user is working with. This
MUST be a separate directory, as one of the things the system will
do at startup time is delete all the files here! Also, if you are
running multiple nodes, the HOLD directory must of course be a
different one for each node.

>13,Name for HOLD directory:

:4

------------------------ NODES AND FILES ----------------------------------

The system does not as yet fully support running several nodes. But it
is on the way. This section is part of the preparation for running more
than one copy of the system in a shared environment. This involves,
among other things, being careful that files that are used exclusively
by the node (like the scratchpad file) get different names on the 
different nodes.

To start with, we need to know the highest node number you are going
to run (this will be the same as the total number of copies of the
system you are going to run at the same time).

>42,Total number of nodes:

And now, which of these are you configuring the system for at the
moment (must obviously be less than or equal to the maximum number)

>41,Number of current node:

Now we have to configure several files that in some cases are not
dependent on the node but are shared throughout the system, some
that have a different copy for each node, and some that you may
choose to either with. In each case you should enter the full
pathname of the file you are configuring.

The scratchpad file is used to temporarily hold data for the user
that he has collected from the conference system. This MUST be
different on each node! Note also that if you are going to allow
ARCing of the scratchpad then this name should NOT have an extension,
ARC will need to be able to append '.ARC' to the name.

>36,Full pathname for scratchpad file:

The callers file is used to log important information about each
caller and what activity he has had while logged on. It is the
file you look at using the sysop L command. It is almost certainly
best to have one of these for each node, although this is not
absolutely necessary (except that you will have difficulty untangling
the data if you do!)

>37,Full pathname for callers file:

The sysop file is used to hold messages for the sysop that will be
shown to you next time you log in as the sysop. This is best shared
between nodes if you don't want to have to log in more than one
place to get all your messages!

>38,Full pathname for sysop message file:

The nodes file is used for communication between nodes, to hold
information that must be passed between one node and another. This
MUST be the same for each node you configure!!

>39,Full pathname for nodes information file:

Chatting and messages between nodes are queued in a set of common
files that are shared between all the nodes. Normally these are 
saved on the MAIN directory, but you may find it useful to use a
RAM disk for these in that they are accessed quite frequently by
the system all the time a user is logged on. The directory MUST
be the same for all nodes!! (And don't forget the trailing \!)

>68,Directory for CHAT files:

The files are checked frequently to see whether there is any input
from the other node. The default frequency is every 2 seconds, but
you may wish to change this either because you have a RAM disk or
because you can't afford the disk access.

>69,Polling interval for CHAT files:

The REMOTE.BAT file is the batch file that is executed when the
sysop exits to DOS with the E command on the sysop menu. If you
are running more than one node this will probably need to be
different from node to node (different port to monitor, etc.)

>40,Full pathname for REMOTE.BAT file:

:5

------------------------ CONFERENCES --------------------------------------

The current version will support up to 75 different conferences. However,
you don't need to have that many to start with (or even have any at all -
you can add them later). Each conference is given a name, and a set of
options describing the special characteristics of the conference.

What we need to know now is how many conferences you want to have:

>11,Number of active conferences:

The system will allow your users to use an alias in some or all of the
conferences. In these conferences the users will not be allowed to
write messages to any other particular user, all new messages will be
by default to ALL. Replies will be properly marked with the alias of
the other user. While the user is in such a conference all references
to his name (also in CHAT between nodes and Who's On) will be replaced
with the Alias. Note that setting use of alias is not permitted in the
mail conference for obvious reasons.

>53,Do you want to use alias names on your system?


As mentioned above, we need a name for each active conference. We also need
to know a number of special options that may or not be set for each of the
conferences. New users can be allowed to read messages, or to both read and
write messages (or you can let the sysop/sigop do this manually later if you
have conferences to which you don't want to give new users access). You can
set up conferences to be 'mail' conferences (all messages are automatically
private), you can allow private messages in other than the mail conference,
allow the use of an alias (if you are using these), set up conferences that
are automatically 'joined' by new users, and set up conferences that all
users are *required* to be members of. Some of these options are mutually
exclusive; the system will then not ask you for the relevant information.
The system as delivered will automatically scan the newest 50 messages
whenever a user joins a conference for the first time. You can change the
number of messages that are scanned; a large number will present users with
a large number of unread messages when they join, smaller numbers the
opposite. A value of zero will suppress the autoscan altogether. Note that
users whoe are *already* members will get a scan of up to 500 messages anyway.
To skip to the next section (ordering of conferences) type Ctrl/X. To skip a
conference and go directly to the configuration for the next conference,
type Ctrl/N!

>12,Please enter Conference Name:

You can also choose that conferences be presented to the user in
a different order to which they are defined in the configuration.
Just skip this section with Ctrl/X if you already have your
conferences in the correct order!

>60,Present conference in position:

:6

----------------------- FILES ------------------------------------------

First of all; the default setup for the system assumes that you do NOT
want new users to be able to upload or download files until they are
upgraded. If this is not the way you wish to run your system then the
following two options are provided:

>43,Allow new users to UPLOAD files?

(Note : for downloads, files that are private to conferences will of
 course still not be downloadable until the correct access is set)

>44,Allow new users to DOWNLOAD files?

The current version will support up to 99 different file directories;
again, you will have to recompile the system if you need more (!). These
may be configured now, or you may add them later. Each directory needs a
name that should be included in your directory list file (DIRLIST on the
MENUS subdirectory). First of all, we must know how many different file
directories you want.

>16,Number of active file directories:

Files uploaded to the system are placed in the Upload directory (directory
zero). If you want these to appear in the directory listing immediately
then you should leave this next option off. If you turn it on you will
have to use the M option on the SYSOP menu to make the file available.

>19,Make new uploads private?

As mentioned above, we need a name for each active directory. So lets do
that....

>17,Please enter Directory Name:

Now you can decide which order the directories should be presented in
when the user uses a command that scans through all the directories:

>64,Present directory in position:

:7

----------------------- EXTERNAL PROGRAMS --------------------------------

Some extra options are available in the system which need help
from external programs for their execution. These are optional
features which you need not configure, but if you do then you
must specify the EXACT pathname and extension for the external
program, as the system will make a direct call to it rather than
use COMMAND.COM to load it. For example, if the program was on
the file C:\PROGRAM\ARC.EXE then you would have to specify just
that, drive, directory, COM extension and all. Note that you must
also have enough memory available (in addition to the memory used
by the BBS) for the programs you specify.

The ARC utilities
-----------------
When a user dumps the scratchpad, he will be allowed to ARC the
scratchpad before transferring it if you turn on the next option.
(NB if you use PKARC you may choose to add ' /OCT' to this string
in order to retain compatibility with older ARC programs). The ARC
program is also used to pack files in the hold area. We also will
need the name of your 'dearchiver' for extracting files to hold.

>33,Allow use of ARChiving utility? 
>49,FULL pathname AND extension for ARC archiver :
>54,FULL pathname AND extension for ARC extracter:

Zmodem protocol
---------------
If you have DSZ.COM available on your system and enough memory to
run it, then the Zmodem protocol may be supported directly.

>34,Allow use of Zmodem protocol?
>50,FULL pathname AND extension for the DSZ utility program:

Kermit protocol
---------------
If you have PCKERMIT.EXE available on your system and enough memory to
run it, then the Kermit protocol may be supported directly.

>51,Allow use of Kermit protocol?
>52,FULL pathname AND extension for the PCKERMIT utility program:

:8

----------------------- MACROS -------------------------------------------

The keys Alt-F1 to Alt-F10 may be configured to send preset strings from
the local keyboard. Useful for signatures, comments in chat mode, and
such. So now we go through doing the ten possible keys...

>21,Please enter macro string:

:9

----------------------- TIMED EVENTS -------------------------------------

The system will allow up to twenty 'timed events'. These are standard batch
procedures that are run either daily or weekly at preset times. You do not
have to use these, but you may find them useful for things like taking
automatic backups of your system and the like. You can also configure a
timed event to take your system down for you, by not including a GO in
the EVENTx.BAT file. First of all we need to know how many of these timed
events you would like to have on your system.

>24,Number of timed events:

To make it easier to identify the 'timed events' each will be given a
name. If you have any, please enter their names now. Note that the actual
.BAT files used to start the events use the NUMBER of the event, so the
file used to start event 3 for example should be saved as EVENT3.BAT,
whatever name you have used here.

>25,Name of timed event:

Each timed event may be run either every day or once a week on a specified
day of the week. We will now run through your timed events; those that
are to be run daily should be given a value of zero, those that are to be
run weekly should get a value of from 1 to 7 (1 means run every Sunday, 2
every Monday, until we get to 7 which means every Saturday).

>26,Daily(0) or day of week (1-7):

Each event has an 'earliest time' at which it may be run. The event will
in case be run before this time of day. Enter the time in military format,
for example '7:30' means half past seven in the morning, while '22:00'
would mean 10 in the evening. 

>27,Earliest time to run:

Each event also has a 'latest time'. This is used to check how much time
a user logging into the system may be given. The more time you allow
between the earliest and the latest time the less you will disturb your
users. For example, if you configure earliest time to be 7:00 and latest
time to 8:00 then the event will be run at 7:00 if nobody is on the system.
A user logging on before 7:00 will be given his full quota or until 8:00
if he has more than a hour of available time. If you want the event to
be run at an *exact* time then set the latest time to the same as the
earliest time.

>28,Latest time to run:

While the event is running, you have the choice of leaving the phone
off the hook (so your callers get a busy signal) or leaving it on
the hook, thus freeing the phone line for other uses.

>29,Take phone off hook while running:



