CD Actual 27/CDROM27.iso/share/dos/netmail/netmail.doc

Text File | 1998-08-04 | 18.1 KB | 569 lines

NETMAIL PRO - Copyright -1998 Net-Tamer, INC. all rights reserved.

Direct inquiries to:
Net-Tamer, Inc.
9989 West Atlantic Blvd.
Coral Springs, FL 33071-6575
Phone: [phone]
Fax:   [phone]

----INTRODUCTION-------------------

****NetMail is a stand-alone automated POP3 and SMTP program. *****
It works only with a comm port connection (usually a modem) to a PPP
interface to a TCP-IP network. In other words, it can be instructed
to dial a telephone number, log in to an internet provider, get all
incoming email and optionally delete it. In addition, it can send
email via SMTP. The program has no facilites to read or reply to
email, however. It simply gets and sends. It is expected that users
would have another program for this. There is a fairly extensive
section on the format of outgoing messages. Please read this.

This is a demo program. It requires the user to press enter, after
the program starts, before it proceeds with dialing the telephone,
and doing it's business on the internet. It is intended only for
use for 30 days or less, so that someone can determine the program
suits their needs. It is anticiapted that most users of this program
would want it to be called from another program or a TSR timer. If
the press enter was not there, there would be no need to purchase
anything.

If you have need of a program like this, then you may purchase it
for $40.00 from Net-Tamer, Inc. (see details in the order.txt file).
The comercial version of this program is identical to this one,
EXCEPT that it has the User's name on it and there is no press enter
to continue pause.  This is accomplished by emailing the user a
registration code and not another copy of the program.

We also customize this software to suit corporate and governmental
users and have competively priced licensing arrangements. We do not
customize or make changes to the program for single users.

----RESTRICTIONS ON USE AND DISTRIBUTION-----

The files contained in this archive may be reproduced for distribution
on any shareware CD ROM, Diskette or other media, provided that the
files are distributed in the orginal archive and that the purchaser
of that CD ROM, diskette, or other media is not lead to believe that
they have purchased the rights to the program. All right's are retained
by Net-Tamer, Inc. and anyone wishing to purchase the rights to use
this product must do so through the company.


----SYSTEM REQUIREMENTS------
netmail.exe should run on any 8088/8086 compatible  PC (including
the orginal IBM PC) with a modem and 120k or so of free memory.
It should run from a floppy, ram drive, and/or hard drive, if
configured correctly. DOS 3.2 or higher, or a system supporting
a "DOS shell" is required. No other software (other than the
OS) is required, but the program may be called by another program
via a "shell and execute" routine, if desired. Embeded systems
usage may require changes in the agent.exe code. Let me know, if
you have a need for this.

-------PPP Dial Up Capasity-----------

The program assumes dynamic IP addressing, unless you use the
keyword STATIC in a login script (see the section on the script
language.) The program will login to a service which uses
CHAP(the RFC compliant kind) or PAP, without a script.
The program handles all login negotiations.


----SETUP - THE NETMAIL.INI FILE---------
You will need the following information:
1) The telephone number of an internet service provider.
2) A username and password for that service.
3)  The URL for a POP3 server and the username and password that
the program is to use for that server. You will also need
a SMTP server url. POP3 and SMTP need not be the same server,
nor do they have to be the server for the ISP on which the program
logged in.
4) You will need to know your modem comm port.

Also read the comments in the sample NEYMAIL.INI file. This goes
into great detail about INI variables and their usage. None of the
Keywords are case sensitive. The file must be in the same directory
from which netmail.exe is involked.

SHOWALL=
If given a value this outputs all information sent to the screen - including
the POP3 password. This is intended for debug purposes.

DELETEMAIL=
If this has a value of 1, then the program will delete
only old messages. If it has a value of 2 then it will delete ALL messages.
A value of 0 or absense of this setting tells the program not to delete
messages on the server. If the server does not support the last command,
and you have selected 1 as a value, then NO MAIL IS DELETED. Default is 0.


GETALLMAIL=
If this has a value then the program will get all messages
on the pop3 server, otherwise it will only get new messages, IF THE
SERVER SUPPORTS THE LAST COMMAND, this command was removed in the last
RFC, but is still supported by many servers. If you leave getallmail=0
and the server does not support the last command, then all mail is
retrieved.

