Category : Communication (modem) tools and utilities
Archive   : ASPHST.ZIP
Filename : HOST.DOC

 
Output of file : HOST.DOC contained in archive : ASPHST.ZIP
Procomm Plus Scripted Host Mode
----------------------------------------------------------------------------
HOST.ASP
Copyright (C) 1992,1993 Datastorm Technologies, Inc.
All rights reserved.

An ASPECT script file that emulates the built in functions of the
internal host mode. It was written to allow users more flexibility and
control of their host mode functions.

While providing a flexible and functional alternative to the starndard
host this ASPECT SCRIPT is intended only as an example of ASPECT programming.
DATASTORM makes no warranty of any kind, express or implied, including
without limitation, any warranties of merchantability and/or fitness
for a particular purpose. Use of this program is at your own risk.

Author: Michael Schamberger - 1993
----------------------------------------------------------------------------

Introduction:

The PCPLUS Scripted Host Mode was written to allow users additional
flexibility in using host mode. The scripted version, as supplied
here, basically mirrors the PCPLUS internal host with a few
additions. These additions are: the ability for normal users to
access multiple directories and the ability for privileged users to
change default directory without shelling to DOS. Parameters
indigenous to Scripted Host are now stored in a Host Parameter
file.

A Host Utility program allows the sysop to modify the Host
Parameter file. The utility program also allows the sysop to
read/delete/pack the message base as well as define the supplemental
directory base.

Requirements:

DOS 3.30 or above
Procomm Plus 2.0x
Large Model Aspect Compiler v1.01L (Available from DATASTORM BBS)
Some experience in Aspect programming (for modifications)

Additions: (for version 1.0)

There are five main differences between 2.0x internal host and
Scripted Host:

1. Alternate access areas for normal users, these directories
are defined by the sysop. (Using HOSTUTIL.ASP)
2. Ability to change default directory for privileged users, allows
privileged users to enter a path, which then becomes the default
directory, warns user if entered path is invalid.
3. External parameter file containing Sysop preferences, an ASCII
file that contains Sysop preferences. Editable with any text
editor or with Host utility program.
4. Extraneous utility program (HOSTUTIL.ASP) which allows Sysop to
edit the external parameter file. The utility program also
allows the Sysop to Read/Leave Mail, and to pack (strip all
deleted messages) from the message base.
5. Added an additional display file HOST.OPN, which will be displayed
to the caller BEFORE he receives the first name prompt.

Required
Files:

HOST.ASP - Main host script
SUBS1.INC \
SUBS2.INC \
MAIL.INC > Include files for Host.Asp, needed for compiles
INCLUDE.INC /

HOSTUTIL.ASP - Utility script

HOST.DOC - This file

ASPCOMP.EXE - version 1.01L
The large model ASPECT 2.0x compiler is
needed to compile scripts larger then 32K,
ie. Host.Asp

Note: All data files have to be located in the directory specified with the
PCPLUS DOS environment variable, if no variable exists, the current
directory is used. With the exception of PCPLUS.USR all data files
associated with scripted host have "HOST" as the filename prefix.

ie. HOST.NWS, HOST.LOG, etc.

The external files supported are listed below:

PCPLUS.USR - File containing user name,password, & access level
HOST.PRM - Host parameter file
HOST.MSG - Mail message file
HOST.HDR - Mail header file
HOST.NWS - News file
HOST.NUF - New user file
HOST.LOG - Log file
HOST.HLP - Help file
* HOST.OPN - Opening screen
* ~HOST.TMP - Temp file (used by mail)

Note: Files marked with an "*" are new files indigenous to the scripted host.

Fix for 1.0a

1) Paths to include files no longer hard coded. (My fault, what was I
thinking.

What's new in 1.01
------------------

1) The initial baudrate is no longer hard coded. It is obtained from
the current port setting.
2) The COM port used by the shell function is no longer hard coded.
The current port is assumed as the host shell port.
3) Change directory for privileged users now excepts ".." & "."
4) Colors are obtained directly from PCPLUS.PRM file. (Uses Normal &
Hilight colors from File Transfer Window settings.)
Note: If changes are made to the colors with SETUP, but NOT made
permanent, they will not be reflected by the script. The script
access the PCPLUS.PRM file, & temporary changes are not saved.
5) Chat mode exits when an ESC is receive from remote.
Chat termination messages added.
6) Fixed error when Host Download path is blank. (Range Error)

1.01b
------

1) Recognizes SYSOP as valid name (no longer prompts for last name)
2) Obeys Host Setup Goodbye action
3) Now has one exit point
4) Includes code to add additional character checking during logins.
This is for users in the European Community who need to use
8-bit ASCII characters in their login name.
5) EC flag added to HOST.PRM for use in EC and added to HostUtil.Asp.

1.02
----

1) User access derived from PCPLUS.USR. (See Note)
2) If PCPLUS.USR file doesn't exist, it's be created.
3) To all users who received an "Unable to create (NULL)" message, sorry,
I've re-added the filename causing the problem. Who says cryptic
error messages can't be fun.

1.02 Notes: The new format for granting user access.
1) Additional Access levels only effect privilege level 1.
2) The other privilege levels are still in effect,
(ie. 0 and 2). If a user is level 2, that will
override and additional access granted. I mean,
hey, he's a 2, he can get anywhere he wants anyway.
Level 0 can still only read/leave mail.
3) So, here it is, how to grant/limit directory access
By adding additional parameters to the comment field of a
user record you can now limit the user to 1 unique
directory OR grant him additional access to ANY OR ALL
of 10 extra directories defined with HOSTUTIL.

ie.
BLOW;JOE;PASSWORD;1; [ACCESS="C:\JBLOW"]

This lets user Joe Blow have download access to
ONLY C:\JBLOW. He loses access to the default
download directory.

BLOW;JOE;PASSWORD;1; [ACCESS=0,3,6,7,9]

This grants user Joe Blow access to directories
0,3,6,7,9 which are defined with HOSTUTIL. There
are a possible 10 additional directories
available (0-9).

NOTE: Regardless of additional access granted, ALL uploads
still go in the default Host upload directory.


1.02a
-----
1) Added ability to edit user records with HOSTUTIL.



  3 Responses to “Category : Communication (modem) tools and utilities
Archive   : ASPHST.ZIP
Filename : HOST.DOC

  1. Very nice! Thank you for this wonderful archive. I wonder why I found it only now. Long live the BBS file archives!

  2. This is so awesome! 😀 I’d be cool if you could download an entire archive of this at once, though.

  3. But one thing that puzzles me is the “mtswslnkmcjklsdlsbdmMICROSOFT” string. There is an article about it here. It is definitely worth a read: http://www.os2museum.com/wp/mtswslnk/