PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Written by David W. Terry
Copyright (C) 1987 Clark Development Company


Table of Contents

What PCBoard System Manager Is . . . . . . . . . . . . . 2

Things You Should Know Before Beginning . . . . . . . . . 3
Limitations . . . . . . . . . . . . . . . . . . . . . . . 3
Installation and Set Up . . . . . . . . . . . . . . . . . 3
Changing the Colors used by PCBSM . . . . . . . . . . . . 3

How to Use PCBoard System Manager . . . . . . . . . . . . 4

Users File Maintenance . . . . . . . . . . . . . . . . . 4
Editing the Users File . . . . . . . . . . . . . . . . . 4
Sorting the Users File . . . . . . . . . . . . . . . . . 6
Packing the Users File . . . . . . . . . . . . . . . . . 7
Printing the Users File . . . . . . . . . . . . . . . . . 8
Make Users File Indexes . . . . . . . . . . . . . . . . . 10
Adjusting Security Levels . . . . . . . . . . . . . . . . 11
Group Conferences . . . . . . . . . . . . . . . . . . . . 13
Standardize Phone Formats . . . . . . . . . . . . . . . . 14
Undo (restore backup) . . . . . . . . . . . . . . . . . . 15

Directory Maintenance . . . . . . . . . . . . . . . . . . 16
PCBFiler program . . . . . . . . . . . . . . . . . . . . 16

Edit Passwords File . . . . . . . . . . . . . . . . . . . 17

Edit Download Security File . . . . . . . . . . . . . . . 18

Edit Trash Can File . . . . . . . . . . . . . . . . . . . 20

Edit Doors Listing . . . . . . . . . . . . . . . . . . . 21

Edit Protocol Listing . . . . . . . . . . . . . . . . . . 22

Command Line Parameters . . . . . . . . . . . . . . . . . 23

Appendix A . . . . . . . . . . . . . . . . . . . . . . . 24
Special Editing Keys . . . . . . . . . . . . . . . . . . 24

Appendix B . . . . . . . . . . . . . . . . . . . . . . . 26
What to do if you are having problems . . . . . . . . . . 26

Appendix C . . . . . . . . . . . . . . . . . . . . . . . 28
Differences in PCBSM v1.0 Tables . . . . . . . . . . . . 28




1


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager



What PCBoard System Manager Is

PCBSM is a program meant to aid the sysop in working with the
resources of PCBoard. These being, the users file, the indexes for
the users file and all of the text configuration files such as the
PWRD, FSEC and TCAN files.

In its current state PCBSM does not yet handle DIR files and leaves
that up to a second program called PCBFiler. However, you will see a
selection on the main menu call "Directory Maintenance". For this
release of PCBSM this selection simple chains to PCBFiler but
hopefully, subsequent version will allow PCBSM to do the work itself.

Proper formatting of the text configuration files, such as the PWRD
file, is essential to the correct operation of PCBoard. There have
been many sysops who have not understood our documentation (how can
that be??) or have made typing errors when creating these files
hitting periods instead of commas and so on. PCBSM will take care of
the dirty work for you and make sure that the files are correctly
formatted at the same time relieving you of the need to use an
external text editor to accomplish the same thing.

The Users File Maintenance section of the program was designed from
the outset for speed and use-ability. PCBSM is meant to be able to
run while your network is still up. Of course, sections where global
changes are made, such as sorting the users file, require that all
nodes be brought down before proceeding. NOT TO WORRY... it can
automatically sense when you have not brought the nodes down AND if
you are in the process of sorting the users file PCBSM won't let the
nodes come back up until you finish (even if you forget to wait).

As I mentioned, one of the design goals is for speed. Part of this
speed is accomplished by monitoring the changes that take place in
the users file. For example, if during an editing session you change
John Doe's name to Jane Doe and Sam Smith to Dean Smith the program
would automatically know that it needs to regenerate ONLY the J, S
and D indexes (note that PCBoard indexes on the first name).

While performing any global change (sorting, adjusting securities,
changing conference registrations, etc) if you decide to abort the
operation you can press the ESC key and the operation will be aborted
immediately leaving your users file THE WAY IT WAS without having to
worry about renaming backup files. If you happen to let the
procedure finish and find that you need to go back to the original
users file there is an UNDO option right on the menu!