GMTOFF=
Tells the program what the offset is from GMT (UCT) and the
user's time zone. Eastern Standard Time is +0400. To calculate the
value, you figure out what you have to do to your local time to make
it equal to GMT. +0400 would mean add 4 hours. Notice that this
Is 4 digits, with a Plus or Minus sign in front.


PORT=
Will accept a number from 1 to 4
or a hex address, irq
irq's 2 to 15 are okay in most circumstamces. Some WIN 95 users,
may have to change IRQ's for the modem in MyCompter, Defaults to 7 or less.

BAUD=
Valid 300, 1200, 2400, 4800, 9600, 19200, 38800, 57600, 115200
Most 14.4 modems should be set to 57600 and never below 19200.
Most 28.8 modems will need 115200

PHONE1=,PHONE2=,PHONE3=,PHONE4=
Telephone number to call
The # used deterimines dialing order. if a number is busy. Only #1
Is required to be used.

SCRIPT1=,SCRIPT2=,SCRIPT3=,SCRIPT4=
The name of a script file to use, if the service does not use CHAP or
PAP user verification. Default is no script. NO PATH is specified. A
script file is assumed to be in the same directory as the exe file.
THE SCRIPT NUMBER MUST MATCH THE TELEPHONE NUMBER, ie. SCRIPT1 is for
NUMBER1, etc.

MSGDIR=
The directory for BOTH writing email and checking for outgoing email.
Defaults to the current directory.

DIALSTART=
Dialing string start usually ATDT (The default)

INIT=
Modem Init String, Usually ATZ will get it.

DNS1=,DNS2=
IF a DNS address is NOT given, then the program will attempt to
use IPCP options 129 and 131 (0x81 and 0x83). Not all servers
support these options. If the FTP address is not given and a URL
is used, then DNS1= must be set, OR the service must support the
IPCP options in question. DNS1= is primary. DNS2=is secondary.

HANGUP=
Usually ATH0^M, the default. +++ is assumed.

GIVEUP=
Most attempts to dial with out terminating. Default is 2000

LUSERNAME=
The login username for PPP PAP or CHAP or the script login.

LPASSWORD=
Password for PAP or CHAP or the script login.

POP3=
The pop3 URL

SMTP=
The SMTP URL

BINDIR=
Path for uudecoded files. Net-Mail will do an automatic uudecode of
any uuencoded file which is included in a message and send it to this
path. IF THAT FILE NAME ALREADY EXISTS, IT WILL BE OVERWRITTEN. The
default directory is the current working directory.


----DEFAULTS--
DialStart=ATDT
GiveUp = 2000
INIT=ATZ
PORT=1
BAUD=19200
HangUp=ATH0

----Out Going Email Format------
The program looks for any file named MAIL*.OUT and assumes that
the ones that it finds are messages to send out.
The first line in a MAIL*.OUT FILE is always the To: address.
The first line not followed by a /CC or comma is the subject line.
No need to type To: or From: or Subject. The program knows what is what from
position.

[e-mail],
[e-mail]/CC
[e-mail]
How about the game?

This message would be to both fred and sally with a CC to chuck.
The subject is "How about the game?". Many, if not most messages
will have only a two line header. To: and subject. If you include
MIME information, it should follow the subject line immediately.
There should always be one blank line, after header information,
and before body of the message starts.

If Netmail Pro finds the literal text ##INCLUDE= in a line of text,
then it will uuencode and include the file named after the equal sign.
The statement "##INCLUDE=" must be uppercase and must be the only thing
on the line besides the filename. For example:
##INCLUDE=mypic.gif
would encode the file mypic.gif, which was in the current working directory.
You must use the complete path, if the file is not in the current directory,
for example:
##INCLUDE=c:\photos\strange\odd.gif

More than one file may be named, but on separate line. If the message
is received with netmail pro, then the file(s) will be decoded an placed
in the BINDIR= directory.


----Mass E-mail------

REGISTERED users may enter a file name in the To: field of a message
and then type the e-mail message in the normal manner.  If NetMail
finds a file name instead of an address, at the time of upload, then
it will send multiple copies of the e-mail that follows to everyone
listed in that file.  There will be ONLY one name per message and
there is no limit to the number of addresses.  This amounts to a
"blind carbon copy" for every one in the list. The file must be a
<CR><LF> delimited list of addresses only.  As below:

[e-mail]
[e-mail]
[e-mail]
[e-mail]

You may make this file with any text editor. There are a couple of "special
tricks", of course.  If for some reason you want multiple names in
the To: field, then put a comma after the e-mail address.  Like below:

[e-mail],
[e-mail]
[e-mail],
[e-mail]

This would be sent as two messages, with [e-mail] and
[e-mail] getting one copy and [e-mail]
and the prez getting the other.  In other words, the names per copy
stops, when the program no longer finds a comma at the end of the
address.  If you do wish to let someone know that this is a CC, the
do it this way:


[e-mail]/CC
[e-mail],
[e-mail],
[e-mail]

This would be sent as a single e-mail with nettamer getting the "to:"
copy and the others listed as CC's.  If you have questions about any
of this, please drop me a note.  Please do not use this feature to
"spam" a lot of folks.




------COMMAND LINE SWITCHES-------
/S
Do not send email on this trip, even if messages are found
to send.
/P
Do not GET email on this trip. Send only!


----ERROR NUMBERS-----
The program returns the following errors, which can be checked
by a calling program with the standard DOS error return test.

5 Illegal function call. This is a VERY generic error.
Check filenames and numbers for size, etc.

6 Overflow -A number exceeded 2,000,000,000.

7 or 9 Out of memory

11 Division By ZERO.

14 Out of string space (same as 7 or 9)

17 Cannot continue
A Dos error. Leave the program, re-boot and try again.

24 Device time out - Modem, or drive is not working.
25 Device fault          ""

51 Internal Error
Same as 17.

52 Bad file name
53 File NOT found
55 File already open

57 Device I/O error
Same as 24.

58 File already exists
59 Bad record- Usually a zero byte file.
61 Disk full - Delete something.
62 Input past end of file- Same as 59
63 Bad file number - Duplicate file name given.
64 Bad file name - Invalid dos file name in INI
67 To many files- Up the number FILES= in config.sys

68 Device unavailable
see 24

71 Disk NOT ready
72 Disk media error
75 File access error
71-75 are all user drive errors. Run scandisk.

76 Path NOT found.
Invalid path used in the ini file.

100 Netmail.ini file not found.
101 Neither an SMTP server nor a POP3 server was given in setup.
102 No login username.
103 No login Password.
104 No Telephone Number
105 Give Up number for dials exceeded.
106 Aborted by user.
107 PPP Loop Back. The program is likely to not be using a
    script and one is needed.
108 The Service provider requested that the program terminate.
109 Generic PPP error. Most likely an illegal code from the ISP.

110 The Username or Password were rejected in PPP.
112 Could Not Open Socket to the POP3 server.
113 Could Not Open Socket to the SMTP server.


--------------LOGIN SCRIPT LANGUAGE-----------------------
Please note that this is only how a user can script the "dialer"
part of the program for services with login prompts. In other
words, systems who do not use PAP or CHAP authentication.
There is no need in this language for WAIT CONNECT. The script
only starts after the modem has connected to another modem.
Keep the prompts that the program waits for short. As a general
rule, 4 characters is plenty. So use WAIT word:, instead of
WAIT Password:

The dialing scripts use two "macros" these are Password$ and
Username$. These send those pieces of information to
a service. Do not change those words, Net-Tamer knows what
the formation is and keys on this are to do certain things!

 Use:
 Blast PUSERNAME$
 Instead of:
 Blast USERNAME$

 if your service requires a P in front of your username. Most don't.
 Some services require something AFTER the Username, just edit the
 script this way:

 Blast Username$XXX

 The program will Replace Username$ with your username, add the
 XXX stuff and a <13>. Do not add <13> to Username$ and Password$
 in a script. The program adds these for you.

If you need to include an Ascii control character in a command,
just enter it like this <27>. (That would be the escape character.)
Net-Tamer DOES NOT ALLOW SPACES ON THE RIGHT OR LEFT HAND SIDE OF A
WAIT COMMAND. USE <32> to indicate a space. Spaces in the middle
of a statement are recognized. i.e. <32>NOW IS THE TIME<32> would
check for the text and a space on either side.

 Below is a modified script for an access site. Yours may or may not
 function in the same way. This is just a sample.

 WAIT gin:-OR-#600
 DELAY 10
 BLAST Username$
 WAIT word:
 DELAY 10
 BLAST Password$
 WAIT ocol:
 DELAY 10
 Blast PPP<13>
 DELAY 10
 PPP

 NOTE:
 The last PPP in the file is an internal command to the program to go into
 PPP mode. Nothing in the script file is executed past this point.


DELAY #-
This command pauses program execution for X tenths seconds
(decimals are not accepted). The incoming characters are still
checked.

example: DELAY 15 (wait 1.5 seconds)

WAIT TEXT-OR-TEXT-OR-TEXT -
OR
WAIT TEXT-OR-TEXT-OR-#12345

This command tells Net-Tamer to check the incoming characters from
service until the TEXT information is received. The -OR- is optional.
If you specify -OR- (max two) the program will resume
execution when it receives the characters matching any command
specified by TEXT. The maximum length of TEXT is 40 characters. You
may also say wait BILL-OR-#120. The number preceded by the #
character indicates the maximum length of time to wait. The number
is 1/10ths of a second.

If the time is up, before the program reaches the text, then the
script is abandoned. If a wait statement is not successful and you
have not specified a time, Net-Tamer abandons the script in 7 seconds
on a *.LOG file. <32> below represents a space character.

Example: WAIT MAIL><32>:-or-TO:<32><32>

Add /NOERROR, if you do not wish the script to end, if the text is
not found in the specified time.

BLAST TEXT<13>
This command tells the program to send the characters in text. If
the <13> command is included, the program sends ASCII 13 or enter.
Example:  Blast READ WAITING NS<13>

IF TEXT -
or
IF NOT TEXT

END IF -
Tells Net-Tamer to compare the current state of incoming data for
service with TEXT. If the TEXT condition is true, then Net-Tamer
proceeds otherwise, it skips to the end of the END IF.  The NOT
statement REVERSES this. The statements are executed only if the
TEXT is not the situation.

STATIC ###.###.###.### -

STATIC 206.14.56.13 in the script at any time before the PPP
command, would tell the program to assume that as your static IP address.
This is seldom needed. The most likely use would be a direct
serial port connection to network, and not over a modem.

PPP -
This ends the script file and tells the program to go to PPP
mode. YOU MUST INCLUDE THIS COMMAND AT THE END OF THE SCRIPT!


USERNAME$ and PASSWORD$ - These are instructions to the program
to insert your Username or Password in this spot in the script.
DO NOT INCLUDE A <13> with these commands. For example:

BLAST USERNAME$

Will send your username and a <13>.

You may also use these commands, even if other information is
needed in the login. For example, CRIS.COM uses USERNAME$PPP
to tell the service that you want a PPP connect. Netcom.com uses
#USERNAME$ for the same reason. Again, no <13> is required.

Sample  scripts:
-----DEMON-------
wait login:
BLAST Username$
wait Password:
BLAST Password$
wait Protocol:
BLAST PPP,nolqm,MRU=1500<13>
wait HELLO
PPP
-----------------

----CIS1-----
DELAY 30
Blast <3>
WAIT ame:
BLAST CIS<13>
WAIT ID:
BLAST Username$/go:pppconnect
WAIT word:
BLAST Password$
DELAY 50
PPP
----------------
----CIS2------
DELAY 30
Blast <13>
WAIT ID:
BLAST Username$/go:pppconnect
WAIT word:
BLAST Password$
DELAY 50
PPP
-----------------
----CRIS----
WAIT user:-OR-#600
BLAST Username$@PPP
WAIT word:
DELAY 10
BLAST Password$
PPP
-----------------
----EROLS--------
BLAST <13>
WAIT Login:
BLAST Username$
WAIT Password:
DELAY 10
BLAST Password$
WAIT PPP
PPP
----------------
----PACIFIER-----
WAIT  host:
BLAST ppp<13>
WAIT login:<32>
BLAST Username$
WAIT word:<32>
DELAY 10
BLAST Password$
PPP
-----------------
----PIPELINE-----
DELAY 40
BLAST @
ECHO @
DELAY 3
BLAST D
ECHO D
DELAY 3
BLAST <13>
WAIT in:
BLAST DELPHI<13>
WAIT Username:<32>
BLAST Username$
WAIT Password:<32>
BLAST Password$
Wait Hello
DELAY 5
PPP
-------------------
----AGATE-----
DELAY 10
BLAST <13>
DELAY 10
WAIT ogin:<32>-OR-#600
DELAY 10
BLAST Username$
WAIT  word:<32>
DELAY 10
BLAST Password$
WAIT  beginning....
PPP
------------------