home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
OFFLINE
/
FNMAIL42.ZIP
/
FNETMAIL.DOC
< prev
next >
Wrap
Text File
|
1993-06-28
|
22KB
|
730 lines
F n e t M a i l
v4.2
Offline Mail Door
for
FeatherNet BBS
Copyright (C) 1991, 1993 Ron Pierce and FeatherNet Software
TABLE OF CONTENTS
-----------------
Introduction ...................................................... 2
FnetMail Features ................................................. 3
Disclaimer ........................................................ 4
Registration Information .......................................... 5
Installing FnetMail ............................................... 6
Configuring FnetMail .............................................. 7
Sample FNMAIL.CFG File ............................................ 8
Serial Port Configuration ......................................... 9
Command Summary ................................................... 10
ShareWare Registration Form ....................................... 11
FnetMail v4.2 - Page 1
┌────────────┐
│Introduction│
└────────────┘
FnetMail allows you to upload and download mail. You may read and reply
to mail with any of the offline reader programs including EZ-Reader and
SLMR (Silly Little Mail Reader). The advantage of reading and replying
to mail offline is obvious - you save your time on the bbs and can reply
or write new messages at your leisure.
FnetMail requires the use of MS/PC-DOS version 3.0 or higher and that the
dos utility "SHARE.EXE" is loaded prior to FnetMail being run. Since
this program is 100% FeatherNet BBS compatible, this SHARE notice is
redundant, however important nonetheless.
FnetMail will run on all types of PC-compatible computers.
┌────────────┐
│ Warning │
└────────────┘
Any reverse engineering or altering of the 'code' in any form is expressly
forbidden and thus illegal.
FnetMail v4.2 - Page 2
┌────────────┐
│ Features │
└────────────┘
o Allows users (local and remote) to download new mail packets
o Allows users (local and remote) to upload new mail packets
o Allows sysop to authorize New file descriptions to be downloaded
o Allows new bulletins to be downloaded
o Sysop defines maximum messages to be downloaded per day by baud rate
o Maintains a record of number of messages captured daily.
o Option to update any user's mail waiting pointers when a .REP packet
is received.
o User configuration allows:
o Capture of ONLY mail addressed to the user
o Capture of mail addessed to ALL may be toggled on or off
o Capture of mail 'YOU' wrote may be toggled on or off
o Setting of high/low message read pointers to the HIgh message number,
low message number, or any message number between these two values
o Toggle to receive or not to receive New bulletins
o Toggle to receive New file descriptions or not (Sysop must turn this
function on before the user's setting has any affect)
o Selecting conferences to scan for new mail.
o Maintains a user record for each caller at positions 154 - 178 in the
FeatherNet 'USERS' file.
o All the above listed user options
o Times in FnetMail
o Number of Downloaded Packets
o Number of Uploaded Packets
o Last Date and Time user entered FnetMail
o Automatically updates the FeatherNet high message read flags when
FnetMail is exited or the user logs off with the (G) command
o Support for DG or UG (D/L or U/L and Goodbye) commands from main menu
o Writes user's statistics (W)
o Allows changing graphics mode (M)
o Operator page (O) if activated by sysop (ESC Begins chat after Page)
o Chat function incorporated (F10 = Sysop Invoked Chat)
o ESC terminates chat
o User help file available (H)
o Swaps occupied dos memory out to EMS, XMS, or to Disk during all ZIP
functions, file transfers, and when a dos shell (F5) is executed
(if the Sysop desires)
o Allows QWK Packets to be uploaded.
o Allows REP packets to be Downloaded
FnetMail v4.2 - Page 3
┌────────────┐
│ DISCLAIMER │
└────────────┘
WARNING! I, Ron Pierce, cannot accept any responsibility for loss, personal
or commercial, incurred while operating FnetMail. You operate FnetMail at
your own risk.
I make no warranty of any kind, express or implied, including without
limitation, any warranties of merchantability and/or fitness for a
particular purpose. I shall not be liable for any damages, whether
direct, indirect, special or consequential arising from a failure of
this program to operate in the manner desired by the user. I shall
not be liable for any damage to data or property which may be caused
directly or indirectly by the use of this program.
IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES,
INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF
YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY
CLAIM BY ANY OTHER PARTY.
FnetMail v4.2 - Page 4
┌────────────┐
│Registration│
└────────────┘
FnetMail is Shareware. You may evaluate FnetMail for a period of
30 days after which you should register the program or discontinue
using it.
Many hours of programming, debugging and testing have gone into the
development of this program. Therefore the program is being
distributed in a reduced capacity demo mode. Once you decide
to register FnetMail you will be given a registration number which
will enable its full operation.
To register FnetMail and continue to promote the development of
affordable Shareware programs, fill out the Registration form at
the end of the documentation and send it with your payment to:
Ron Pierce
2022 Wall St.
Butte, MT. 59701
Payment must be in the form of check or postal money order drawn
in US funds.
When we have received and processed your registration, your registration
number will be available for download from the support BBS as a personal
and private download. Ensure you annotate on the registration form your
preference of (1) calling the support bbs for the registration number or
(2) having the registration number mailed to you.
Below are the limitations of the FnetMail Until Registered:
o UNREGISTERED notice displayed when door is entered.
o Maximum of 100 Messages may be captured per day
FnetMail v4.2 - Page 5
┌────────────┐
│Installation│
└────────────┘
First, create a subdirectory to hold your FNETMAIL program files, such
as C:\FNMAIL. Extract the files from the FNMAIL40.ZIP file file into
this new directory. Of course, you should have PKZIP and PKUNZIP or
any other archive utility you use available somewhere in your DOS PATH.
You should now find the following files in your FNETMAIL directory:
FNMAIL.EXE - The Main Program File
FNETMAIL.DOC - This Documentation File
FNMAIL.MEN - ASCII Menu File
FNMAILG.MEN - ANSI Menu File
FNMAIL.HLP - User "HELP" file for FnetMail
FNMAIL - Sample Door Batch File for FnetMail
HISTORY.TXT - List of modifications, bug fixes and new versions
MAILPROT.DAT - Sample File Transfer Protocol Data File
SAMPLE.CFG - Sample Configuration File
FILE_ID.DIZ - Description file for some bbs programs to use.
Copy the file "fnmail" into each NODE directory (this is the batch file
FeatherNet uses to run FnetMail).
FnetMail supports a LOCAL mode of operation. From the FnetMail directory
enter the command "fnmail fnmail.cfg /L". This assumes your configuration
file is named "fnmail.cfg".
During local mode or when the door is entered during a keyboard logon of
the bbs, packets are downloaded and uploaded by copying from and to the
available drives and directories on the computer.
FnetMail v4.2 - Page 6
┌─────────────┐
│Configuration│
└─────────────┘
Run the configuration program (FNMCFG.EXE). FNMCFG has built-in help
for each item being configured by pressing the F1 key. If you are
installing FnetMail for the first time, type FNMCFG FNMAIL.CFG from the
directory you have unzipped the FNMAIL40.ZIP file into.
┌─────────────────────────┐
│NetMail (Echo Mail) Notes│
└─────────────────────────┘
If you will be configuring FnetMail for echo mail importing and
exporting the following must be adhered to. Currently FnetMail does not
provide complete echo mail/ netmail support in that no "net status"
flags are used and that a configuration file is needed for each Host or
Node used. Users who need to use the netmail capabilities of FnetMail,
need to OPEN an FnetMail configuration which is specifically for Netmail
use. You will need to ensure they know which door to OPEN for the
affected network. When a user is in FnetMail in a NetMail confiuration
his or her personal mail pointers are never updated. Instead, FnetMail
maintains a file for each Host or Node ID which is named the Host ID
which in in the configuration file with a ".PTR" file extension.
Netmail message read pointers can be changed manually or by uploading
the .PTR file included in a packet.
┌─────────────────────────┐
│Door "Startup" Batch File│
└─────────────────────────┘
Edit the "fnmail" file in each NODE directory to match your NODE
path and save. For example if a NODE is in C:\FNET\NODE1 and the
FNETMAIL directory is C:\FNET\FNMAIL the "fnmail" file in the NODE
directory will be:
C:
CD\FNET\FNMAIL
FNMAIL FNMAIL.CFG << Use any ".cfg" file name you desire
C:
CD\FNET\NODE1
SR ; Have SR here *only* if NOT shelling to the door.
Since FnetMail supports multiple nodes, ensure you have a unique name
for the ".cfg" file for each node.
The format of the FNMAIL.CFG file follows. The actual number of lines is
determined by how many archivers you configure. Also any Netmail
configuration will have additional lines to contain the conference
translations.
FnetMail v4.2 - Page 7
┌──────────────────────┐
│Sample FNMAIL.CFG File│
└─────┬───────────┬────┘
┌─────────────┘ └─────────────┐
│ With 1 Netmail Conference Translation │
└───────────────────────────────────────┘
PROGINN ; BBS ID Code. Always 8 Characters.
Butte, MT ; Location of BBS
406-782-8132 ; BBS Telephone Number
The Programmer's Inn ; Name of bbs (as Registered)
Ron Pierce ; Sysop's Name
C:\FNET ; FeatherNet NODE Directory for this .cfg file
C:\FNET ; FeatherNet HOME Directory
J:\WORK ; Door "WORK" Directory (RAM disk recommended)
Y ; "Y" to swap to EMS, XMS, or Disk during SHELLs
; *** Leave blank - unused as of Version 2.3 ***
000.0000 ; Door Registration Number
Y ; "Y" to allow D/L of New FIles Descriptions
C:\FNET\MAILPROT.DAT ; File Transfer Protocol Data Dile PATH/Name
Y ; "Y" to update mail waiting pointers
SRWELC ; "WELCOME" file name (must be in bbs HOME dir)
LOGON.TXT ; "NEWS" file name (must be in bbs HOME dir)
BYE ; "GOODBYE" file name (must be in bbs HOME dir)
1 ; Enter the Node Number (1 - 99)
100 ; Max messages to capture for 300 baud callers
200 ; Max messages to capture for 1200 baud callers
300 ; Max messages to capture for 2400 baud callers
500 ; Max messages to capture for 4800 baud callers
3000 ; Max messages to capture for 9600 baud callers
3000 ; Max messages to capture for 14.4k baud callers
3 ; Number of archivers to allow
PkZIP and PkunZIP ; Name/Description of 1st Archiver
C:\PKUNZIP ; Path/Command to Un-Archive a mail reply (.REP)
C:\PKZIP -ex -a ; Path/Command to archive a mail packet (.QWK)
LHA (formerly LHARC) --/-----
C:\LHA e /
C:\LHA a /m /
ARJ - Excellent ---/------->>> Continue for number of archivers used
C:\ARJ e /
C:\ARJ a ------/-------
C:\SLMR ; Path to where the .REP packets are located
C:\SLMR ; Path to where the .QWK packets are located
The Programmer's Inn - Home of FeatherNet BBS ;Your Tag Line
My HUB ■ BigSkyNet ■ Wilderness coming straight at you! ;Host's Tag Line
&H3F8 ; Serial Port Address \\\See Serial Port \\\
4 ; IRQ Number to use \\\Configuration below\\\
Y ; "Y"enables crc-32 duplicate checking.
MYHOST ; Your HOST's Netmail ID
Joe SysOp ; Host's SysOp Name
1,3 ; Netmail Conf. Translations (Yours,Host's)
FnetMail v4.2 - Page 8
Serial Port Configuration
-------------------------
Version 2.3 of FnetMail introduces new serial port i/o routines
which eliminate the need for a "fossil" driver. These routines
come from Crescent Software's "PDQComm" library. PDQComm is
written by Dave Cleary. It features fast, error-free serial i/o
with serial ports 1-4.
************************************************************************
** You should have some knowledge of serial port addresses and irq's **
** before attempting to use non-standard irq's and port addresses. **
************************************************************************
If you are using a serial card or an internal modem with standard
IRQ's and port addresses with serial port #1 or #2 then all you
need to do to configure Fnetmail is to ensure you have two blank
lines in the .cfg file(s) following your "tag line".
However, if you choose to use non-standard irq's or port addresses
then you need to be able to specify which port adress(es) to use
and which irq(s) to use for the serial ports. There are some
restrictions you MUST be aware of to avoid conflicts with irq's.
Presently, irq's CANNOT be shared with another program or by another
copy of FnetMail running in another node. You MUST specify an UNUSED
irq #. This requires you to be able to use some utility software
to determine which irq's are presently being used on your system.
FnetMail will allow you to use irq numbers up to 7 on an XT class
machine or irq's up to 15 on an AT class machine (or greater).
A commonly used way of printing port addresses in manuals is
something like: 3F8H, 3E8H, 2E8H, etc. The way you MUST specify
port addresses in FnetMail's .cfg file is quite similar. Please
note the following regarding specifying a port address in the .cfg
file(s).
Serial port/modem manual: 3F8H
FnetMail's .cfg file: &H3F8
As you can see there is a difference in the way Fnetmail MUST receive
the port addresses in the .cfg file(s).
You specify the irq # simply by placing the # in the .cfg file(s).
So, to configure serial port 2 and irq 12 in a .cfg file the following
COULD be a valid entry on the two lines in your .cfg file immediately
after your "tag line".
&H2F8
12
FnetMail v4.2 - Page 9
WARNING
-------
The "WORK" directory MUST NOT be used to store any files. It must be
exclusively used by FnetMail. All files in this directory are routinely
deleted by FnetMail. For optimum speed it is recommended you use a RAM
disk as the "WORK" directory.
The following are commands available to users of the FnetMail door.
There are no Sysop specific commands.
Command Summary
---------------
(C) Configure Fnetmail for your needs. Select conferences to include
in your mail packet.
o Set Last Message Read Pointers.
o Select conferences to be scanned.
o Select archive format to compress/decompress your packets (for users)
o Toggle to receive mail addressed to you only.
o Toggle to receive mail addressed to 'ALL'.
o Toggle to receive mail you wrote.
o Toggle to receive any NEW bulletins.
o Toggle to receive a listing of NEW files (if sysop allows this)
o Reset Hi-Msg Read Pointers to a specified (msg) date
(D) Download a .QWK packet. If there is any new mail for you it will
be processed and prepared for downloading to your system.
(DG) Download a packet and immediately logoff.
(M) Toggle Graphics mode from ANSI Color to Pure ASCII or vice versa.
You should ascertain your terminal supports ANSI graphics before
using this command. If you toggle the graphics mode and see ' ['
or similar characters then use the command again to return to
normal ASCII text mode.
(O) Operator Page for chat.
(Q) Quit the door and return to FeatherNet
(U) Upload a .REP packet.
(R) Upload a .PTR file to reset your message read pointers.
(UG) Upload a packet and immediately logoff.
(W) Write your door statistics.
o Times in door.
o Packets Downloaded
o Packets Uploaded
o Last Date & Time in door.
o Archive Method currently selected by user
(?) Re-Displays the main menu file.
FnetMail v4.2 - Page 10
FnetMail - The Real Choice
(C) Copyright 1991, 1993 by Ron Pierce and FeatherNet Software
All Rights Reserved
Shareware Registration Form
┌───────┐
│Mail to│
┌────┴───────┴────┐
│ Ron Pierce │
│ 2022 Wall ST. │
│Butte, MT. 59701│
└─────────────────┘
┌───────────┐
│Support BBS│
┌─────────────────┘ └──────────────────┐
│ 406-782-8132 USR Dual Std HST /v.32 /v.42bis │
└────────────────────────────────────────────────┘
Make check or postal money order payable in US funds to Ron Pierce
Signature:_______________________________________________________
Name:_______________________________________________________
Address:_______________________________________________________
:_______________________________________________________
Phone:___________________
Now place the name of your bbs as it is spelled in the
configuration file for FNETMAIL. All characters used
in the confoguration file must be included.
BBS Name:_______________________________________________________
__ FnetMail Registration (US funds).......... @ $25.00 ea $ ______
(Checks or Money orders ONLY)
__ I desire the registration number to be mailed to me... $ ______
( $2.00 if outside USA )
I acquired FnetMail from: ( ) Friend ( ) Computer Club
( ) BBS:_______________________ ( ) Other:____________________________