Enough talk... let's get on with the actual program...







2


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Things You Should Know Before Beginning


Limitations

PCBSM currently is limited to a maximum of 1500 lines in the Trash
Can (TCAN) editor. The other editors are limited to a maximum of
about 120 lines except where it would be obvious that 120 are not
needed.


PCBSM should handle users files in excess of 10,000 records. The
limit is probably somewhere around 13,000 records. If anyone
experiences a problem, please let us know.



Installation and Set Up


Installing PCB System Manager on your hard disk
-----------------------------------------------
PCBSM should be located in the same subdirectory where the file
PCBOARD.DAT can be found. Most often this is in the \PCB subdirect-
ory. The following files should be found in this subdirectory:

PCBSM.EXE \
PCBSM.HLP > These 3 are the only files that are necessary
PCBDIAG.EXE /

PCBSM.CLR \
PCBSM.CNF > These 3 files are CREATED by the program
PCBSM.TBL /



Setting up PCBSM
----------------
All you need to do is copy the .EXE and .HLP files to the directory
where your PCBOARD.DAT file is located. After that, simply type
PCBSM to run the program. If desired, you can change the colors used
by PCBSM. That's all there is to it!


NOTE: Beginning with release 1.02 of the System Manager, you can now
place the PCBSM.HLP, PCBSM.TBL, PCBSM.CNF, PCBSM.CLR and PCBDIAG.EXE
files in any directory as long as your regular DOS PATH= variable
points to that directory.





3


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Things You Should Know Before Beginning



Changing the Colors used by PCBSM
---------------------------------
Okay... so my tastes in color are wierd to say the least... that's
why I made it so you can change the colors that PCBSM uses! One
thing you should know: if you have a monochrome system or have run
MODE BW80 (or some other program that has inadvertently set your
system to mode BW80) then all you get is black and white. Doing a
MODE CO80 will at the DOS prompt will bring you back into color mode.

To change the colors, select "Customize Colors" from the main menu
and you will be presented with several groups of colors. You can
modify all colors used by PCBSM. Try it... you'll understand it
better than if I try to explain it here.

When you're done, don't forget to save the colors. After saving them
PCBSM will remember your chosen colors from then on and you'll never
have to remember my poor taste in colors again!
































4


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




How to Use PCBoard System Manager

Users File Maintenance


Editing the Users File
----------------------
The Users File Editor has two screens, a Short Form and a Long Form.
The purpose is to be able to quickly update your users in the Short
Form where the only questions that need to be answered are those that
pertain to upgrading (or downgrading) a user such as the security
field, the conference registrations, the delete flag, etc. The Long
Form has all of the fields in the user's record available for editing
to give you full access to each user's current values.

The default form is the Short Form. To toggle between Long and Short
Forms simply press the F2 function key.

While in the Users File Editor there are a few keystroke commands as
well as many generic commands (see the appendix for the Editing
Commands). The following pertain only to the Users File Editor:

[Alt-A] = Add a new user. This brings up an empty record (with
the public conference string filled in).

[Alt-F] = Find a User. This uses the users file indexes and
requires the name be spelled correctly.

[Alt-S] = Search for Text. This converts all of the fields in
the record to ASCII before performing the search. It
can be useful for finding a name that you can't
remember how to spell or for finding all users in a
given city.

[Alt-L] = Search for a specific Security Level.

[Alt-E] = Search for a specific Expired Security Level.

[Alt-O] = Search for a Deleted User (Delete Flag is ON).

[Alt-R] = Repeat the last Alt-F, Alt-S, Alt-L, Alt-E or Alt-O.

[Alt-T] = Jump to the Top Record (record number 1).

[Alt-B] = Jump to the Bottom Record (last record in the file).

[Alt-P] = Print the Current Record on the Printer.

[Alt-D] = Delete User. Change his Delete Flag status to YES.




5


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Editing the Users File (continued)

The following keys, although used in the other text editors, behave
differently in the Users File Editor:

[PgDn] = Move to the Next Record. Roll around to the first
record if already at the last.

[PgUp] = Move to the Previous Record. Roll around to the last
record if already at the first.

[Ctrl-PgDn] = Move forward 20 records.

[Ctrl-PgUp] = Move backward 20 records.


There are two items of information on the screen to help you
determine where you are in the users file. One is the record number
which is printed as "Record: 1 of 2000" for example. The other is
a visual aid on the right side of the screen which indicates how far
along you are. The pointer is at the top when you are on the first
record and it is at the bottom when you are at the last record.





























6


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Sorting the Users File


Currently there are 14 different methods of sorting the users file
with PCBoard System Manager. Additionally you may sort in forward or
reverse order giving a total of 28 sorts available. These are:

Name
Password
Business / Data Phone
Home / Voice Phone
Registration Expiration
Comment Number 1
Comment Number 2
Conference then by Name
Location then by Name
Security then by Name
Times On then by Name
Downloads then by Name
Uploads then by Name
Upload / Download Ratio


Notes:
------
1) All of the sorts by Name are done in Last Name, First Name order.
2) It is recommended that you run the "Standardize Phone Formats" on
the Users File Maintenance menu before running any of the sort by
Phone options.
3) The Upload / Download Ratio is determined by a formula that makes
users with more downloads per upload sort to the top while users
with more uploads than downloads sort to the bottom. (The
opposite is true if you sort in reverse order).


















7


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Packing the Users File

Deleting a User
---------------
It should be noted that setting the Delete Flag to YES does not
automatically delete a users record (even when the Alt-D keystroke is
pressed). PCBoard supports two ways of locking a user out of the
system: 1) Flag the user for deletion, and 2) Set his security
level to zero. Both of these will keep the user from getting onto
the system. If you want to remove the name from the users file then
you need to PACK the users file by selecting "Pack the Users File"
from the Users File Maintenance Menu.


When PACKing the users file there are several options to give you
more flexibility in handling the users file, they are as follows:

Remove Users that are marked for deletion
-----------------------------------------
Delete all records that have the Delete Flag set to YES.

