HOST31.SLC and H31UTILS.SLC are SALT language scripts compiled to
run under the TELIX.EXE (C) telecommunications program.



H O S T 3 1 / H 3 1 U T I L S

This program is distributed under the Shareware concept.
Non-Registered users of HOST31 are granted a limited license to
use it for a 4 week trial period, in order to determine it's
usefullness to you. ANY other use of HOST31 after that period is
strictly prohibited.

WHY REGISTER?

* Registration allows you to use HOST31 on a regular basis.

* Registered users will recieve mailed notification of updates
to the program.

* Registered users will also recieve top priority in any help
or comments they have/need.

* Registered users can obtain the source code at a fraction of
the cost that is paid by non-registered users.

HOST31 has several different registrations available:

1) Registration only. This is $15.00 and assumes that you have
a copy of the program already. This covers the program only,
and does not include a copy sent to you.

2) Registration/Diskette: This is $20.00 and is the same as 1,
but you are sent the latest version on diskette. This covers
the program and shipping charges.

3) Registration/Source: This costs $35.00 and includes not only
a copy of the latest version, but includes the source code as
well. This covers the program, source charges, and shipping
costs.

4) Source Code: This costs $40.00 and is ONLY the source code,
it does NOT include registration. This covers the source
charges, and shipping costs.

To Order:
Make cash, check or money order out to:

Daniel Horn
15837 Windrose Way
San Diego, California 92127

------------------------------------------------------------------------------

Please send:

HOST31 Registration .............. $ 15.00 _____

HOST31 Registration/Diskette ..... $ 20.00 _____

HOST31 Registered User Upgrade ... $ 5.00 _____

HOST31 Registration/Source Code .. $ 35.00 _____

HOST31 Source Code ............... $ 40.00 _____

{ Print }

Name :____________________________________________________

Address:____________________________________________________

____________________________________________________

____________________________________________________

Day Phone:(____)______-_______ Evening:(____)______-_______

Current version I have ______

Comments:_____________________________________________________

_____________________________________________________

_____________________________________________________

{ Optional }

Computer Type:________________________________________________

Color display [Y/N]: __

Where did you hear about (and/or receive a copy of) HOST31


{ } BBS Name______________________ Ph #(____)______-_______
{ } Sig Name________________________________________________
{ } CompuServe
{ } Friend
{ } Other ____________________________________________________

------------------------------------------------------------------------------
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

This program evolved from the original HOST.SLC/HCONFIG.SLC
programs, and then the later revisions by Jon Flemming found in
HOST2.SLC/H2CONFIG.SLC.

HOST3 was written as a sort of pet project of mine, in order
to enhance the HOST2.SLC program, written by Jon Flemming. I felt
that although he had made some superb changes to Colin's original
HOST.SLC, there was SO much more that could be done to make the
program even better. So, I began working on it. And this is
what I have come up with so far...hope you enjoy it!


These are the files needed to run the HOST31 program. Some
of these will be created as needed, as well some of them are only
optional:

HOST31.SLC - Main Host Mode file, must be in your telix
script directory.

H31UTILS.SLC - Utilities script, it contains all of the
utilites. It is called by the HOST3.SLC
program. It should also be in your telix
script directory. Do not try to run this
by itself!

GATEWAY2.SYS - This is the program that controls the i/o
during the time a user shell's to DOS, as
well as when they view an archive. This
file should be in your root directory.
(see "INSTALLATION" and the GATEWAY2.DOC
file included, on exact installation)

HOST31.CNF - This is the configuration file created once
the configuration program has been run. It
will be created in your telix directory.

USER31.DAT - This is the file that holds all the user
information, it is created by HOST3.SLC. It
will be created in your telix directory.
(See section on CONVERT.SLC)

HOST31.LOG - This file is created by the HOST31 program,
it is a log of all user logon's, and what
each user does when on the system. It will
be created in your telix directory.

