home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Hack-Phreak Scene Programs
/
cleanhpvac.zip
/
cleanhpvac
/
PCBDEMO.ZIP
/
PCBDOCS.EXE
/
SETCONFS.DOC
< prev
next >
Wrap
Text File
|
1994-02-14
|
102KB
|
2,194 lines
6
==============================================================================
Conference Setup
Main Board Configuration
Conferences
Conference Options Screen
Sharing Files Between Conferences
File Directories
Doors
Script Questionnaires
Bulletins
The PCBSetup Main Menu contains two menu items that will help you setup
conferences. The first selection will allow you to modify the configuration
of the Main Board (conference 0) while the second option will allow you to
select the conference number you want to modify (1-65,535).
Main Board Configuration
The Main Board is a special conference. This conference is the base
conference of PCBoard and it is sometimes referred to as conference 0. When
a user abandons a conference they will be returned to the Main Board
conference.
The reason that there are two different menu options on the Main Menu is
because the following fields that are available in other conference
definitions would have no effect on the Main Board Conference:
Conference Name
Public Conference
Password to Join if Private
Req. Security if Public
Auto-Register Flags
The Main Board is a public conference by default and the conference that most
people will login to. You can lock a user out of the Main Board if you wish,
by setting the L conference flag in a user's record.
For information on all of the fields available in the Main Board
Configuration screen, please reference the Conferences | Display Files And
Message Locations and Conference Options Screen sections.
Conferences
When you select the Conferences option from the Main Menu, you will be
presented with a list of conferences on your system. You need to select the
conference that you wish to edit from this list.
Selecting a Conference To Edit
The screen that lists your conferences looks similar to the
following:
To edit a conference, move to the conference you want to edit and press
ENTER. The keyboard commands that you can use to move the highlighted bar
are:
[conf. #] Anytime that you begin typing a number you will see a field
show up on your screen which enables you to go directly to a
particular conference. The field will appear towards the top
of the screen as shown in the screen on the following page.
PgDn View the next 42 conferences in your system.
PgUp View the previous 42 conferences in your system.
Home Highlight the first conference on the current screen.
End Highlight the last conference on the current screen.
As you are moving the highlighted bar around, you may notice that it
disappears once you have passed a certain number. When the bar disappears,
it is letting you know that you have passed the number that you entered as
Number of Highest Conference Desired in PCBSetup | Configuration Options |
Messages. Another way that you will know when you have exceeded this number
is when PCBSetup emits a beep when attempting to edit the conference.
Once you have selected the conference you want to edit, press ENTER to see
the first screen of fields that you may edit relating to that conference.
When you are editing a particular conference you can press PgDn to go to the
second configuration screen or press PgDn twice to go to the next available
conference. To go to the previous conference, press PgUp.
Conference Name / Definition
Conference Name
In this field, enter the name you wish to use for this conference. This name
will be shown at the conference command prompt. For example, when you are in
the Chit-Chat conference the conference command prompt will resemble the
following:
(13 min. left) Chit-Chat Conference Command?
This name will also be used if a user attempts to join a conference. PCBoard
will search by conference name or by conference number.
Public Conference
A conference can be configured to be either a public conference or a private
conference. A public conference can be joined by anyone if they have
sufficient security to do so (see the discussion about the Req. Security if
Public field on this screen for further information). A private conference
requires that a user be registered (the R conference flag is set in their
user record) in order for them to join the conference.
N The conference will be considered a private conference. Users
must be registered in the conference before they may join the
conference.
Y The conference will be a public conference. In order to join
a public conference, the user must have a security level that
is greater than or equal to the value you enter in the Req.
Security if Public field.
Req. Security if Public
If you have defined your conference to be a public conference, you should
enter the security level that is required to join the conference in this
field. If a user attempts to join a conference and they do not have
sufficient security, they will not be allowed to join the conference.
One exception to this rule is, PCBoard will allow the user to join the public
conference if the R flag has been set in their record. This would allow you
to manually register users in a public conference even if the security level
requirements are not met.
Password to Join if Private
If you have defined a conference as a private conference, you can have
PCBoard automatically register your users in the conference if they know the
proper password. This would be a good situation where you want to enable
only a select few individuals into a conference but do not want to manually
register all of the users. If a user that is not registered in the
conference attempts to join the conference, they will be prompted for a
password.
The user will be given one attempt at guessing the password each time they
attempt to join the private conference. If the user gets the correct
password, PCBoard will register the user in the conference with an R flag.
By doing this, the user will not have to enter the password each time they
join the conference.
If you decide you want to change the password, you may want to de-register
all users in the conference via System Manager | Users File Maintenance |
Remove Group Conference. After you do this, all users would have to re-enter
the correct password to become registered in the conference again.
NOTE: To help deter hackers from gaining access to a conference, PCBoard
will hang up on the caller if they fail to get the right password after 8
attempts per session.
Auto-Register Flags
In a public conference, you do not need to use conference registration flags
for a user to be able to join the conference. The ability to join a
conference is based on the security level of the user and the minimum
security level that you want joining the conference. However, by setting the
conference flags, you can speed up the caller's access to the conference.
This is possible because PCBoard then does not have to read in the conference
information to determine the public/private status or the security level
requirements. Valid characters in this field are:
[blank] When a user joins a conference for the first time, no changes
will be made to their conference registration flags. Each
time the user joins the conference, PCBoard will check to
make sure that the user has sufficient security to join the
conference.
R When joining a conference for the first time, the R
conference flag will be set in the user's record so that
their security will not be checked each time they join the
conference. This will enable the user to join the conference
quicker. If you do not also set the X flag, then the user
will not be able to join the conference when their
subscription expires (assuming you have subscription mode
enabled).
X When joining a conference for the first time, the X
conference flag will be set in the user's record. When this
flag and the R conference flag is set, the user will have
access to the conference at all times (even when their
subscription has expired). If the X flag is set, but not the
R flag, the user will be locked out of the conference.
S The S conference flag will be set if the user is joining the
conference for the first time. The S flag will mark the
conference for scanning when reading mail within PCBoard.
You can enter any combination of the R, X, and S conference flags in this
field or you may leave the field blank. For example, you may want to enter
R, RX, or even RXS.
Display Files And Message Locations
Number of Message Blocks
Versions of PCBoard prior to v15.0 used a different method of indexing the
message bases. You were required to enter the number of message blocks you
wanted to use for this older format. If you are running third-party software
which requires use of the older index files, you can have PCBoard maintain
these older format index files for you by using the /OLDINDEX environment
setting for PCBOARD.EXE or by setting the option in each conference
configuration regarding old index support.
As mentioned previously, the old index format requires a message block
setting. In this field, enter the number of message blocks that you want to
use for this older message index format. Each block represents a RANGE of 1K
in message numbers. That is, with 1 block defined you may have a RANGE of
messages from a low number of 1 to a high number of 1024. Likewise, 100,001
up through 101,024 is also valid with a block setting of 1.
Each block requires 4 kilobytes of disk space. Regular use of PCBPack will
remove numbers from the low end and this will slide the range forward.
Usually you will not have to increase the number of blocks for the message
base beyond a value of 4 or so unless you have extremely high traffic or keep
very old messages in the message base.
NOTE: If you are not maintaining the older index formats then the value in
this field will be ignored. In addition, if you run a multi-node system this
number must be the same for this conference on all nodes on the system.
Name/Loc of MSGS File
Each conference has a message base file where messages left in the conference
are stored. In this field, enter the name and location of the message file
that you want to use for this conference. Normally, the filename you specify
in this field will be unique to any other conference but it is not absolutely
required to be unique. For example, if you enter H:\PCB\MSGS\CONF001 in this
field, then PCBoard will think that the message base will be stored in
H:\PCB\MSGS\ using the filename CONF001.
Name/Loc of User's Menu
PCBoard, by default, has one main menu that is displayed at each conference
command prompt when in novice mode. This menu is used by your callers so
that they know which commands are available on your system. The menu file is
simply a text file so you can customize it any way that you think will make
it easier for your users to navigate around the system.
In this field, enter the name and location of your user menu for this
conference. Remember, that several conferences can point to the same menu
file if you wish to reduce the complexity of your system.
Editing The User Menu File
If you wish to edit the user menu file, press F2 to edit the non-graphics
files and F3 to edit the graphics specific file. To create security specific
and language specific files, you will need to do so directly from the DOS
prompt using the display file conventions.
Name/Loc of Sysop's Menu
Because the SysOp has more menu options available to them than regular users,
this file will be displayed as the menu for those users who have SysOp
security level or higher. The SysOp security level is defined in PCBSetup |
Security Levels | Sysop Commands.
In this field, enter the name and location of the SysOp menu you wish to use.
If you do not want to maintain two separate menu files (one for SysOps and
one for regular users), enter the filename of the user menu in this field.
Editing The SysOp Menu File
If you wish to edit the SysOp menu file, press F2 to edit the non-graphics
files and F3 to edit the graphics specific file. To create security specific
and language specific files, you will need to do so directly from the DOS
prompt using the display file conventions.
Name/Loc of NEWS File
Each conference can specify a different news file. The news file is
typically used to make the users aware of upcoming events, policies of the
board and general information that you want the users to be aware of.
In this field, enter the name and location of the news file for the
conference. If you leave this field blank, no conference news file will be
available to your callers.
Editing The Conference News File
If you wish to edit the news file, press F2 to edit the non-graphics files
and F3 to edit the graphics specific file. To create security specific and
language specific files, you will need to do so directly from the DOS prompt
using the display file conventions.
Name/Loc of Conf INTRO File
Each conference may have an introduction file. This file is typically used
to remind the user of any particular items of interest about this conference.
For example, if you want the users to know what is expected in the conference
each time they join it, you would use the introduction file. Remember, this
file will be displayed each and every time the user joins a conference unless
the Q subcommand is used when joining the conference. This file may be
displayed while doing mail scans as well if you have enabled the Show INTRO
in `R A' scan (Conference Options Screen).
In this field, enter the name and location of the introduction file for the
conference. If you leave this field blank, no introduction file will be
displayed.
Editing The Conference Introduction File
If you wish to edit the conference introduction file, press F2 to edit the
non-graphics files and F3 to edit the graphics specific file. To create
security specific and language specific files, you will need to do so
directly from the DOS prompt using the display file conventions.
Location for Attachments
The drive and subdirectory that you enter in this field will determine where
file attachments will be stored for this conference. If you leave this field
blank, you will be specifying the current directory as your directory for
file attachments which is not recommended.
Public Uploads
Sort
In this field, enter the sort type to be used by PCBFiler for the public
upload DIR (description) file. Valid values are:
0 Do not sort.
1 Sort by filename (ascending / A-Z)
2 Sort by filename (descending / Z-A)
3 Sort by file date (ascending)
4 Sort by file date (descending)
Name/Loc Upload DIR File
PCBoard stores the file descriptions in a separate file for each directory
(including upload directories). In this field, enter the name and location
of the public upload DIR (description) file. This file contains the name,
size, date, and file description of files uploaded to your system, when
uploads are public.
Location of Uploads
In this field, enter the drive and subdirectory where you want the actual
files that are uploaded as public uploads to be stored. If you are running
multiple nodes, you will want to make sure this location is the same for all
nodes. Otherwise, files may be available on one node, but not available on
another node. For example, you may want to enter F:\PCB\UPLOADS\ in this
field.
Private Uploads
Sort
In this field, enter the sort type to be used by PCBFiler for the private
upload DIR (description) file. Valid values are:
0 Do not sort.
1 Sort by filename (ascending / A-Z)
2 Sort by filename (descending / Z-A)
3 Sort by file date (ascending)
4 Sort by file date (descending)
Name/Loc Upload DIR File
PCBoard stores the file descriptions in a separate file for each directory
(including upload directories). In this field, enter the name and location
of the private upload DIR (description) file. The name, size, date, and file
description of files that are uploaded to your system, when uploads are
private.
Location of Uploads
In this field, enter the drive and subdirectory where you want the actual
files that are uploaded as private uploads to be stored. If you are running
multiple nodes, you will want to make sure this location is the same for all
nodes. Otherwise, files may be available on one node, but not available on
another node. For example, you may want to enter F:\PCB\PRIVUPLD\ in this
field.
Doors
Menu Listing
When a user uses the OPEN or DOOR user commands without specifying a door
name or number, PCBoard will display a menu of doors that are available. The
filename you enter in this field will be the file that is displayed to the
caller. This file is a standard display file so you may have security,
graphics, and language specific versions of the menu. Because you can have
different versions of the doors menu, you should not specify a filename
extension or you will eliminate the ability to have different menus for
languages on your system (if you have defined them). For example, you may
enter C:\PCB\MAIN\DOORS or any other valid filename in this field.
Editing The Door Menu File
If you wish to edit the door menu file, press F2 to edit the
non-graphics files and F3 to edit the graphics specific file. To create
security specific and language specific files, you will need to do so
directly from the DOS prompt using the display file conventions.
Path/Name List File
The Path/Name List File, as it is called, refers to the data file that is
used to define the doors that are available in the conference. This is the
file you will edit to define, delete, or alter the configuration of the doors
available in this conference. To edit this file, press F2 while the filename
is highlighted. Please refer to the Doors section in the chapter for
additional information on editing this file..
NOTE: Even though this file is not a display file, you may create security
specific versions of the Path/Name List File. For example, if the file is
called DOOR.LST, you can create a DOOR50.LST that would be used exclusively
by those with a security level of 50.
Bulletins
Menu Listing
When a user uses the B user command without specifying a bulletin number,
PCBoard will display a menu of bulletins that are available. The filename
you enter in this field will be the file that is displayed to the caller.
Even though this file is a standard display file, you cannot have a security
specific version of this menu. You may create graphic and language specific
versions of this menu.. Because you can have different versions of the
bulletin menu, you should not specify a filename extension or you will
eliminate the ability to have different menus for languages on your system
(if you have defined them). For example, you may enter C:\PCB\MAIN\BLTS or
any other valid filename in this field.
Editing The Bulletin Menu File
If you wish to edit the bulletin menu file, press F2 to edit the non-graphics
files and F3 to edit the graphics specific file. To create language specific
files, you will need to do so directly from the DOS prompt using the display
file conventions.
Path/Name List File
The Path/Name List File, as it is called, refers to the data file that is
used to define the bulletins that are available in the conference. This is
the file you will edit to define, delete, or alter the configuration of the
bulletins available in this conference. To edit this file, press F2 while
the filename is highlighted. Please refer to the Bulletins section in this
chapter for additional information on editing this file.
NOTE: Even though this file is not a display file, you may create security
specific versions of the Path/Name List File. For example, if the file is
called BLT.LST, you can create a BLT50.LST that would be used exclusively by
those with a security level of 50.
Scripts
Menu Listing
When a user uses the S user command, PCBoard will display a menu of script
questionnaires that are available. The filename you enter in this field will
be the file that is displayed to the caller. Even though this file is a
standard display file, you cannot have a security specific version of this
menu. You may create graphic and language specific versions of this menu.
Because you can have different versions of the script menu, you should not
specify a filename extension or you will eliminate the ability to have
different menus for languages on your system (if you have defined them). For
example, you may enter C:\PCB\MAIN\SCRIPTS or any other valid filename in
this field.
Editing The Script Questionnaire Menu File
If you wish to edit the script questionnaire menu file, press 2 to edit the
non-graphics files and F3 to edit the graphics specific file. To create
language specific files, you will need to do so directly from the DOS prompt
using the display file conventions.
Path/Name List File
The Path/Name List File, refers to the data file used to define the script
questionnaires that are available in the conference. This is the file you
will edit to define, delete, or alter the configuration of the script
questionnaires available in this conference. To edit this file, press F2
while the filename is highlighted. Please refer to the Script
Questionnaires section in this chapter for additional information on editing
this file..
NOTE: Even though this file is not a display file, you may create security
specific versions of the Path/Name List File. For example, if the file is
called SCRIPT.LST, you can create a SCRIPT50.LST that would be used
exclusively by those with a security level of 50.
Directories
Menu Listing
When a user uses the F user command without specifying a subcommand, PCBoard
will display a menu of file directories that are available. The filename you
enter in this field will be the file that is displayed to the caller. Even
though this file is a standard display file, you cannot have a security
specific version of this menu. You may create graphic and language specific
versions of this menu.. Because you can have different versions of the
script menu, you should not specify a filename extension or you will
eliminate the ability to have different menus for languages on your system
(if you have defined them). For example, you may enter C:\PCB\MAIN\DIR or any
other valid filename in this field.
Editing The File DIrectory Menu File
If you wish to edit the file directory menu file you can press 2 to edit the
non-graphics files and F3 to edit the graphics specific file. To create
language specific files, you will need to do so directly from the DOS prompt
using the display file conventions.
Path/Name List File
The Path/Name List File, as it is called, refers to the data file that is
used to define the file directories that are available in the conference.
This is the file you will edit to define, delete, or alter the configuration
of the file directories available in this conference. To edit this file,
press F2 while the filename is highlighted. Please refer to the File
Directories section in this chapter for additional information on editing
this file.
NOTE: Even though this file is not a display file, you may create security
specific versions of the Path/Name List File. For example, if the file is
called DIR.LST, you can create a DIR50.LST that would be used exclusively by
those with a security level of 50.
Download Paths
Path/Name List File
The Path/Name List File, refers to the data file used to define the paths
that PCBoard will search to locate files that are available for downloading
in this conference. This is the file you will edit to define, delete, or
alter the configuration of the paths that search for downloadable files. To
edit this file, press F2 while the filename is highlighted. Please refer to
the File Directories section in this chapter for additional information on
editing this file.
NOTE: Even though this file is not a display file, you may create security
specific versions of the Path/Name List File. For example, if the file is
called DLPATH.LST, you can create a DLPATH50.LST that would be used
exclusively by those with a security level of 50.
Conference Options Screen
These conference options are made available to you when you press d while in
the conference configuration screen. These options give you more control
over how the conference will operate.
Auto-Rejoin into this Conf.
In certain situations it may be desirable to have the user automatically
re-join a conference if they logoff while in that conference. For example,
you may have a conference set aside for each of several groups of users on
your system. Your system may be configured so that all of the information
they need to obtain can be found in the conference which is dedicated for
their use. You could then lock the users out of all other conferences (using
the L conference flag) and force them to join their conference next time they
logon. Valid options for this field are:
N When the user logs in the next time, they will be placed into
the Main Board (Conference 0).
Y The next time the user logs onto the system, they will
automatically rejoin this conference if they disconnected
from the system while in this conference.
Allow Viewing Conf. Members
This option controls whether or not a user will be asked to view a list of
users who are registered in the conference they are about to join. This
question is asked only once per session (when the conference is joined for
the first time). Valid options for this field are:
N Users are not asked if they wish to view conference members
when they join the conference. The users may still be able
to use the USERS command to see the same information. This
command, however, is controlled by security level in PCBSetup
| Security Levels | User Commands.
Y Users will be asked if they wish to view conference members
when they join the conference for the first time during that
session.
Make All Uploads Private
With the concern of virus infected or other damaging files being sent over
the modem, you may want to screen all of your uploads before making them
available to your callers. An additional concern would be if your callers
were uploading files that you deemed inappropriate for your system. In this
case too, you will most likely want to make all of your uploads private. By
making an upload private, you are telling PCBoard to place all files that are
uploaded in the conference to the private upload directory that you specified
on the first screen. Valid options for this field are:
N All uploads in the conference will be considered public
uploads unless the user enters a / as the first character of
their description. Once the file is uploaded, callers will
be able to download it without you screening the files.
Y All uploads will be sent to the private upload directory even
if the description the user entered does not begin with a /.
It is then your responsibility to screen the uploads and move
them (using PCBFiler) out of the private upload directory to
one of your download directories. If you have defined your
public upload directory (even though you are making all
uploads private) PCBoard will consider the public upload
directory valid for your users. This means that you could
screen your uploads and then move them over to your public
upload directory where your users will easily be able to find
new uploads to your system.
Make All Messages Private
Not only can you make all uploads to a conference private, but you can also
make all messages in a conference private as well. While it is less likely
that you want to screen your messages, the conference that you are editing
may have a lot of one on one conversations where making all messages private
would be the ideal situation. Valid options for this field are:
N When entering a message, the user can assign the message
security of their choice when prompted. This means that they
can choose to make a message private, public, group password
or any other valid message security option. If you want to
make a public message private, you may do so by using the P
subcommand at the End of Message Command prompt.
Y Users will not be given the choice to assign security to a
message. Instead, all messages will be deemed RECEIVER ONLY.
As you read these private messages, you can unprotect them
(making them public messages) by using the U subcommand at
the End of Message Command prompt.
Echo Mail in Conference
The primary design of a bulletin board system is to distribute information to
the callers of the system. Some systems get involved with echo mail
networks where several bulletin board systems exchange messages with one
another. Valid options for this field are:
N You do not plan on sharing messages in this conference with
other systems. Users will not be asked any questions about
echoing the message they are entering.
Y When entering a message, the user will be asked if this
message should be echoed to other systems or not. PCBoard
does not actually transfer the mail (that is up to the
network mail software). Therefore, it is up to the network
mail software to honor the echo flag if it is set. If you
want to force all messages to be marked as messages for
echoing then you should enable the Force Echo on all Messages
option on this same screen.
Force Echo on All Messages
If you would rather force all messages left in the conference to be marked
for echoing, enable this option. When entering messages, your users will not
be allowed to choose whether or not the message should be marked for echoing
or not. For this setting to have any effect, you must have answered Y to the
Echo Mail in Conference question. Valid options for this field are:
N Allow the user to choose whether or not the message they are
entering should be mark for echoing or not.
Y Force all messages entered in the conference to be marked for
echoing. The user is never given a choice.
Allow Internet (long) TO: Names
The normal limit for user names when addressing message is 25 characters.
However, some networks such as the Internet can have extremely long
identities or addresses. If you are echoing a conference that requires the
TO: field to allow input of more than 25 characters, you can choose to do so
based on your answer to this field. Valid options for this field are:
N Users are given up to 25 characters to address their message.
Y Users are given up to 120 characters to address their message.
Make Conference Read-Only
You may desire to make some conferences read-only. Users cannot reply or
enter messages in conferences that are marked as read-only. If you would
rather limit who can enter messages by security level, refer to the Level to
Enter a Message field on this screen instead. Valid options are:
N Users can enter and reply to messages as they read them.
Y Users (not even the SysOp) will be able to enter messages in
this conference.
Disallow Private Messages
Private messages are not often supported in echo mail networks. Therefore,
you may wish to not allow users to leave private messages in these
conferences. This field controls whether or not a user can enter private
messages in a conference. Valid options for this field are:
N Users can choose to enter private messages if they are
prompted for the message security.
Y Users will not be able to enter a private message if they are
prompted for the message security. If they attempt to,
PCBoard will warn them that private messages cannot be left
in this conference and then prompt them again for the message
security that they wish to assign to the message.
Place Origin Info in Messages
When you participate in an echo mail network, information that refers to
where the message originated from is usually appended to the end of the
message. You can tell PCBoard to include this origin information directly
into the message if you wish. The origin information is taken directly from
the Board Name field in PCBSetup | Node Information. For most systems, it is
up to the echo mail software if you should have PCBoard include the origin
information or not. Please refer to the documentation for your mail software
to see if it requests that PCBoard include this information. Valid options
for this field are:
N Do not place origin information in each message entered in
this conference.
Y Include the origin information for each message entered in
this conference.
Prompt for ROUTE Info
Some mail networks will allow you to route a message directly to a particular
site in the echo mail network. Check with your echo mail documentation to
see if it supports routing and if it knows how to extract routing information
directly from PCBoard. In order for a user to be prompted for routing
information the following must be true of the message being entered:
The message must be marked for echoing
The message must be a private (RECEIVER ONLY) message
If prompted for routing information, the user will be able to enter up to 58
characters to identify where the message should be directed to. The echo
mail software that you are using will determine the format that the routing
information should be entered in. Valid options for this field are:
N Users will not be prompted for routing information.
Y Users will be prompted for routing information if the
aforementioned conditions are met.
Allow Aliases to be used
Once you have installed the Alias PSA you need to determine which conferences
each user's alias will become active. Each conference has this field which
determines if alias will be used or not. Valid options for this field are:
N Even if the user has defined an alias to use (using the W
user command), only their real name will be used while in
this conference.
Y While in this conference, the user's alias name will be in
use.
Show INTRO in 'R A' Scan
The conference introduction file is normally only displayed when a caller
uses the J user command to join a conference. However, to help separate
conferences and make the transition from one conference to the next more
obvious you can display the introduction file more often. When using the A
or ALL subcommands with the R user command, this setting will determine if
the introduction file for the current conference will be displayed before the
conference is actually scanned for new mail. Remember, this setting is
conference specific, so if you want the introduction file for all of your
conferences to be displayed, you will need to change this setting for all of
your conferences. Valid options are:
N Conference introduction files will only be displayed only
when joining conferences and not during new mail scans.
Y In addition to being displayed when joining a conference, the
introduction file will be displayed when scanning for new
mail using the A or ALL subcommands of the R user command.
Maintain Old MSGS.NDX File
Older (non-v15.0 compliant) software may not read the new IDX files and
consequently may not be able to recognize messages on your system. This
setting will determine whether or not PCBoard will maintain the older NDX
format for this conference. Valid options are:
N PCBoard will continue to maintain only the IDX file (not the
older NDX file) for the conference.
Y In addition to maintaining the IDX file, PCBoard will also
maintain the NDX file as well so that software designed to
operate with v14.x (but not v15.0) will be able to operate
properly.
NOTE: If you want to force all conferences to maintain the older NDX format,
use the /OLDINDEX environment switch for PCBoard.
Conf-Specific CMD.LST File
You will probably recall that there is what is referred to as a global
CMD.LST file defined in PCBSetup | File Locations | Configuration Files.
Normally, the commands that you define in that file will be available in all
conferences. If you want a conference to use a different CMD.LST, specify
the CMD.LST to use in this field. By entering a filename in this field you
are overriding the entire contents of your global CMD.LST file with whatever
commands are defined in your conference specific version.
Additional Conference Security
In this field, enter the amount of security that should be added to the
user's security level at the time they join this conference. The value that
you enter may be positive or negative and can range from -99 to 999. If the
value you enter is negative, then the caller's security will be lowered upon
joining the conference. Also, remember that PCBoard supports security levels
up to 255. Even though you can add 999 to a security level it would not be
practical to do so. Try to limit all security level adjustments so that they
remain under 256. Entering 0 in this field will leave the security level of
the caller unchanged when joining this conference.
NOTE: The change in security level will only be in effect while in the
conference. When the conference is abandoned or another conference is joined
then the user will return to their assigned security level.
Additional Conference Time
In this field, enter the amount of time that should be added to the user's
time remaining on the system at the time that the conference is joined. You
may enter any value between 0 and 999 in this field. A value of 0 will not
adjust the time of the caller when joining the conference.
Once the time is added, it is not removed until the caller logs off of the
system. This means a user could join this conference to get a additional
boost in time. Perhaps the additional time could be used as some sort of
incentive. The additional time is not added each time the user joins the
conference. Instead, it is added the first time they join the conference
during each call.
Level to Save File Attachment
The ability to attach files to messages can be a powerful feature and at the
same time an annoying feature if abused. In this field enter the security
level that is required to save a message with an attached file in this
conference. The value you enter in this field must be between 0 and 255. By
setting this value to a higher value, you can let your most trusted users
attach files without having to worry about it being abused.
Level to Enter a Message
For some conferences, you may want the primary purpose of the conference to
have users read messages. You could disable the ability to enter messages
(or replies) by entering Y in the Make Conference Read-Only. Enabling this
setting, however, would not allow you to enter messages directly into this
conference. In this field, enter the security level that is required for a
user to leave a message in this conference. If you did make the conference
Read-Only, the value you enter in this field will have no effect.
Be aware that there is a global security level that can be assigned to the E
user command in PCBSetup | Security Levels | User Commands. Whichever value
is higher (the global setting or the conference specific setting) will be the
controlling security level for entering messages and replies.
Level to Request Return Receipt
Like the file attachment feature, users can end up abusing the ability to
request return receipts on their messages. If this feature is abused, your
message bases could quickly become full of un-necessary messages because each
return receipt is a message. In this field enter the security level that is
required for a user to be able to request a return receipt in this
conference. You may enter any value between 0 and 255. Entering a high value
in this field can disable the ability to request return receipts for all or
some of your callers.
Level to Enter Carbon List Msgs
To address a single message to a group of users on the system, the message
can be addressed to @LIST@. Once you address the message in this manner,
PCBoard will prompt the user for a list of names that the message should be
addressed to. You can control the security level that is required to address
messages in this manner. In this field enter the security level that is
required for a user to address a single message to a group of users. When a
user attempts to address a message to @LIST@ and either does not have
sufficient security or the Carbon Copy List Limit is set to 0, the message
will be addressed to ALL instead.
Carbon Copy List Limit
When addressing a message to a group of users, you can set the maximum number
of users that the message can be addressed to. In this field enter a value
between 0 and 99 that will determine the maximum number of users that can be
addressed. A value of 0 disables the ability to enter @LIST@ messages. When
a user attempts to address a message to @LIST@ and either does not have
sufficient security or the Carbon Copy List Limit is set to 0, the message
will be addressed to ALL instead.
Sharing Files Between Conferences
The conference configuration screens specify the location of several files.
As you know, conferences are designed to separate groups of people and or
common information together.
You will have different message bases for every conference but you may want
to use the same door, script, and bulletin configurations for multiple
conferences. For example, conference 1 and conference 3 on your system may
have separate message bases, but you may want to make the same doors
available in both conferences.
Rather than having to maintain two separate DOORS.LST files, you can have
both conferences use the same DOORS.LST file. When you make a change to the
file, the change will be seen in both conferences (because they are both
reading from the same configuration file on disk). This would mean that
conference 1 and 3 may have C:\PCB\GEN\DOORS.LST entered while conference 2
could have C:\CONF\2\DOORS.LST because it will have different doors defined.
This concept can be applied to any of the file locations in the conference
configuration screens.
File Directories
In order for users to be able to transfer files on your system, you will need
to have some file directories available. Each conference can specify a
different set of file directories and each file directory can contain
virtually an unlimited number of files. The file directories simply store
the filename, date, size, and description of a file that is available for
download.
Creating
To create a file directory, you must understand how DIR, DIR.LST, and
DLPATH.LST interact with one another to form your file directory system. The
following lists the three files that make up your file directories in each
conference configuration screen:
Directories : C:\PCB\GEN\DIR : C:\PCB\GEN\DIR.LST
Download Paths (listing only) :
C:\PCB\GEN\CDLPATH.LST
To help illustrate how these files interact with one another we are going to
go through a step by step process on how to setup some file directories.
First, you need to have a brief overview of DIR, DIR.LST, and DLPATH.LST.
DIR is the file that gets displayed to the user when they select (F)ile
Directories from the menu.
DIR.LST is the file that PCBoard uses to determine where the file
descriptions are stored, and the description for the directory contents.
PCBFiler uses DIR.LST to determine where the files are stored on your hard
drive or similar device. PCBFiler also determines what method to use when you
sort your directories by reading DIR.LST.
DLPATH.LST is a file that contains a list of paths that PCBoard should search
through for files a user requests to download. Only the paths listed in this
file are searched when a user requests to download a file.
The first thing you will want to do is to think about categories you would
like to define as file directories. For example, you may have categories
called Printer Fonts, Adventure Games, Disk Utilities, etc. Once you have
determined which file categories you wish to create, you are ready to begin
adding entries in DIR.LST.
To edit DIR.LST, load PCBSetup by either loading PCBSETUP.EXE from your \PCB
directory or select the PCBSetup button from your call-waiting screen. Once
you are in PCBSetup, select either I or J from the PCBSetup Main Menu to
enter one of the conference configuration screens. Now you only need to move
your cursor over to the DIR.LST entry and press F2 to edit the file. Your
screen should now resemble the following:
The first field you will be editing is labeled as DIR Text File Name & Path.
This is the full path and filename where PCBoard will be storing descriptions
(not the actual files for download) for the directory number identified at
the left hand side of the line in this file. You can name this file anything
you want, although filenames without extensions are highly recommended. The
descriptions in your DIR file will look like the following:
PCBSHOW.ZIP 89722 02-20-91 PCBoard v14.5 Introductory SHOW dated
2/20/91. This program gives a quick
demonstration of installing PCBoard
It's final goal being that of giving
new sysops a quick start. Other SHOWs
may follow in the future.
Uploaded by: Dan Moore
The next field in your DIR.LST is Hard Disk Subdirectory. This field should
contain the drive and subdirectory where a majority or all of your files are
stored for this file directory. PCBFiler uses this field to help determine
where the files are located on disk when you edit/move files and file
descriptions. Remember, PCBoard never uses this field to locate files
requested for download.
It is only possible to assign one drive and subdirectory per file directory.
If you have files stored in more than one drive and directory, enter the
drive and directory where the majority of the files for this directory are
located.
The last field on this screen asks what type of sort method you wish to use.
You can specify any of five choices (0-4) that are listed at the bottom of
your screen. When you use PCBFiler to edit/move files and file descriptions,
the sort method you specify here will be used to rearrange the file
descriptions.
There is one more screen to edit before you are finished. If you press 2,
you will notice that the screen changes. You still see the column labeled
DIR Text File Name & Path. However, the Hard Disk Subdirectory and Sort
fields are no longer on this screen. Instead, there is a field called
Description of Directory Contents.
In this field, you enter a description of what type of files can be found in
this directory. If one of your directories contains laser printer fonts, you
could enter Laser Printer Fonts in this field. When your users are doing file
scans using the (Z)ippy, (L)ocate, and (N)ew commands they will see these
descriptions to the right of the directory number. Example:
Scanning Directory 1 (Printer Fonts)
Scanning Directory 2 (Adventure Games)
Scanning Directory 3 (Disk Utilities)
Scanning Directory 4 (Security Related Files)
All of the descriptions between the parentheses were entered in DIR.LST on
the second screen. If you do not enter any descriptions in the Description
of Directory Contents field, you will see the following when you do a
directory scan:
Scanning Directory 1 ()
Scanning Directory 2 ()
Scanning Directory 3 ()
Scanning Directory 4 ()
If you have not yet defined all of your file directories in DIR.LST you
should do so now. If you do not have enough lines and need more, you can use
ALT-I to insert a new line. Likewise, if you have defined a file directory
that you do not want, you can use ALT-D to delete it.
Assuming you have defined all the file directories you wish to define, it is
now time to move on to DLPATH.LST. This file contains a list of paths that
PCBoard will search when a user requests a file to download. This is the
ONLY file that PCBoard will search to determine if a file is available for
download. Even if the description for the file is listed in one of the file
directories, it will not be allowed to be downloaded unless the file is found
in one of the directories listed in DLPATH.LST.
Because the DLPATH.LST is not directly tied into DIR.LST you can enter any
directories that you wish in this file. For example, since PCBoard allows
callers to download bulletins, you may want to list the directory where all
of your bulletins are stored (e.g., C:\PCB\BLT) in the DLPATH.LST file. You
might also have a special directory set aside where you allow users to
download files that are not listed in the directories. These may be private
files that you want to make available to individuals you individually inform
of the specific filenames.
For the most part your DLPATH.LST will contain all of the directories you
listed in the Hard Disk Subdirectory column in DIR.LST, the location where
all of you new uploads are stored.
The final file you will need to edit is your DIR "Menu Listing" file and your
file directory setup will be finished. See Creating Menu later in this
section.
Adding Files To
Adding files for download in your file directories can be an easy process.
What you need to do is copy the files to one of your directories, and use
PCBFiler to provide the descriptions for the files. See the PCBFiler chapter
of this manual for additional information on adding files to your system.
Disabling
The easiest way to disable your file directories (leaving only your upload
directories working) is to blank out your DIR and DIR.LST fields. For
example, if your fields in the conference configuration screen look like the
following:
Directories : C:\PCB\GEN\DIR : C:\PCB\GEN\DIR.LST
Modify them to look like this to disable your file directories:
Directories : :
When your file directories are disabled, your users will receive a message
stating that there are no directories whenever they try to access your file
areas.
Creating Menu
In order for your users to know what file directories are available on your
system (if any), you need to edit the Directory Menu Listing file. This file
is commonly referred to as DIR.
This is the file that is displayed to the user when they execute the F user
command. This file is nothing more than a text file. Because it is a text
file, you can design it to look or display anything you want. As a general
rule it should contain each directory number and should also list a
description of the contents of each file directory. The following is a
sample menu text file.
Doors
When you add a door to your bulletin board system you add functionality to
your system. A door application can enable your users to play on-line games,
access databases, and just about anything else you can imagine.
When a user opens a door they temporarily exit PCBoard and run a batch file
called the door batch file. This batch file will then execute some other
application -- be it a game, utility or other program.
Usually the program that is being run is designed to be a door application,
or is designed to accept input and output via the serial port so that the
remote user can control the operation of the program. Programs that do not
provide input and output through the serial port may not be able to run as a
door unless you use a program like DOORWAY which redirects both text screen
and keyboard i/o to the remote caller.
Probably the most popular type of door programs are games. However, there are
utility type doors as well that may allow users to store additional time on
the system, read off-line mail, etc. Virtually anything that communicates
via a serial port can be considered a door application.
What Is A Door?
A door is nothing more than a program which is designed to
communicate through the serial port rather than through normal
means (i.e., the keyboard).
You may be asking yourself if there is anyway to run a non-door application
as a door. You can but it means that you will have to have some sort of
software that will monitor what is on the screen and output it to the remote
users screen. DOORWAY by TriMark Engineering does exactly this. It will
monitor any 80x25 text mode application and draw it on the remote users
screen using ANSI codes. Using this program you could run virtually any text
mode DOS application as a door.
For the most part most door applications are all character-mode based. That
means that you cannot run Windows application or other graphical applications
as a door. The primary reason you cannot run graphical applications as doors
is because there is no standard way to send graphical data over the modem and
have the majority of modem users be able to view that information.
Adding A Door
If you load PCBSetup, and select a conference to edit you will
see the following fields at the bottom of your display:
Menu Listing Path/Name List File
Doors : C:\PCB\GEN\DOORS : C:\PCB\GEN\DOORS.LST
Bulletins : C:\PCB\GEN\BLT : C:\PCB\GEN\BLT.LST
Scripts : C:\PCB\GEN\SCRIPT : C:\PCB\GEN\SCRIPT.LST
Directories : C:\PCB\GEN\DIR : C:\PCB\GEN\DIR.LST
Download Paths (listing only) : C:\PCB\GEN\DLPATH.LST
The two fields that relate to door operation are the following:
Menu Listing Path/Name List File
Doors : C:\PCB\GEN\DOORS : C:\PCB\GEN\DOORS.LST
The following is a brief description of each of the files:
DOORS - This is the menu file that is displayed to the user when they type
either OPEN or DOOR. This file is a normal PCBoard display file. It should
list all of the doors that are available on your system and their
corresponding numbers or names. Creating the door menu is discussed later in
this section.
DOORS.LST - This file stores all of the setup information about the doors you
have defined in this particular conference. PCBoard will read this file to
determine what batch file to use to execute the door, where the batch file is
found, and other options controlling access to the door. To edit this file,
press F2 and you will see the following screen:
The number at the very left of each line is the door number. The rest of the
fields are not always so intuitive. The following briefly describes each
field in the DOORS.LST file:
Filename This is the exact batch filename that PCBoard will look to
execute. You are given up to 8 characters for a door name
and you should not put a .BAT extension in the filename
field.
NOTE: Make sure that you do not enter a filename which is
the equivalent of any internal PCBoard command. For example,
if you were to enter TEST as a filename your door batch file
will never run because PCBoard has an internal command with
the same name.
Password If you want users to enter a password in order to access a
particular door, enter up to 12 characters in this field. If
you do not desire a password to be asked, make sure this
field is blank.
Sec Enter the security level required in order to be able to open
a particular door. A user may open the door if their
security level is equal to or greater than the security level
in this field. Of course, if the security level entered in
this field is 0, everyone will have sufficient security to
open the door.
Login This field may contain either a Y or an N. If you enter a Y
in this field, when the user logs into the system this door
will be loaded. Note that the security level field behaves a
little different when you are dealing with an auto-login
door.
With an auto-login door it will only open for the security level that is
listed in the SEC field. If you want the door to open every time any user
logs in, enter a security level of 0 in the sec field.
NOTE: If you have any conferences that are defined as auto-rejoin, be aware
that if a user logged off of the BBS in one of these conferences, they will
rejoin that conference on their next login. Consequently, you must make sure
that the proper doors are defined in this conference because this is the
conference that PCBoard will read the DOORS.LST from.
USER SYS In this field you may enter a Y, N, or O. The letter that
you enter in this field will determine if a USERS.SYS is
created and if so, what type. If you enter a Y, PCBoard will
create a USERS.SYS in the same directory that you loaded
PCBoard from. If you enter O, a USERS.SYS will also be
created but it will be output so it is compatible with v14.5.
Check the documentation for the door you are about to add to
see if it requires a USERS.SYS file and if so, what type. If
the door does not need a USERS.SYS file, you should enter N
in this field.
DOOR SYS Like the USER SYS field, this field will determine if PCBoard
should create a DOOR.SYS file for the door. Again, you should
check the door documentation to see if a DOOR.SYS file is
required for door operation. If not, leave this field set to
N.
SHELL This field has three possible options (Y, N, and S).
N - Do not shell to DOS to execute the door. This means that
PCBoard will unload completely and then load the door. If you
use this method then you will have the same amount of memory
for the door to execute as you had just before you first
loaded PCBoard.
S - If you use this option, PCBoard will shell to DOS,
swapping itself to XMS, EMS, or to Disk (whichever is
available) and will then execute the door batch file. Using
this method means that will get about 25k of memory less than
if you had used N.
Y - Shell to DOS and then execute the door rather than
exiting PCBoard completely to load the door. This means that
you will have less memory available to run the door but it
also means that it will be quicker loading and returning from
the door. Typically you may have only 100-200k of memory
available to the door if you shell to it.
Path to.. In this field, enter the path where your door batch file can
be found. For example if the batch file for this door is
stored in C:\PCB\, enter C:\PCB\ in this field.
Editing/Creating Your Door Batch File
By far the easiest method to create or edit your DOOR batch files is while
you are editing DOORS.LST. First of all you need to make sure that you have
defined a text editor in System Manager. If you have, highlight the filename
field in DOORS.LST and press 2. This will allow you to create or edit the
batch file. If you want to edit the file manually, you will need to look at
your entry in DOORS.LST to determine the name and location of the batch file.
The following is sample entry in DOORS.LST
USER DOOR
Filename Password Sec Login SYS SYS Shell Path to DOOR Files
---------- ------------ --- ----- ---- ---- ----- ---------------------
1) TESTDOOR 0 N N N N C:\PCB\DOORS\
│ │
└─────────────────────────┐ │
│
C:\PCB\DOORS\TESTDOOR │
│ │
└─────────────────────────────────┘
You can see that PCBoard thinks that the DOOR batch file is
C:\PCB\DOORS\TESTDOOR. Notice that there is no .BAT extension. Even though
it sounds strange it will still execute properly.
Returning Back To PCBoard From A Door
If the door you are creating the batch file for has either an S or a Y in the
Shell column, you do not need to add any lines to the batch file in order to
return to PCBoard. Once the door batch file has completed, PCBoard will
automatically reload.
If you answered N to the Shell column, you need to reload BOARD.BAT. The
easiest way to do this is to add the following three lines to the end of your
door batch file:
%PCBDRIVE%
CD %PCBDIR%
BOARD
These lines will first make sure that your system returns to the proper
drive, then change to the proper directory to reload, and finally reload
PCBoard using BOARD.BAT.
Debugging
Debugging a door is an easy process. There are two commands designed for
batch files that you may want to keep in mind -- PAUSE, and ECHO ON. The
PAUSE command can be used to delay further execution of the batch file. This
is useful when trying to catch errors that might be displayed as your batch
file is running. The pause command will ask you to strike a key when it runs.
Therefore you could put a PAUSE command after every command until you find
the offending line in the batch file.
In conjunction with the PAUSE command you can put a line that says ECHO ON at
the beginning of the batch file. This will let you see each command of the
batch file as it runs. This method is useful for checking to see if your
environment variables are being correctly substituted, changing to the wrong
directory, and for tracking other obvious errors.
Using these two commands together can really help you track down some of the
problems you will incur as you are creating your door batch files. If you
have used these techniques and you still are unable to track down the problem
perhaps you should consider contacting the author of the door for further
help.
Multiple Nodes
This section discusses various techniques for installing door programs on a
multi-node setup. All of the techniques in this section are designed to help
save you time both in the present setup and in the future when you add more
nodes. You may use these instructions for setting up door programs in a
multitasking or network environment.
It is assumed that you already know how to setup a door under PCBoard. If
you do not yet know how to setup a door please refer to the Creating a Door
section. It is also assumed that you have a good grasp on how to create
batch files and pass parameters inside of batch files.
You do not have to be a batch file wizard but you should be familiar with the
following topics:
* What a batch file is
* How to create and edit a batch file
* Batch file commands (IF, GOTO, etc.)
* Using replaceable parameters in batch files (environment
variables in particular)
If you are not familiar with batch files or any of the above topics, please
consult your DOS manual's batch file section for more information.
Because door programs are written by different authors and the fact that
there are so many door programs available, you will find that the methods
required to setup a particular door program differ greatly. Some door
authors may require you to pass specific information on the command line of
the executable file while other door authors may store the information in a
configuration file. Other door programs may use a combination of
configuration files and command line parameters.
Because setting up door programs requires a comprehensive knowledge of
creating batch files, setting up door programs in a multinode environment may
prove tricky at first. However, your efforts will pay off in the long run
especially if you plan on adding more nodes in the future. By using the
methods discussed in this section you will learn how you will be able to use
one batch file for each door on all of your nodes.
You can set up your system so that each node has a different DOORS.LST.
However, this would mean that you would have to add your door configuration
to each node rather than making the change on one node and spreading the
change automatically through the entire system. It is strongly recommended
that you stay with one single DOORS.LST for your entire system. See Using A
Different DOORS.LST For Each Node for additional information.
Using One Batch File For All Nodes
The first step in setting up a door is to browse the documentation included
with the door package. Look to see if the door requires any special hardware
or software. If you are using a COM port other than COM1 or COM2, you should
also check to see if the door will support non-standard COM port definitions.
Likewise, if you are using the /M version of PCBoard, check and see if the
program supports the FOSSIL interface. If the door program does not support
your hardware configuration, you will not be able to run the door.
The next step is to install the door on your system as per the instructions
provided by the author. If you have questions on the installation of the
door, contact the author for further assistance.
Test the door program and make sure that it works on at least one node. Do
not proceed until you have confirmed that the door operates properly.
If the door does not work correctly your best chance of getting the door
program to operate correctly is to contact the author of the program directly
since they know how their program functions. If the author of the program is
no longer available, try contacting other SysOps to see if they might already
have it up and running. The PCBoard technical support staff is very familiar
with the PCBoard program but are not very familiar with the thousands of
third party programs that are available for PCBoard.
Now that you know that the door works you should examine the batch file you
use to run the door. When looking at this batch file you should search for
anything that is specific to a particular node. Look at the following
example:
C:
CD\DOORS\ABCGAME
ABCGAME C:\PCB\NODE2\
C:
CD\PCB
BOARD
Notice how this batch file explicitly uses C:\PCB\NODE2\. This means that if
you ran this door batch file on node 3, it would not work because the
C:\PCB\NODE2\ is hard-coded into the batch file.
Not all of the node specific information is so easy to spot. Let's take a
look at another example:
C:
CD\DOORS\NEATDOOR
NEATDOOR ND.CFG
C:
CD\PCB
BOARD
On the outside it appears this door does not reference any node-specific
information. However, if you look in the configuration file for this door
(ND.CFG) you will most likely find that it contains some node specific
information. This node specific information might be where to find
PCBOARD.SYS, DOOR.SYS, or even what serial port to use.
Once you have determined where the node specific information is, you will
need to find a way around this problem so you can still use one batch file
for all of your nodes. To help you with your door configuration, PCBoard
will create four environment variables. They are as follows:
PCBNODE Contains the number of the node that is executing the door (e.g., 3)
PCBDRIVE Contains the drive letter that PCBOARD.EXE was run from.
This is sometimes referred to the home drive for the node
(e.g., D:)
PCBDIR This variable will contain only the directory that
PCBOARD.EXE was run from. This is sometimes referred to as
the home directory for the node and is also the location
where, PCBOARD.SYS, USERS.SYS, and DOOR.SYS will be created
(e.g., \PCB\NODE3)
PCBDAT Contains the full drive, path and filename of the PCBOARD.DAT
that is being loaded for this node.
If you did not heed the previous warning regarding environment variables and
how to use them in batch files, consult your DOS manual for that information
at this time.
A batch file that does not use the environment variables PCBoard provides
might look like the following:
C:
CD\DOORS\ABCGAME
ABCGAME C:\PCB\NODE2\
C:
CD\PCB
BOARD
The same batch file using the environment variables that PCBoard provides,
would look like the following:
C:
CD\DOORS\ABCGAME
ABCGAME %PCBDRIVE%%PCBDIR%\
%PCBDRIVE%
CD %PCBDIR%
BOARD
The following describes each line in the above example. It will help you
understand how and why the environment variable were used:
C: Change to the C: drive because that is where the door is
installed
CD\DOORS... Change to the \DOORS\ABCGAME subdirectory (where the door is
installed)
ABCGAME... Execute the door program. Uses the PCBDRIVE and PCBDIR
environment variables to tell the door where it can find
specific files (e.g., PCBOARD.SYS) for the node running the
program.
%PCBDRIVE% Change to the PCBoard drive (where the node subdirectory
is located)
CD %PCBDIR% Change to the PCBoard directory (the node subdirectory)
BOARD Reloads your BBS batch file
The variables (surrounded by % signs) will be replaced by the appropriate
values as they are set for each node. At this point you may be asking
yourself, if this makes my node configuration easier, why are the batch files
larger? What you may not be aware of is that you can use this batch file for
EVERY node in your system. This makes both your maintenance and system
configuration less complex. A tradeoff that is well worth the results.
Consider the following two examples to really appreciate how using
environment variables in your DOOR batch files can help you out:
You add more nodes to your system.
You change the location or delete the door from your system.
In the first example you do not really have to do anything to activate your
new nodes on the system. In the second example, if you move the location of
the door you only need to change the one batch file to reflect the new
location (The first CD command in the batch file). Can you imagine running
19 nodes and having to change 19 different batch files? Having numerous
batch files for one door also increases your chance of making a configuration
mistake.
Some door programs use a configuration (config) file for normal operation.
Some of these programs store node-specific information in these files.
Remember, environment variables can only be used in the batch files
themselves (i.e., not in config files). This may lead you to wonder how you
can still use environment variables and create one batch file for all of your
nodes. The answer is quite simple. Create multiple config files and then use
the PCBNODE environment variable to load the proper one.
As an example lets say you have the following batch file:
C:
CD\DOORS\NEATDOOR
NEATDOOR ND.CFG
C:
CD\PCB
BOARD
Now, lets say in the ND.CFG file is the following:
C:\PCB\NODE3\PCBOARD.SYS ;location of PCBOARD.SYS
5 ;number of times game can be played per
day
400 ;points per win
If you could use environment variables in other files, the solution would be
easy enough, you would replace the C:\PCB\NODE3\PCBOARD.SYS in the ND.CFG
file to say %PCBDRIVE%%PCBDIR%\PCBOARD.SYS. However, you cannot do that
because environment variables cannot be read in from configuration
files. Therefore, you need another alternative.
At this point you need to create a configuration file for each node. You
will want to come up with some sort of naming convention. Since the original
config file was called ND.CFG you may want to simply tack on the node number
to each config file (e.g. ND1.CFG, ND2.CFG, ND3.CFG). By naming them with
the node numbers in the filename we will be able to use the PCBNODE
environment variable. The most important thing to remember is that you should
remain consistent in your naming conventions. If you do not, you will not be
able to use environment variables.
Once you have created (or copied) a config file for each node you need to
change the first line to reflect the location of the PCBOARD.SYS for each
node. Next, you need to make the modification to the batch file. After you
have added the environment variables, your batch file would look like this:
C:
CD\DOORS\NEATDOOR
NEATDOOR ND%PCBNODE%.CFG
%PCBDRIVE%
CD %PCBDIR%
BOARD
The following describes each line in the previous example:
C: Change to the C: drive (where the DOOR is installed)
CD\DOORS... Change to the \DOORS\NEATDOOR subdirectory (where the DOOR is
installed)
NEATDOOR... Execute the DOOR program using a config file. Because of the
PCBNODE environment variable a different file will be loaded
for each node.
%PCBDRIVE% Change to the PCBoard drive (where the node subdirectory is
located)
CD %PCBDIR% Change to the PCBoard directory (the node subdirectory)
And finally, a more complex batch file might look something like
the following:
C:
CD\DOORS\PCBMAIL
PCBMAIL PCBM.CFG C:\PCB\NODE3\ /PORT:3E8:5
C:
CD \PCB\NODE2
BOARD
This batch file represents a door which points to a single config file which
does not contain information specific to any node (maximum plays per day,
points rewarded, etc.). Also passed on the command line is the location of
this node and the final parameter passed on the command line is the base
address and IRQ for the COM port (/PORT parameter).
Do not let the additional parameters worry you. Your goal should still be the
same. Replace the node specific information with environment variables. What
makes this problem just a little different is that PCBoard does not create
environment variables for the base address and IRQ for COM port. However,
you could easily enough create some environment variables in your BOARD.BAT
file which would represent your base address and IRQ for each of your COM
ports. If you wish to do this, add the following lines to your BOARD.BAT:
SET COMBASE=2f8
SET COMIRQ=5
Of course, your system may not use 2f8, with an IRQ of 5 so you should change
that information to reflect your system configuration.
We have now assured ourselves that we have environment variables that we can
use to replace all of the node specific information in the previous batch
file we are ready to change the batch file. Your final batch file should
resemble the following:
C:
CD\DOORS\PCBMAIL
PCBMAIL PCBM.CFG %PCBDRIVE%%PCBDIR%\ /PORT:%COMBASE%:%COMIRQ%
%PCBDRIVE%
CD %PCBDIR%
BOARD
One thing that you should note about the above batch file is that the door
that was used for this example does use a configuration file called PCBM.CFG.
However, this configuration file does not contain any node specific
information and that is why we did not have to make any changes. All of the
node specific information was passed on the command line therefore it would
be pointless to create multiple configuration files. This batch is a little
more difficult because it contains more node specific information on the
command line. In reality however, the technique is the same as in the
previous examples.
By now you should have noticed that for all intents and purposes most of the
batch file looks the same, the only line that has changed is the line that
calls the program. For the most part this is the way most of your door batch
files will look. You will change to the directory where the door is located,
run the program, change back to the PCBoard drive and directory, and finally
reload the BBS.
Once you have replaced the node specific information with environment
variables, you are now ready to test the door to make sure that, with the
changes you have made, the door still works. If it works on one node, try it
on another node and make sure everything still works correctly. As an extra
precaution you should try it out on every node (especially when a door uses
config files) to make sure that all nodes work correctly. If the door works
correctly on all nodes, you have properly setup your door for use in a
multi-node environment. If you have problems with any nodes, use the
debugging information described previously to help locate the problem.
There are about as many ways to configure a door as there are door programs
out there. The previous examples should be used to aid you in several of the
more popular types of door configurations. Not all of the configurations
could be covered in this section so remember that you may run into
configurations that you may not recognize. If you do run into such a
configuration identify the node specific information and use environment
variables to create one batch file for all of your nodes
Using A Different DOORS.LST For Each Node
If you decided you do not want to go to the trouble of using environment
variables in your door batch files, you can have each node use a different
DOORS.LST file. By doing that, you can specify a different location for the
door batch file. For example, instead of storing the batch file in
C:\PCB\DOOR\, you may instead choose to locate the batch file in
C:\PCB\DOOR\N1\ for node 1, and C:\PCB\DOOR\N2\ for node 2.
The problem with this type of setup though is that as the number of nodes on
your system increases, the time it takes to change the batch files also
increase. If you have two nodes you may only have to edit two batch files.
However, if you have 20 nodes online then that means 20 files to edit and
consequently more lost time.
If you decide that separate DOORS.LST files are the way for you, the setup
can be accomplished very easily. Since all of your nodes likely share the
same CNAMES file you can change the location of DOORS.LST to look like the
following:
Menu Listing Path/Name List File
Doors : C:\PCB\GEN\DOORS : DOORS.LST
Notice that only the filename DOORS.LST is in this field. That means that
PCBoard will search the current directory to find the file instead of an
absolute location like C:\PCB\GEN\DOORS.LST. Since you are in different
directories on every node this means each node will have a DOORS.LST file in
their default directory.
Where to find DOOR.SYS, or USERS.SYS
Because PCBoard creates DOOR.SYS and USERS.SYS before the door is run and
deletes them when returning there may be some confusion as to where these
files are created. These files will be located in the same location as
PCBOARD.SYS for the nodes. The best way to determine the subdirectory is to
log into that node locally and then press 5. The subdirectory you are in is
the subdirectory where the files will be stored.
NOTE: This subdirectory is also the subdirectory that you were in when you
loaded PCBOARD.EXE from. In addition, it is also the subdirectory that is
specified by the PCBDRIVE and PCBDIR environment variables.
Opening A DOOR
There are four methods with which a door may be opened via PCBoard:
* Using the OPEN command from the conference command prompt.
* Using the DOOR command from the conference command prompt.
* Typing the name of the door at the conference command prompt.
* If you are using an MNU file, one of your options in the MNU
file can execute a door.
The third and forth methods provide the most interesting possibilities
because you can make the door appear to be a more integrated function of your
bulletin board system.
Accessing Parameters Passed To A Door
Any text that is entered after the door name or number will be passed as
command line parameters. These command line parameters are available to the
door application if they will read the PCBDOOR environment variable. If you
open a door called MAIL by typing the following,
MAIL D;Y;G
PCBoard will store D;Y;G in the PCBDOOR environment variable. In order for
the door to see these parameters, you will most likely have to modify the
door batch file. For the MAIL door mentioned previously, the batch file may
resemble the following:
@ECHO OFF
CD\DOORS\MAIL
MAIL
%PCBDRIVE%
CD %PCBDIR%
BOARD
You must only make one change to this batch file in order to pass the command
line parameters to the door. The change you must make is the line that
executes MAIL. This line would change to read:
MAIL %PCBDOOR%
NOTE: For more information on accessing environment variables in batch
files, please refer to your DOS manual.
Stuffing The Keyboard Upon Return
When PCBoard returns from running a door, it will check to see if a file
named PCBSTUFF.KBD exits in the current directory. If it does, the contents
of this file will be stuffed into PCBoard's keyboard buffer.
Example
If you have a door which creates a file that you want to the user to
download, you would want PCBoard to automatically download a specific
filename. The first thing that you would need to do is to create a file that
you want to stuff into the keyboard. For this example, the filename created
by the door will be called DATA.ZIP.
In your PCBoard directory create a file named. DATA.STF. The contents of
this file should be the following:
D;DATA.ZIP
The only change you will have to make to the door batch file is to add a line
that will copy your DATA.STF file to the PCBSTUFF.KBD file. In your batch
file, this line may appear as:
COPY C:\PCB\DATA.STF %PCBDRIVE%%PCBDIR%\PCBSTUFF.KBD
The %PCBDRIVE% and %PCBDIR% environment variables are used to insure the
PCBSTUFF.KBD file is created in the proper directory. If it is not, PCBoard
will not find it and nothing will be stuffed into the keyboard.
NOTE: Once the file has been read by PCBoard, it will be deleted.
Displaying A File Upon Return
When PCBoard returns from running a door, it will check to see if a file
named PCBDOOR.TXT exists in the current directory. If it does, the contents
of this file will be displayed on the local and remote screens.
Example
After you have installed a door, you may find it has a problem which will
force you to take it temporarily off line. You could delete the definition
of the door from the DOORS.LST file, but that will be more trouble than it is
worth if you are taking it off-line temporarily.
Instead, try inserting a REM before each line in your door batch file except
BOARD (if that line is in your door batch file). When you have done this,
create a text file that you want to display to your callers. The next step
is for you to add the following line to your door batch file (before BOARD
(if that line exists in your batch file):
COPY C:\PCB\CLOSED.TXT %PCBDRIVE%%PCBDIR%\PCBDOOR.TXT
Assuming that you name you display file CLOSED.TXT and store it in C:\PCB,
that file will be displayed to anyone who runs the door. What will happen is
that DOS will skip all of the lines that begin with REM and then execute the
line that you added to your batch file. Finally it will return to PCBoard
which will find the PCBDOOR.TXT and display it on the screen.
NOTE: Once the file has been read by PCBoard, it will be deleted.
Disabling
To disable doors in a particular conference, simply clear out the fields
related to door configuration as shown in the following example:
Menu Listing Path/Name List
File
Doors : :
If you do this, when a user attempts to open a door they will be informed
that no doors are presently available.
NOTE: Doors are always disabled for users who do not have established
accounts on the system. The following lists the two possibilities for a user
to not establish an account on your system:
The caller logged in as a new user on a node defined as a closed board and
you have a NEWASK questionnaire defined.
A user calls for the first time. When asked if they want to register, they
choose not to. In order for the user to remain online, you must give those
that refuse to register a security level other than 0.
Creating Menu
If doors are available in a conference, when a user types OPEN or DOOR from
the conference command prompt they will be shown a file which lists all of
the doors that are available on the system. This file is specified by the
following field in the conference configuration:
Menu Listing
Doors : C:\PCB\GEN\DOORS
This file is commonly referred to as the DOORS file. You can edit this text
file by pressing F2 or F3 as listed on the bottom of the screen. When you
are creating this file, you should list either the door number or door name
(filename in DOORS.LST) and a description of the door for your users. The
user can open the door by typing the door name or door number.
Script Questionnaires
Script questionnaires provide a method which you can ask the user questions
and record their responses to a text file.
Creating
There are two types of script questionnaires you can create. You can use the
regular questionnaire type which is a text file with a question on each line.
The second type you can create is a PPE file. To create a PPE file, you need
to have purchased the optional PPL (PCBoard Programming Language) Compliler.
Any PCBoard v15.0 system can run a PPE file even if the owner of the system
did not buy the compiler. To create the PPE files though, you will need the
compiler.
Scripts are defined for the conference in the SCRIPT.LST file. This file
contains the location of the script file and where the answers for the script
will be stored. When you edit the SCRIPT.LST by pressing 2, you should see a
screen which resembles the following:
Conference Name (#0) : Main Board
SCRIPT Questionnaire Files SCRIPT Answer Files
-------------------------- -------------------
1)
The first field specifies the location of the script questionnaire. The
second field specifies the location where the response file will be stored.
PCBoard determines if the file is a standard questionnaire or a PPE file
based on the filename extension you specify. If the filename of the
questionnaire ends with PPE, the questionnaire will be treated as a PPE.
Otherwise, the file will be treated as a standard questionnaire.
Standard Questionnaires
Standard questionnaires are very easy to setup because the questionnaire
itself is a text file. Questions are asked one line at a time and the user
is given the ability to respond to each question with a 60 character
response. There is no method provided to check the response of the user.
The question itself may be up to 79 characters in length.
The easiest way to load the script questionnaire file is to press F2 when you
are highlighting the script to edit while in the SCRIPT.LST editor. PCBSetup
will use your text editor to load the script questionnaire.
The first five lines of your questionnaire file is called the script header.
You can use these five lines to give your users a brief overview of the
questionnaire. After PCBoard displays the header to the user, they are asked
if they wish to continue to answer the script. If they choose not to respond
to your questionnaire, they will be returned back to the system. If they
choose to respond, PCBoard will continue.
Anything after line five in your questionnaire file is considered a question.
Each line is a question. The following is a simple example of a
questionnaire:
-----------------------------------------------------
This questionnaire will ask for your name
-----------------------------------------------------
Enter your first name?
Enter your last name?
If a user will executes this script then they will see the following:
-----------------------------------------------------
This questionnaire will ask for your name
-----------------------------------------------------
Complete the Questionnaire (Enter)=no? (y)
Enter your first name?
? (Jim )
Enter your last name?
? (Smith )
As you can see, every line after the fifth line is considered as
a question. If you want to only display text and not ask a
question, you would begin the line to display with a semi-colon.
This is referred to as a comment line.
If you wish, you can use comment lines to ask questions which
use more than one line. Look at the following questionnaire
file:
-----------------------------------------------------
We have several items available for sale. From
hardware to software, we have products that fit your
needs and wants. If we don't have it, just ask!
-----------------------------------------------------
;We have the following products available for sale:
;
; 1. Complete 80486 system with SVGA video system
; 2. Whiz-bang hard-drive
; 3. Plain paper bag software
Which item would you like to order?
When the user executes this script, they will see the following
display:
-----------------------------------------------------
We have several items available for sale. From
hardware to software, we have products that fit your
needs and wants. If we don't have it, just ask!
-----------------------------------------------------
Complete the Questionnaire (Enter)=no? (y)
We have the following products available for sale:
1. Complete 80486 system with SVGA video system
2. Whiz-bang hard-drive
3. Plain paper bag software
Which item would you like to order?
? (3 )
Notice how those lines that were prefixed with a semicolon were only
displayed on the screen. Only after the items for sale were listed was the
user prompted for input by the line in the questionnaire that did not have a
semicolon in front of the line.
PPE Files
Because PPE files are made from the PCBoard Programming Language the actual
creation of these files are too complex to cover in this section. Instead,
you should refer to the documentation that was included with the optional PPL
Compiler package for further instructions.
If you are given a PPE file and need to install it on your system, simply
enter the PPE filename in the Script Questionnaire Files field including the
.PPE extension. PCBoard will know that it is a PPE file and execute it
properly.
Reading Responses
The entire purpose behind questionnaires is to get responses from the users
who fill them out. The responses to your questionnaire will be stored in the
filename you specified in SCRIPT.LST as the answer file. The following is a
sample entry in SCRIPT.LST:
SCRIPT Questionnaire Files SCRIPT Answer Files
-------------------------- -------------------
1) C:\PCB\MAIN\SCRIPT1 C:\PCB\MAIN\ANSWER1
In this example, all answers will be written to a file called ANSWER1 located
in the C:\PCB\MAIN\ subdirectory.
Standard Questionnaires
The response or answer file for a standard questionnaire follows a very rigid
format. PCBoard will begin the response with a row of asterisks (*) to help
separate this response from any previous responses.
The next line contains the name of the user that filled out the
questionnaire, the date and time the questionnaire was filled out, the node
number the user was on, the security level of the user, and finally the
expiration date of the user.
The rest of the lines in the response file show the question, and the
response of the user. Only the question line is recorded. If you use
comment lines in your script questionnaire they will not be recorded.
PCBoard will continue to append responses to the file so you may want to
periodically delete the response file after you have reviewed the answers.
PPE Files
Because PPE files are created using PPL (PCBoard's Programming Language) the
way the responses are stored is the responsibility of the PPE author.
Therefore, if you do not understand the response format, contact the author
of the PPE file.
Disabling Scripts
You can disable script questionnaires simply by blanking the SCRIPT and
SCRIPT.LST fields in the conference configuration of PCBSetup. If it used to
look like
Scripts : C:\PCB\GEN\SCRIPT :
C:\PCB\LST\SCRIPT.LST
change it to read
Scripts : :
By doing this, your users will be notified that no scripts currently exists
when they try to fill out a script questionnaire.
Creating The Menu
In order for your users to know what scripts are available on your system (if
any), you need to edit the Script Menu Listing file. This file is commonly
referred to as SCRIPT.
This is the file that is displayed to the user when they execute the S user
command. This file is nothing more than a text file. Because it is a text
file, you can design it to look or display anything you want. As a general
rule it should contain the script number and a description of each script
questionnaire. The following is a sample script questionnaire menu file:
Scripts Available On This System
------------------------------------------
[1] Order a subscription to this system
[2] Order a product we sell
You can create this text file using just about any text editor.
Better yet, if you have defined your text editor or graphics editor in PCBSM,
you can simply press F2 or F3 (depending on which file you want to edit).
Otherwise you will have to manually edit the files while at the DOS prompt.
Bulletins
Bulletins provide a method with which you can display text files to callers.
Text files can be created with text editors or even with word processors that
allow you to export to ASCII format. You can use bulletins to list current
events, rules of your system, legal information in regards to communications
services, etc.
Creating
Bulletins are very easy to setup. To configure the bulletins that are
available in a particular conference, you need to highlight the following
field in the conference configuration screen:
Path/Name List File
Bulletins :C:\PCB\LST\BLT.LST
Now press F2 to edit the BLT.LST file. You should see a screen which
resembles the following:
Conference Name (#0) : Main Board
Enter a list of BLT Paths & Names
------------------------------------
1)
The number on the left hand side of the screen represents the bulletin
number. In the edit field you can specify any filename you wish to display
when a user chooses the bulletin number that is listed to the left. As an
example, you may want to have the users view C:\PCB\GEN\ORDER when they view
bulletin 1. If you do, make the following entry in your BLT.LST file:
Enter a list of BLT Paths & Names
------------------------------------
1) C:\PCB\GEN\ORDER
Adding another bulletin can be dine simply by pressing ALT-I. You will now
see that there is an entry for bulletin F2 that you may fill in with the
filename you wish to display.
Making Bulletins Available For Download
Any bulletin(s) can be download as long as the location of the bulletin file
is included in the DLPATH.LST for the conference. The B user command provides
subcommands and explanations for downloading any bulletin number.
If you want, you may provide compressed versions of the bulletins on your
system. PCBoard will look at the Filename EXTENSION for compressed files in
PCBSetup | File Locations | Configuration to find the extension for
compressed files on your system.
NOTE: If PCBoard can find a file with the same name as the bulletin and with
your compression extension, it will pick that file for download instead of
the uncompressed version.
Disabling
To disable bulletins in a conference, you simply clear out the fields that
relate to bulletins in a conference configuration screen. For example, if
your bulletin fields contain the following information:
Menu Listing Path/Name List
File
Bulletins : C:\PCB\GEN\BLT : C:\PCB\GEN\BLT.LST
then you would blank them out making them look like the
following:
Menu Listing Path/Name List
File
Bulletins : :
Your bulletins would then be disabled and your users would be warned that no
bulletins currently are available on the system if they tried to view any of
the bulletins.
Creating Menu
Whenever a user presses B and RETURN, a list of bulletins that exist on the
system will be displayed. The file that is displayed to your callers is the
bulletin menu listing. The filename for this menu or the actual menu itself
may be changed by editing the following field in the conference configuration
screen:
Menu Listing
Bulletins : C:\BLT\BLTMENU