Remove Users that are `LOCKED OUT'
----------------------------------
Delete all records where the security level is 0.

Remove Users who haven't been on since
--------------------------------------
Delete all records where the user has not logged on to the system
since a specified date. This helps to get rid of users who no longer
call the board. Or, when combined with the Security option below it
can get rid of all new users who have called back in a months time.

Remove Users whose Reg. Exp. Date is older than
-----------------------------------------------
Delete all records where the users Registration Expiration Date is
older than a specified date.

Keep Users with security equal or greater than
----------------------------------------------
Over-ride a pending deletion if the user's Security Level is greater
than or equal to a specified number.

Print Deleted User Records on the Printer
-----------------------------------------
Print the current record on the printer before deleting it. This
will help those "manic" audit trailers.

As is the case on every function that can modify the users file in a
global nature, the packing operation may be aborted WHILE it is
running by pressing the ESC key.

8


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Printing the Users File


Defining the printer
--------------------
The printer can be selected as LPT1: or LPT2: or you can enter any
valid DOS filename and all printer output will be redirected to a
file. You define the printer by selecting "Define Printer Port" from
the Main Menu.


Printing User Records
---------------------
There are several places where a user records can be printed:

1) When packing the Users file you may print those records that are
deleted (the whole record is printed).

2) When changing security levels the modified records can be printed
(showing only the name of the users and the old and new security
levels).

3) When editing the users file you can press Alt-P to print the
current record on the screen to the printer.

4) From the Users File Maintenance Menu by selecting the "Print
Users File" option.


When selecting the "Print Users File" option from the Users File
Maintenance menu you can print have some flexibility in determining
what portion (or all) of the users you want to print. You are
presented with a screen that looks similar to this:

Starting Record ?
Ending Record ?
Exp. Users Only ?

A) Print Short Form (single line)
B) Print Long Form (multiple lines)
C) Print Registration Expiration Form (single line)

Printing Format ?


The Starting and Ending Records allow you to pick out just a portion
of the users file. By combining this capability with any of the many
different sorting methods available in PCBSM you can print off just
about any group of records you like.


9


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Printing the Users File (continued)


If you answer YES to the "Expired Users Only" question then the
report will only include users whose expiration date has either
passed or is within 30 days of doing so. A user whose expiration
date is "00-00-00" would be ignored in this instance. This option
can be used very effectively with Option C report format below.

Finally, you are presented with three different types of printouts
(options A, B and C). The following explains what each of them are:

A) A columnar printout that contains just the user's name, city,
security level and phone numbers with one record per line on the
report.

B) A multiple line record that lists everything contained in the
users file about each user. You will only be able to get about
10 records per page using this option.

C) A columnar printout that contains just the user's name, phone
numbers, security level expiration date and a text field that is
either blank or has one of two messages in it: (EXPIRED) to
indicate the user's expiration date has passed, and the other one
says (## days left) to indicate how many days until the user's
registration expires. This report format can be used very
effectively when combined with the "Expired Users Only" question
above.























10


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Make Users File Indexes


Beginning with version 12.0 of PCBoard the users file is now indexed.
PCBoard uses a method of 26 indexes each index handling one letter of
the alphabet. The user records are store in the index according the
first letter of their first name. This was chosen over the Last
Name, First Name approach merely for speed and simplicity.

Initially we played around with having only one user index file.
Problems arose in that while this was indeed a fast indexing method,
it takes awhile to add a new user to the index file. If by chance a
new user was being added while another user on another node was
trying to log on that user had to wait because the index is locked
during the adding of a new user.

On some systems this could turn into a 30 second wait if the system
is slow enough or if there are a large enough number of records in
the users file.

The method of using 26 indexes then was chosen to not only speed up
the "adding" of a new user (smaller indexes, faster insertion) but
ALSO it was to decrease the chances of a caller on another node
trying to use the same index at the same time since there are now 26
different possibilities. Obviously we live in an imperfect world and
there is not an even distribution in first letters in first names.
But, for the most part it works and works well!

The Make Users File Indexes option in PCBSM is put here merely to
regenerate the users file indexes in case you suspect that they are
out of sync for some reason. For the most part both PCBoard and
PCBSM manage the indexes in an automatic and unattended fashion and
do not require the use of this feature.


















11


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Adjusting Security Levels


NOTE: if you used version 1.0 of PCBSM you should read Appendix C.

There are several methods for adjusting security levels in PCBSM,
they are as follows:

Adjusting Security and Expired Security Levels by Range:
--------------------------------------------------------
You can adjust a range of levels to a new level by answering the
following questions:

Change users whose security is EQUAL TO or GREATER THAN?
and whose security level is EQUAL TO or LESS THAN?

To a new security level of?

For example, you can change all security levels in the range of 25 to
35 to a new security level of 30.


Adjust Security Level by Upload / Download Ratio:
-------------------------------------------------
To adjust securities by Upload / Download Ratio you first have to
create a table of entries indicating a Ratio and an attached Security
Level to that ratio. A few rules to abide by when creating the ratio
table are as follows:

1) Negative numbers mean a ratio of Downloads to Uploads.
2) Positive numbers mean a ratio of Uploads to Downloads.
3) All numbers are multiplied by ten.
4) You should order the numbers from smallest to largest ratio
level. If you forget, the system will do it for you, but your
security level definitions may not make sense if you did it
incorrectly.
5) The ONLY users whose security levels MIGHT be adjusted when
performing the "Adjust by Ratio" selection are those whose
security levels are listed in the table. For example, if you
create a table similar to the following below, then only users
whose security level is 25, 35, 40, 55 or 60 will run the risk of
having their security levels adjusted.
6) If a user's security level will be adjust to the level in the
table where the ratio does not equal to or greater than the ratio
listed (unless it's lower than the lowest ratio listed). For
example, a user with a ratio of 70:1 downloads would receive a
security level of 25. One with 5:1 downloads would receive a
level of 35. And one with 3:1 uploads would receive a level of
60.


12


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Adjusting Security Levels (continued)


Example Table:

Ratio Security
----- --------
-500 25 (means 50 downloads to 1 upload)
-200 35 (means 20 downloads to 1 upload)
-75 40 (means 7.5 downloads to 1 upload)
0 55 (means equal # of downloads,uploads)
20 60 (means 2 uploads to 1 download)


Adjust Security Level by Number of Uploads:
-------------------------------------------
This method is much simpler but still requires that you first create
a table of entries indicating the number of uploads and an attached
Security Level to that number. You should follow rules 4 through 6
listed for creating a table of ratios.


Change Security to Expired Level:
---------------------------------
This selection examines all user's Registration Expiration dates to
see if their registration has expired (based on the current date).
If it has, then it changes the user's security level to be equal to
that of the Expired Security Level as recorded in the user's record.

The reason for this change is that PCBoard does NOT change a user's
security level when the registration expires. Instead it merely
reads the Security Level or the Expired Security Level from the
user's record based on the current date and the Registration
Expiration date in the user's record.

If you need to perform the "Adjust by Ratio" or "Adjust by Number" of
Uploads on users whose expiration has expired then you should change
their security levels first, otherwise, the adjustments will have no
effect on the user's access to your system.












13


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Group Conferences


Inserting and Removing Group Conferences:
-----------------------------------------
Inserting a group conference allows you to globally make sure that
all users within a specified range of security levels have access to
a specific conference.

For example, you can enroll all users with a security level of 25
through 35 into conference number 8. If the user was already
registered his record is untouched. If the user was not and his
security level falls between 25 and 35 (inclusive) then his
conference registration is modified to reflect the access to
conference number 8.

By the same token a group of users may be removed from a conference
using security levels the same as the above.

































14


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Standardize Phone Formats


This option is in PCBSM to allow you to put all phone numbers in the
users file into one format making the phone numbers easier to read
and also enabling the "sort by phone number" option to function
correctly. Without putting the phone numbers into some kind of
standard format the sort by phone number option is meaningless.











































15


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Users File Maintenance

Undo (restore backup)


Every command that can globally affect the users file can be aborted
during the operation by pressing the ESC key and leaving the users
file intact.

But, what if the operation has already completed? Or what if you
suspect that your users file is corrupted?

Manually, you'd have to go to the \PCB\MAIN subdirectory and delete
the users file, rename the backup file and then come back into PCBSM
and regenerate the users file indexes to ensure that they correspond
with the users file.

By simply selecting the "Undo" command the above will be performed
automatically.


































16


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Directory Maintenance

PCBFiler program


For this release of PCBoard System Manager the File Directory
Maintenance will be left up to another program that has previously
been distributed with PCBoard called PCBFiler.

PCBSM will automatically chain to PCBFiler when selecting Directory
Maintenance from the Main Menu. Or, you may exit to DOS and type
PCBFILER to start the program. Either way will function fine. The
advantage to using PCBSM is of course the fact that you never have to
start another program since PCBSM handles all of the text editing
needed for PCBoard's system files (except pcboard.dat and you gotta
know we're working on that one too!).

For more information about using PCBFiler see the documentation for
PCBFiler. Once you have learned either PCBSM or PCBFiler the other
one should be easy to handle since they are very similar in style.

































17


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Edit Passwords File


When you select Edit Passwords File you will be asked to enter the
name of the Passwords file. The default answer, as determined by
your pcboard.dat file, will allow you to simply hit the Enter key in
most cases. Exceptions will be when you have more than one Passwords
file (possibly to handle more than one node).

The file consists of four fields, Password, Security Level, Time
Allowed on System and Maximum K-bytes downloadable per day.

An example might be the following (note where it says "(blank)" it
means the field is left empty):


Example # Password Security Level Time Allowed K-Bytes
-------- -------- -------------- ------------ -------
1 (blank) 10 15 0
2 (blank) 20 30 100
3 (blank) 30 45 500
4 Secret 30 90 9999


Let's consider the above scenarios one by one:

1) A user with a security level of 10 would be allowed on the system
for up to 15 minutes but would not be able to download any files
since his limit of 0 bytes has already been reached.

2) A user with a security level of 20 would get up to 30 minutes on
the system and be able to download as many files as he likes
during that 30 minutes up to a maximum of 100k total in bytes.

3) A user with a level of 30 would get 45 minutes and could download
up to 500K bytes.

4) A user who had BOTH a security level of 30 AND whose password is
"Secret" would instead be allowed on the system for 90 minutes
and could download up to 9,999K bytes (the maximum allowable).


Many sysops choose not to even implement the Download K-Bytes limit
and prefer to just leave the number at 9999 allowing the callers to
download whatever they can during the time they have allotted to
them.

The reason for the download limit is that with the advent of 9600
baud modems, callers can download much more in the same 30 minutes
than was previously possible. Use the configuration as you see fit
for your needs.


18


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Edit Download Security File


When you select Edit Download Security File you will be asked to
enter the name of the Download Security file. The default answer, as
determined by your pcboard.dat file, will allow you to simply hit the
Enter key in most cases. Exceptions will be when you have more than
one Download Security file (possibly to handle more than one node).

The file consists of four fields, Drive and Path, File Specification,
Security Level and Password.

An example might be the following (note where it says "(blank)" it
means the field is left empty):


Example # Drive/Path File Specification Security Password
-------- ---------- ------------------ -------- --------
1 (blank) *.* 30 (blank)
2 C:\PCB\MAIN\ USERS 110 Special
3 C:\PCB\DL20\ *.WK1 60 (blank)
4 D: *.* 90 (blank)


Let's consider the above scenarios one by one:

1) A user with a security level of 30 can download any file on any
drive in any directory that is SPECIFIED as a download directory
in your PCBOARD.DAT file with the exceptions that follow in the
next examples.

2) A security level of 110 and the knowledge of the password
"SPECIAL" would be required to download the USERS file found in
C:\PCB\MAIN.

3) Anyone with a security level of 60 or higher can download any
Lotus worksheet files found in the C:\PCB\DL20 directory.

4) A security level of 90 is required in order to access any file
found on the D: drive no matter what directory it is found in.













19


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Edit Upload Security File


When you select Edit Upload Security File you will be asked to enter
the name of the Upload Security file. The default answer, as
determined by your pcboard.dat file, will allow you to simply hit the
Enter key in most cases. Exceptions will be when you have more than
one Upload Security file (possibly to handle more than one node).

The file consists of four fields, Drive and Path, File Specification,
Security Level and Password.

An example might be the following (note where it says "(blank)" it
means the field is left empty):


Example # Drive/Path File Specification Security Password
-------- ---------- ------------------ -------- --------
1 (blank) *.* 30 (blank)
2 (blank) *.PIC 45 (blank)
3 (blank) USERS 110 Special
4 C:\SYSOPS\ *.* 90 (blank)


Let's consider the above scenarios one by one:

1) A user with a security level of 30 is allowed to upload any file
he chooses as long as it does not already exist on the system
with the exceptions that follow in the next examples.

2) A user would need a security level of 45 in order to upload any
files with an extension of .PIC.

3) A user would need a security level of 110 plus would have to know
the password "SPECIAL" in order to upload a file called USERS.

4) A user would need a security level of 90 in order to upload any
files into the sysops upload directory.















20


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Edit Trash Can File


When you select Edit Trash Can File you will be asked to enter the
name of the Trash Can file. The default answer, as determined by
your pcboard.dat file, will allow you to simply hit the Enter key in
most cases. Exceptions will be when you have more than one Trash Can
file (possibly to handle more than one node).

The file consists of only one field. If anyone tries to log onto
your system using a name, either first or last name, that is listed
in the Trash Can file they will not be allowed onto the system.

An example might be the following:

Trash Can Names
---------------
AGENT
MR.
JEKYLL
DEATH
PSYCHO


Other possibilities to place in the Trash Can file would be swear
words. It's hard to out-guess the crazy people of the world and the
Trash Can file is only here to help. If you see a name used on your
board that you don't like then add it to your Trash Can.

























21


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Edit Doors Listing


When you select Edit Doors Listing you will be asked to enter the
name of the Doors Listing file. The default answer, as determined by
your pcboard.dat file, will allow you to simply hit the Enter key in
most cases. Exceptions will be when you have more than one Doors
Listing (possibly to handle more than one node).

The file consists of three fields, Name, Security and Password.

An example might be the following (note where it says "(blank)" it
means the field is left empty):


Example # Name Security Password
-------- ------ -------- --------
1 DEMO (blank) (blank)
2 ZDOOR 30 (blank)
3 CHESS 45 (blank)
4 PROCESS 90 Special


Let's consider the above scenarios one by one:

1) A user with any security level high enough to access the doors
feature (defined in PCBSetup) would be able to access Door #1.

2) A user with a security level of 30 would be able to run ZDOOR (an
archive viewer, file transfer door).

3) A user with a security level of 45 would be able to play CHESS.

4) A user with a security level of 90 and knowing the password
"SPECIAL" would be able to access a special door called PROCESS.


















22


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Edit Protocol Listing


When you select Edit Protocol Listing you will be asked to enter the
name of the Protocol Listing file. The default answer, as determined
by your pcboard.dat file, will allow you to simply hit the Enter key
in most cases. Exceptions will be when you have more than one
Protocol Listing (possibly to handle more than one node).

The file consists of four fields, Letter, Type, Block Size and
Description.

An example might be the following:


Example # Letter Type Block Size Description
-------- ------ ---- ---------- -----------
1 A I 128 Ascii (Non Binary)
2 X I 128 Xmodem (Checksum)
3 C I 128 CRC Xmodem (CRC)
4 Y I 1024 Ymodem (PCBoard)
5 G I 1024 Ymodem-G (PCBoard)
6 I I 128 Imodem (Qmodem)
7 B S 1024 Ymodem (Forsberg)
8 Z S 1024 Zmodem (Forsberg)
9 N I 0 None


Explanation:

Letter is any letter from A to Z
Type is either I for Internal or S for Shell
Block Size is the size of the blocks used during transfer
Description is a description of the protocol given to the caller


NOTES:

1) All of the above protocols listed as I, for internal, are built
in protocols for PCBoard. You may disable any protocol simply by
not putting that protocol in the Protocol Listing.

2) You may NOT change any of the letter assignments to another
letter for internal protocols. In other words, Xmodem/CRC will
always be the letter C. However, you CAN change the letter C to
represent an external Shell protocol.

3) Shell protocols are those where PCBoard shells to DOS and runs a
batch file corresponding to the letter and transmission type
being used (see PCBoard documentation for more information).



23


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Command Line Parameters


PCBSM has special command line parameters which allow it to be used
from inside batch files for ease of use or for unattended operation.

To use the command line parameters you type:

PCBSM /command(;parameters, if any)

The following commands are available (note: the underlined commands
are required parameters):



/INDEX - create all index files
------

/SORT;; - sort the users file
----- ----- sel = a letter from A to N
reverse = Y or N (defaults to N)

/ADJUST;; - Adjust the user security levels
------- ------ type = RATIO or UPLOAD
print = Y or N (defaults to N)

/PACK;;;;;;
----- - Pack the users file
deleted = Y or N (defaults to Y)
lockedout = Y or N (defaults to Y)
since = a date (default 01-01-80)
expired = a date (default 00-00-00)
security = 0- 100 (default 100)
print = Y or N (defaults to N)



















24


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Appendix A

Special Editing Keys

The following is a list of valid editing keys that can be used while
editing any of the PCBoard files (USERS, PWRD, FSEC, etc):


[Esc] = Pressing [Esc] always exits to the previous screen.

[F1] = Help. You can press [F1] for help at any point in
PCBSM to receive help for what you are doing at the
time.

[F10] = This key is a limited "undo" key. It will undo any
changes made within the current input field.

[Tab] = This key allows you to move to the previous field
(moving to the left).

[Return] = This key allows you to move to the next field (moving
to the right).

[Up] = The Up arrow on the cursor pad will move the cursor up
one line.

[Down] = The Down arrow on the cursor pad will move the cursor
down one line.

[Left] = The Left arrow on the cursor pad will move the cursor
to the left one character.

[Right] = The Right arrow on the cursor pad will move the cursor
to the right one character.

[Home] = Pressing [Home] moves the cursor to the first character
of the input field.

[End] = Pressing [End] moves the cursor to the last character
of the input field.

[Ins] = Toggle between Insert and Type Over modes.

[Del] = Deletes the character where the cursor is located.

[PgUp] = The [PgUp] key will move up to the previous screen and
place the cursor at the bottom of the screen.

[PgDn] = The [PgDn] key will move down to the next screen and
place the cursor at the top of the screen.



25


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Special Editing Keys (continued)


[Ctrl-PgUp]= Press [Ctrl-PgUp] once and the cursor will move to the
top of the screen. Press it again and the cursor will
move to the top of the file.

[Ctrl-PgDn]= Press [Ctrl-PgDn] once and the cursor will move to the
bottom of the screen. Press it again and the cursor
will move to the bottom of the file.

[Ctrl-End] = Press [Ctrl-End] to clear the contents of the current
input field from the cursor to the end.








































26


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Appendix B

What to do if you are having problems


Okay... so you've copied the files from your diskettes and you've
glanced through the manuals (who really reads those things anyway?)
and the software isn't working for you....

What do you do now???

PCBoard System Manager has a selection on the main menu called
Analyze System Configuration. This selection will try to identify
some of the trouble spots that you might run into in your current
setup. (You can also run the analysis by typing PCBDIAG which is the
external module that PCBSM calls to perform its diagnostics).

If PCBSM's analysis indicates that you need to create files or remove
them or whatever, you should take the actions recommended by PCBSM
before going any further.

If you are still having problems you can specify that your printer be
redirected to a file with the "Define Printer Port" selection (for
example, answering OUTPUT as the printer name will send all printer
output to a file called OUTPUT in your default directory).

Once you have redirected the printer, you then need to run the
analysis again and answer YES to both of the questions for printout.
Then send a copy of the file to us at Clark Development Company and
post a message indicating that you have uploaded the file (and what
you called it) and give a description of the problem you are having.

We will look over the file and get back to you on the board as
quickly as possible.

The bulletin board numbers are:

801-261-8976 (most callers, rings down)
801-261-8977 (extended support, rings down)
801-261-8979 (Hayes 9600 callers)


Some of the capabilities and functions of PCBDIAG include the
following:

- Print out of all configuration files for PCBoard
- Analysis of hard disk size, free space, bytes per sector, etc.
- Screen Information (card installed, mode, etc)
- Check type of CPU installed




27


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Diagnostic Capabilities (continued)


- Print out of current DOS path setting
- Print out of all PCB= parameters from the environment
- Location of command.com (from COMSPEC)
- Test for DOS VERIFY being enabled
- DOS version number
- Check to see if SHARE is loaded
- Test the various SHARE functions to see if they are working
- Check to see if PCBoard is configured to run on a network
- Check for a valid node number
- Cursory check of the comm port setup
- Maximum number of files allowed open (current partition if running
a multi-tasking system)
- Check for the existence of all necessary files
- Warn if user does not have a drive specifier in his upload path
- Check for valid number of message blocks (used in message indexing)
- Scan the users base for any un-matched PWRD / security level
entries
- Scan the users base for any conference registrations in non-
existent conference's
- Check the FSEC and UPSEC files and verify that all PATHS listed
(if any) actually exist.
- Check the DOORS data file to verify that each door listed
(filename) actually exists.
- Check the PCBPROT.DAT file to verify all internal protocols and to
verify the existence of batch files for all external protocols.

























28


PCBSM Documentation ver 1.02 for use with PCBoard ver 12.x
A PCBoard System Files Manager




Appendix C

Differences in PCBSM v1.0 Tables

IMPORTANT!!!!

The "Adjust by Ratio" and "Adjust by Uploads" features have been
modified. Instead of checking for a user's security level to be in a
RANGE of levels specified as the lowest and highest listed in the
table, it now requires that the user's level be hard coded into the
table otherwise the user will be ignored. Example table:

Security Levels in Table (either Uploads or Up/Dn Ratio Table)
--------------------------------------------------------------
10 |
15 | OLD WAY: Users whose security levels were between 10 & 70
25 | would have their security levels adjusted if it was found
30 | to be necessary.
50 |
60 | NEW WAY: Only users with levels 10,15,25,30,50,60,65 & 70
65 | would have their security levels adjusted. Anyone having
70 | a level such as 12 or 45 (not matching any entries) would
| be ignored.


IMPORTANT!!!!

The size of the Upload/Download Ratio and Uploads Tables have been
increased from 15 entries to 60 entries. This means that if you have
been using either of these features you will need to run a conversion
program. Do the following:

1) change to your directory where the PCBSM.TBL file is found
2) type FIXTBL
3) rename PCBSM.TBL to something else to save it (or delete it)
4) rename TABLE.NEW to PCBSM.TBL

The change that caused this is that now these editors are sharing the
same routines with the other text file editors. You can now Page
Down and back inside the table with a maximum of 60 entries in each
table. Also, one other benefit is that you can now ALT-I to insert a
line, or ALT-D to delete one.











29