*.ASC/*.ANS - There are eight text files that are truely
optional. These files need to be in your
telix directory, if you are going to have
them. (see "OPTIONAL EXTERNAL FILES")

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

INSTALLATION

This is really a very easy program to install. Below are
some step by step instructions on installing it:

1) Put the HOST31.SLC/H31UTILS.SLC files into your Telix
script directory. (See Telix docs on setting a default
script directory.)

2) Put the GATEWAY2.SYS file into your root directory. Edit
your CONFIG.SYS file by adding this line:
DEVICE = GATEWAY2.SYS -D -[COM PORT]
Where [COM PORT] is the com port your modem is in. For
a modem on com2 you would use this line:
DEVICE = GATEWAY2.SYS -D -2
Reboot your computer (otherwise the gateway2.sys program
will not be installed.) See the included, GATEWAY2.DOC
file from the author of GATEWAY2 for more information
on the GATEWAY2.SYS program.

3) Run Telix, and then when in Telix run the HOST31 script.
(ALT-G, then type in HOST31). HOST31 will search for the
configuration file, and then will automatically run the
H31UTILS.SLC program. Input all the variables needed in
the program and then choose the "X" (Exit and Save). See
the section "H31UTILS ( The Configuration Program )" for
more detail on the configuration of HOST31.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

ACCESS LEVELS AND WHAT EACH CAN DO

There are four access level's in this program. This section
will describe what each level can do.

Level 0: This is the level of a new user that logs on, he/she can
not do much of anything on the board, except to chat,
upload files, or change their defaults. Optionally, the
Sysop can have them logged off once they have input all
of the information.

Level 1: This is your basic user level. The user can do most
of the things available (except for a few things below),
but there are a few limits placed on the user. For one,
the user can only download a certain limit per call, (as
specified in the configuration. As well they can only
download from the download directory, and can NOT use
the extract archives command.

Level 2: This user is the same as the level 1 user, but does not
have a download limit, and can use the extract archives
command.

Level 3: This user can not only do all the Level 2 user can, but
can also download files from ANY directory on your disk,
they can also look at the daily user log, and can do a
"Shell to DOS" IF they know the system password. (Which
is defined in the configuration program).

Level 4: Your basic Sysop level. Currently this level can do the
exact same thing as the Level 3 user with one addition.
Having this level gives the user the option of shutting
down the system remotely, I would reserve this level for
yourself (the sysop) only, but if you have a extremely
good friend...well, that's up to you.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

LIST OF USERS COMMANDS

This is a list of all user commands, and what each can do.
It is separated into sections by level's, each higher level can
do what the previous can do.
Level 0

[U]pload: Upload files. Level's 3+ can upload to ANY directory.
If the file is a archive (either ARC/PAK/ZIP) it will
be tested. If it fails the test the archive will be
erased.

[C]hat: If the sysop is available, this command will ring a bell
calling you to chat, otherwise it will print a message
saying that the sysop isn't available. If the sysop is
not available a line will show up on the status box that
says "WANTS TO CHAT". (See "Sysop's Keyboard Commands",
and "H3UTILS (The Configuration Program)" sections, for
more information on chat).

[X]xpert: This function allows the user to change his expertise
level, to one of three levels:
NOVICE: Gives a menu of commands.
INTERMEDIATE: Gives command letter's as part of
the input line.
EXPERT: NO help whatsoever!

[G]oodbye: Log's the user off.

[Y]our Defaults: Let's the user change their address, city, zip,
state, choose a default protocol, and turn the
pause function on or off.


Level 1

[D]ownload: Download files. Level 1 can only download specified
limit. Level's 3+ can download from ANY directory.

[F]iles List: This shows the user what files are currently in
download directory.

[T]ype Text File: Types a text file out to the screen, pause can
be turned on or off in the user defaults, as
well, hitting "P" will pause, and "S" will
abort the listing at any time. Level's 3 +
can type files in ANY directory.


[V]iew Archives: Let's the user view archives. Level's 3 + can
view archives in ANY directory.


Level 2

[E]xtract files from archives: This let's the user extract files
from a archive, the file is then
archived (using PKZIP), into the
temporary arc ( TEMPARC.ZIP ), it
is deleted when the user hangs up

Level 3

[S]hell to DOS: This let's the user shell to DOS. If the user is
remote (not keyboard) then they will be prompted
for the system password, if they fail to enter
it they will not be able to shell.

IMPORTANT!!!!: There is NO current way to check on the status of
the carrier. Due to this fact, if the carrier is
lost while a user is in DOS (via remote) then the
SYSTEM WILL HANG!. The only solution if this is
to happen is to reboot the computer.

System [L]og: This shows the user the daily usage log, hit "P"
to pause, "S" to abort.

Level 4

Control-Z: This let's the user shut down the system. The user is
is prompted for the system password, if they fail the
program will continue running.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

SYSOP'S KEYBOARD COMMANDS

This is a list of the commands available to the sysop, not
all commands are available at all times.

WHEN NO USER IS ONLINE

F1: This turns chat on or off, the line in the status box shows
the current condition of chat. (If chat is turned off during
the Chat hours, then the "OFF" will be in red).
(See "H31UTILS (The Configuration Program)" for more detail
on Chat Hours).

F2: This brings up the user editor, note that there must be at
least ONE user, otherwise the user editor will NOT work.
(See "H31UTILS (The User Editor)"for more information on the
user editor)

C: This runs the configuration program.

U: This will run the user compressor program, this will delete
any old or deleted users. NOTE: There must be at least one
user in the user file, or the compressor will not run.

HOME: This brings up a box giving all the online commands.

ESC: This will exit the program and go back to Telix.

WHEN A USER IS ONLINE

F1: Turn chat on or off (same as above)

F2: Run user editor (same as above)

F3: Temporarily lower the users access.

F4: Temporarily raise the users access.

F9: Shell to DOS (the user can not see)

F10: Chat with user.

END: Terminate user.

ESC: Exit program to Telix.

HOME: Bring up the help box.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

H31UTILS.SLC

(The configuration program)

This program will allow you to change some important data in
the HOST3 program. This section will tell what each category is
for:

Page 1

Download directory: This is the directory that the users will be
downloading from. It will be a sub-directory
of your Telix directory. If it is not a legal
directory (doesn't exist) it will be created.

Upload directory: This is the directory that all uploads will go
into. It will also be a sub-directory and will
created if it does not exist.

Connection: This is how your computer will be connected. Usually
it will be MODEM(unless you plan to run on a network)

System Password: This is the password that is needed to shut down
the system, or to shell to DOS.

Archive Directory: This is the directory that your archive utils.
are found in. It must be a EXACT directory
or the program will NOT be able to do anything
dealing with archives (VIEW/TEST/EXTRACT), the
program will support (ARC/PAK/ZIP), but there
must be these files.

For *.ARC's:
PKPAK.EXE
PKUNPAK.EXE
For *.ZIP's
PKZIP.EXE
PKUNZIP.EXE
For *.PAK's
PAK.EXE
(must have these commands!)
View: "V"
Test: "T"
Extract: "X"

Access limit: This is the limit (in K's!) that a level 1 user can
download per call.

Time Chat is to come on: This is the time that you would like the
"Chatting times" to start at. Chat will
come on (regardless of current setting),
at this time, and will stay on (UNLESS
shutoff manually, if done, the "OFF" in
the status box will turn red), and will
go off at the off time.

Time Chat is to go off: This is the time that you would like the
"Chatting times" to end at.

(NOTE: Due to problems with some logic statements, the
Chatting times can NOT extend over midnight. You
may have chat on until 11:59pm, and can have it
come on at 12:01am. As well, it is not possible
to have chat on for more then 12 hours.)


Page 2

Color is currently: This allows you to change the program from
Color to B&W. It will affect all programs,
but will not affect the ANSI when a user is
on.

Log off new users: This (if on) will immediately log off any new
users as soon as they finish logging on. This
allows you to keep new users off the system
completely until you can validate them.

Number of Downloads: This is the number of downloads (per one
upload) a user can make. If they attempt
to download more then they can then they
will be told they need to upload more.

User log on alarm: This is a little alarm that (if on) will ring
when a user logs on.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

H31UTILS.SLC

(The User Editor)

This is the User Editor. This will allow you to change some
information about the user. There are two sections in this part.
One is about the different functions in the Editor, the other is
about the different immediately.

Movement

There are some special keys in the Editor that will move you
around.

Up Arrow : This will move you up one category

Down Arrow : This will move you down one category

Page Up : This moves you to the top of the categories

Page Down : This moves you to the end of the categories

Left Arrow : This moves you to the next user

Right Arrow: This moves you to the previous user

Control - V: This will take you to the next NEW user
(Level 0)


Control - S: This will initiate a search through the
users names for a string (input by you)

CATEGORIES

Users Name: This is the users name

Users Password: This is the users password

Users Access: This is the users access level

Users Flag: This is the users status flag, A is Active,
D is Delete, and B is Blacklist.

Users Phone: This is the users phone number

Users Address: This is the users address, it is divided
into four parts. The Address, City,
State, and Zip code

User Comment: This is a place to put a comment in

Last on: This shows when the user was last on

Downloads: This shows how many downloads the user has made

Uploads: This shows how many uploads the user has made


NOTE: There must be at least one user in the user file, or the
Editor will not run.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

H31UTILS.SLC

(The User file Compressor)

This program will go through the USER.DAT file and will get
rid of all user's with the "D" flag, and will check all "A" users
to see if they have called within 60 days. If they haven't they
will also be erased.

NOTE: There must be at least one user in the user file, or the
compressor will not run.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

OPTIONAL EXTERNAL FILES

There are four files that can be in the Telix directory, the
files are NOT needed but they will be used if there.

There are two different extensions for each name. The *.ANS are
for users that support ANSI, while the *.ASC are for those don't.

LOGON.* : This file is displayed when a user first logs
on.

NEWS.* : This file is displayed after a user has logged
on, and they have successfully entered their
password.

BYEBYE.* : This file is displayed when the user quits
the BBS.

NEWUSER.* : This file is displayed to all new users.

IMPORTANT!: The input buffer for these files is set at the level
of 255 characters per line. If your files have more
characters per line they will NOT be sent correctly!

NOTE: For some reason I have been having some problems with some
ANSI graphics screens. I'm not sure exactly why, but it
occurs mostly when typing a large animated ANSI picture, I
hope to have this fixed by the next version. Try different
line sizes if you have problems (best way is NOT using any
animation!)

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

CONVERT.SLC

This program will convert your old USER.DAT file to the new
USER31.DAT format. The file format has changed since the last
version (have added a few things) and so it was written in order
to facilitate the updating to HOST31 (otherwise you'd have to go
in and MANUALLY change each one). To use it, hit ALT-G and then
type "CONVERT", CONVERT will then rename USER.DAT to OLDUSER.DAT
and then convert each user and write it to USER31.DAT.

ATTENTION: It might be best to keep a backup of the USER.DAT
file just in case CONVERT.SLC goofs (God forbid),
otherwise you'd be stuck. If it works then you
can erase the back up. CONVERT will NOT work if
there is no USER.DAT file in the Telix directory.
I DON'T suggest renaming USER31.DAT to USER.DAT
and then running it again, as it will overwrite
ALL data!


* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

DISCLAIMER

This program is provided as is, and is to be run at your own risk.
There is NO warranty of any kind or form covering this program.
Exis Inc., Colin Sampaleanu, and the author are not in any way, or
shape, responsible, or liable for any damages of any kind that may
arise from the usage of this program, or that of any programs, or
files associated, or included with it.

TELIX.EXE, SALT, HOST.SLC, and HCONFIG.SLC: copyright 1986, 1987,
1988 by Exis Inc., and Colin Sampaleanu. Used with permission.


* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

THANKS

There are a few people to who I would like to give special
thanks to, for their help and cooperation in my endeavor to create
this program:

Rick Fry: My "official" beta tester, and more importantly, a good
friend and "idea bouncer". From whom I got more ideas,
and dislikes, then anyone else.
Thanks a lot Rick. I appreciate it!

Tony Gentile: My friend and C "teacher" who taught me the basics
of the C language, which helped a GREAT deal when
working on this program. Thanks Tony.

Bill Parfitt: The sysop of dBored (619-748-3644), who not only
gave me a LOT of support, but gave me a good place
to put my program as well, but also gave me my own
conference!
VERY special thanks to you Bill!

Hans Kellner: The creator of GATEWAY2.SYS (C), special thanks to
him since my program wouldn't work half as well, if
I didn't use his program!

And finally,

Colin Sampaleanu:

For the extremely hard work and numerous, uncounted hours
that he has put into creating TELIX, which is the very BEST (in my
opinion) telecommunications program package out there! Without it
this program wouldn't be around.

EXTRA thanks to you Colin!


* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

WHAT'S NEW?

o User now has the ability to turn off ANSI.
o Color or B&W option for Sysops.
o New access level for brand new users.
o Keeps track of users uploads/downloads.
o Now has a upload/download ratio.
o New alarm for sysops when a user logs on.
o Better main menu.
o Expanded room for State, and Zip code strings in order
for Canadian users to use HOST3
o Fixed bug in the HELP menu (kept overwriting itself).
o Fixed bug in Ymodem downloads (wouldn't work).
o Fixed bug in Configuration menu (wouldn't create upload
directory properly).
o Fixed the Extract Archive command, it used the "-a -ex"
command, which ONLY works on PKZIP 0.92 and NOT on any
previous versions, it is now "-a -ea4 -eb4" and works
on all versions.
o Created CONVERT.SLC, it will convert your old USER.DAT
file to USER31.DAT.


* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

WHAT'S AHEAD IN THE FUTURE?

I found quite by accident that there is a limit on the size
of scripts that Telix can use. In Telix 3.11 a script can be no
LARGER then 32k. As I have pushed HOST31 as far as it can go, I
can no longer add anything to the main program. Colin has said
that Telix 3.12 (due out soon) will enable you to have scripts
larger then 32k. So, this is going to be the last (unless I find a
bug and need to release a fix) version of HOST until 3.12 is out.

I have quite a few ideas in the works for the next versions
of HOST. Here's some of them:

File Database: A file database, where each file has it's
own comment. As well the sysop can add,
and delete files from the database. This
would also allow users to "SEARCH" for new
and or specific, files.

BBS List: A full working BBS listing program, where the
users can add or change any information about
their favorite BBS's.

Online Programs: A online sysop definable program section
that will be compatible with the PCBoard
door programs.

External Protocols: Will allow the sysop to add some (up
to four), external protocols. (Telix
only has space for four protocols).

DTR Checking: A way to check the status of the carrier,
while a user is in DOS.

Default Colors: This idea has been sent to me quite a few
times. So I will work on a section that
will allow you to change the colors to
your likings.

Message base: A fully functional message base system,
that would allow users to read/write mail
(both private and public).

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

If you have any suggestions or ideas for the next version,
or any problems, or, (God forbid), bugs. You may get a hold of me
at these locations.

Dbored of San Diego, (619) 748-3644 (Prodoor Conf. HOST3)
Telix Support BBS, (416) 284-0682
Prodigy (ID# SNRB40A)
WWIVnet [email protected]
PCRelay, Communications conference
PCRelay, Sysop's Conference
PCRelay, Telix Conference
Or mail me:

Daniel Horn
15837 Windrose Way
San Diego, CA 92127

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *