|
Server : Apache/2.4.62 System : FreeBSD fbsdweb2.web.rcn.net 14.1-RELEASE FreeBSD 14.1-RELEASE releng/14.1-n267679-10e31f0946d8 GENERIC amd64 User : www ( 80) PHP Version : 8.3.8 Disable Function : NONE Directory : /domains/mguerinweb/cgi-bin/ |
Upload File : |
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<title>ASPMail 4.x Documentation</title>
</head>
<body bgcolor="#FFFFFF" text="#000000" link="#FF0000" vlink="#FF0000" alink="#FFFF00">
<table border="0" cellpadding="0" cellspacing="8" width="98%">
<tr>
<td bgcolor="#B9DFDA"><font face="Arial"><img src="SOLogo.gif" alt="ServerObjects Logo"
width="285" height="108" start="fileopen"><br>
</font></td>
</tr>
</table>
<p><font face="Arial"><br>
</font></p>
<h1 align="center"><font face="Arial">AspMail 4.x</font></h1>
<blockquote>
<blockquote>
<h3><font face="Arial">About AspMail</font></h3>
<p><font face="Arial">AspMail allows you to send mail using the standard SMTP protocol
from any program that can use ActiveX/OLE components. Features include:</font><ol>
<li><font face="Arial">SMTP (sending) Messages </font></li>
<li><font face="Arial">Multiple File Attachments </font></li>
<li><font face="Arial">File attachments support MIME and UUEncoding </font></li>
<li><font face="Arial">US Ascii and ISO-8859-1 character sets </font></li>
<li><font face="Arial">PGP</font></li>
<li><font face="Arial">Subject line encoding for 8bit message subjects</font></li>
<li><font face="Arial">Redundant SMTP servers (If the primary SMTP server is down, the
secondary server is used)</font></li>
<li><font face="Arial">Special Header Support (Standard X-Priority headers, MS Mail
(including Exchange) priority headers, Urgent header, ConfirmReading and ReturnReceipt
Headers)</font></li>
<li><font face="Arial">Multiple concurrent users (Tested with 15 concurrent connections)</font></li>
</ol>
<h3><font face="Arial"><b>AspMail Installation</b></font></h3>
<p><font face="Arial">To use this ASP component <i>move </i>the DLL into a subdirectory
(like \winnt\system32 for NT or \windows\system for Win95). Please use the version of
regsvr32 that is included with this component or the version that comes with Microsoft ASP
(they are the same version).</font></p>
<p><font face="Arial">To register the component on the system change to the directory
where you installed the DLL and type:</font></p>
<p><font face="Arial">regsvr32 smtpsvg.dll</font></p>
<p><font face="Arial">Make sure your TMP or TEMP environment variable is set up as a <a
href="#TempDirs">system variable</a> if you are running WinNT. You can use our <a
href="http://www.serverobjects.com/utils/tshoot.zip">troubleshooting</a> utility for a
simple way to configure this, or if you want to do it manually, you can follow these
instructions:</font><ol>
<li><font face="Arial">Start <em>Control Panel</em></font></li>
<li><font face="Arial">Double-click on the <em>System</em> icon</font></li>
<li><font face="Arial">Select the <em>Environment</em> tab</font></li>
<li><font face="Arial">View the system variables in the top pane on the form. Do not concern
yourself with User variables, the 2nd pane on the form.</font></li>
<li><font face="Arial">If a TMP or TEMP var does not exist </font><ul>
<li><font face="Arial">Single click one of the variables in the System list</font></li>
<li><font face="Arial">Move to the <em>Variable</em> field, select the existing text and
overwrite it with TMP. This will not replace the existing variable, it will add a new
variable named TMP.</font></li>
<li><font face="Arial">Move to the <em>Value</em> field. Enter the path of your temporary
directory.</font></li>
<li><font face="Arial">Click the <em>Set</em> button.</font></li>
<li><font face="Arial">Restart the server.</font></li>
</ul>
</li>
</ol>
<h3><font face="Arial">Simple Mail Example</font></h3>
<p><font face="Arial">Using the component is as simple as</font><ol>
<li><font face="Arial">Creating the object</font></li>
<li><font face="Arial">Setting a few properties</font></li>
<li><font face="Arial">Calling the SendMail method</font></li>
</ol>
<p><font face="Arial">The following code demonstrates how to use AspMail from VBScript. In
this example Joe from Joe’s Widgets wishes to send an email to John Smith. Joe’s
mail server is located at mailhost.localisp.net.</font></p>
<pre><font face="Arial">
Set Mailer = Server.CreateObject("SMTPsvg.Mailer")
Mailer.FromName = "Joe�s Widgets Corp."
Mailer.FromAddress= "[email protected]"
Mailer.RemoteHost = "mailhost.localisp.net"
Mailer.AddRecipient "John Smith", "[email protected]"
Mailer.Subject = "Great SMTP Product!"
Mailer.BodyText = "Dear Stephen" & VbCrLf & "Your widgets order has been processed!"
if Mailer.SendMail then
Response.Write "Mail sent..."
else
Response.Write "Mail send failure. Error was " & Mailer.Response
end if
</font></pre>
<p><font face="Arial">By testing the result of the SendMail method we can determine if the
mailing process was successful or not. </font></p>
<h3><font face="Arial">Form Handling</font></h3>
<p><font face="Arial">All or partial input for a message may come from a form. For
example, a form posted to the server with a request method of GET (i.e. <form
action="/scripts/AspMail.asp" method=get>) may provide the message
recipient’s email address, subject and message text as follows:</font></p>
<pre><font face="Arial">
Mailer.AddRecipient Request.QueryString("ToName"), Request.QueryString("ToAddress")
Mailer.Subject = Request.QueryString("Subject")
Mailer.BodyText = Request.QueryString("MsgBody")
</font></pre>
<p><font face="Arial">The form may also use the POST method (i.e. <form
action="/scripts/AspMail.asp" method=post>) in which case the code would look
as follows:</font></p>
<pre><font face="Arial">
Mailer.AddRecipient Request.Form("ToName"), Request.Form("ToAddress")
Mailer.Subject = Request.Form ("Subject")
Mailer.BodyText = Request.Form ("MsgBody")
</font></pre>
<p><font face="Arial">You can use any mixture of static and dynamic data in setting the
components properties as dictated by your needs. For example, you may wish to send the
mail to a single user. In this case you could modify the code to look something like this:</font></p>
<pre><font face="Arial">
Mailer.AddRecipient "John Smith", "[email protected]"
Mailer.Subject = Request.QueryString("Subject")
Mailer.BodyText = Request.QueryString("MsgBody")
</font></pre>
<h3><font face="Arial">Generic Form Handling</font></h3>
<p><font face="Arial">In some cases users may wish to use a number of different forms to
send email with the same block of code. ASP allows you to loop through each QueryString or
Form variable and append each one to string variable which is then assigned to the
BodyText property.</font></p>
<pre><font face="Arial">
strMsgHeader = "Form information follows" & vbCrLf
for each qryItem in Request.QueryString
strMsgInfo = strMsgInfo & qryItem & " - " & request.querystring(qryItem) & vbCrLf
next
strMsgFooter = vbCrLf & "End of form information"
Mailer.BodyText = strMsgHeader & strMsgInfo & strMsgFooter</font></pre>
<p><font face="Arial">To return form contents in the original form order
your code might be...</font></p>
<pre><font face="Arial">strMsgHeader = "Form Information Follows: " & vbCrLf
for i = 1 to Request.Form.Count
strMsgInfo = strMsgInfo & Request.Form.Key(i) & " - " & Request.Form.Item(i) & vbCrLf
next
strMsgFooter = vbCrLf & "End of form information"
Mailer.BodyText = strMsgHeader & strMsgInfo & strMsgFooter</font></pre>
<pre><font face="Arial">' Note this code only works for forms containing 128 or fewer field items</font></pre>
<h3><font face="Arial">
<br>
Setting Mail Priority
</font></h3>
<p><font face="Arial">There are a couple of headers that can be modified to set message
priority.</font></p>
<p><font face="Arial">The <i>Priority </i>property sets the message priority on a scale of
1 to 5. A priority of 1 means HIGH. A priority of 3 means NORMAL and a priority of 5 means
LOW. In addition to this you can also set the <i>Urgent</i> property if the message status
is urgent. The <i>Urgent </i>property is a true/false property.</font></p>
<h3><font face="Arial">How to Use the DateTime Property</font></h3>
<p><font face="Arial">The component creates a Date/Time value for the message based on the
calculated GMT time. The DateTime property was added to allow users to set a custom
date/time timezone. The following code demonstrates how to set the DateTime to US Central
Standard Time. By slightly altering the values underlined you can adjust this to work for your
timezone.</font></p>
<pre><font face="Arial">[set other Mailer properties]
Mailer.DateTime = WeekDayName(WeekDay(Date), true) & ", " & Day(Date) & " " & MonthName(Month(Date), true) & " " & Year(Date) & " " & FormatDateTime(Now, 4) & " <u>-0600 (CST)</u>"
Mailer.SendMail</font></pre>
<h3><font face="Arial">Notes About Creating the Mailer Object</font></h3>
<p><font face="Arial">You can create the mailer object at two different points in time:</font><ul>
<li><font face="Arial">Immediately before sending an email</font></li>
<li><font face="Arial">At the session scope and saved as a session object</font></li>
</ul>
<p><font face="Arial">You will have to decide when and where it is appropriate to create
the object based on your particular application. If you aren't sure which way to create
the object reference, or for typical usage, you should create the object immediately
before sending your email. Your code would look like this:</font></p>
<pre><font face="Arial">Set Mailer = Server.CreateObject("SMTPsvg.Mailer")
... [Set properties]
if Mailer.SendMail then ...</font></pre>
<p><font face="Arial">Creating these local references, as demonstrated above, allow you to
use the object on multiple application threads at the same time.</font></p>
<p><font face="Arial">To create an object reference at the session level, your code might
look something like this:</font></p>
<pre><font face="Arial">if Not IsObject (session("Mailer")) then
Set Mailer = Server.CreateObject("SMTPsvg.Mailer")
Set session("Mailer") = Mailer
else
Response.write "Cached session object reference being used<p>"
Set Mailer = session("Mailer")
end if</font></pre>
<h3><font face="Arial">Multiple Host Support</font></h3>
<p><font face="Arial">AspMail provides one host property to set up remote SMTP server
addresses. The <i>RemoteHost</i> property should be set to your primary and secondary
server’s address separated by semicolons. In the event that the <i>primary </i>server
is down, AspMail will attempt to use the secondary server. For example, </font></p>
<pre><font face="Arial">Mailer.RemoteHost = "mailhost.localisp.com;mailhost.anotherisp.com"</font></pre>
<h3><font face="Arial">PGP Support</font></h3>
<p><font face="Arial">AspMail now supports PGP. See the pgpmail.asp script for an example
of usage. ServerObjects Inc. is not responsible for PGP support. If you have questions
about PGP please contact the developers of <a href="http://www.pgp.com" target="_blank">PGP</a>.
PGPMail.asp is part of the AspMail evaluation zip file.</font></p>
<h3><font face="Arial">About purchasing AspMail</font></h3>
<ol>
<li><font face="Arial">The registration license fee covers only <i>one CPU per license.</i>
The fee <i>per CPU</i> is $49.95. We have priced the component at a level where we hope
that companies or individuals using multiple copies will respect the license agreement. </font></li>
<li><font face="Arial">Evaluation copies will expire. See the Expires property for details
on determining when your copy will expire.</font></li>
<li><font face="Arial">Attachments are enabled in the registered version but not in eval
copies.</font></li>
</ol>
<h3><font face="Arial">About Upgrades</font></h3>
<ol>
<li><font face="Arial">Users can upgrade for free for minor version changes. For example,
upgrades from version 1.00 to 1.99 are free. The upgrade from 2.x to 3.x <i>may </i>carry
a upgrade fee.</font></li>
<li><font face="Arial">The latest version of the components are always available at <a
href="http://www.serverobjects.com/products.htm">http://www.serverobjects.com/products.htm</a>.
If a fee is associated with obtaining the upgrade it will be noted on that page.</font></li>
</ol>
<h3><font face="Arial">Upgrade Instructions</font></h3>
<p><font face="Arial">To upgrade the component from a previous version please follow these
steps:</font><ol>
<li><font face="Arial">Stop all IIS related services such as Gopher, FTP and W3SVC.
Under IIS 4/5 this means you type "net stop iisadmin /y" from
a command prompt.</font></li>
<li><font face="Arial">Change to the directory where the component is located and type
"regsvr32 /u smtpsvg.dll"</font></li>
<li><font face="Arial">Move the new copy of smtpsvg.dll to the current directory and type
"regsvr32 smtpsvg.dll"</font></li>
<li><font face="Arial">If you were using AspMail 1.x, be sure and modify any code that uses
the Recipient, CC and BCC properties to use the new methods.</font></li>
<li><font face="Arial">Restart the necessary services or reboot your
server if you don't know which services to restart.</font></li>
</ol>
<h3><font face="Arial">Questions about AspMail</font></h3>
<p><font face="Arial">See <a href="http://www.serverobjects.com/TechComm.htm">http://www.serverobjects.com/TechComm.htm</a>
for general ASP support errors and issues.</font></p>
<p><font face="Arial">Download our <a href="http://www.serverobjects.com/utils/tshoot.zip">troubleshooting</a>
utility for help with configuration problems.</font></p>
<div align="left"><table border="1" cellpadding="7" cellspacing="1" width="90%">
<tr>
<td valign="top"><font face="Arial">How do I determine a cause of mail failure?</font>
<p><font face="Arial">or</font></p>
<p><font face="Arial">The message is sent but I never receive it.
What's wrong?</font></p>
<p><font face="Arial">or</font></p>
<p><font face="Arial">It's been working fine for 3 years and now it
appears that the messages are not getting delivered.</font></p>
</td>
<td valign="top"><font face="Arial">Note about FromAddress: You must specify a value for
the FromAddress property. Mail failure <em>will</em> occur without a FromAddress.</font><p><font
face="Arial">If the component can determine why the SendMail method failed, that
information will be stored in the Response property. So, for example, to print that
information to the clients browser you could add the following code:</font></p>
<pre><font face="Arial">if not Mailer.SendMail then
if Mailer.Response <> ''" then
strError = Mailer.Response
else
strError = "Unknown"
end if
Response.Write "Mail failure occured. Reason: " & strError
end if</font></pre>
<p><font face="Arial">Another fairly common problem is when a user reports that a specific
feature is not working. For example BCC's may seem to never reach their destination. A
valuable debugging tool is available with the SMTPLog feature. Assign a valid filename to
this property and the contents of the SMTP transaction that occurs during a SendMail call
will be recorded to this file. I</font>
<p><font face="Arial">f you find that the SMTP transaction occurs without error
then you should check elsewhere for the cause of mail delivery failure. Invariably the
user finds that the BCC address was invalid or that the SMTP server is
not relaying mail for the recipient domain. </font><p><font face="Arial"> The
SMTPLog feature allows you to verify if the transactions are complete and valid before
pursuing other avenues in determining the cause of failure. If you see
no errors in the SMTPLog then you need to check downstream of AspMail
starting with the SMTP server you are using to send, as well as the
recipient SMTP server. Anti-spam features on either machine may be
identifying your message as spam and may need to be reconfigured.
Check with the SMTP server administrators.</font><p><font face="Arial"><b>500
(503, 554 etc...) series errors are errors that the SMTP server
generates.</b> The exact meaning of the error depends upon your
configuration and SMTP server. Please consult your SMTP server
documentation for specifics on what these errors mean. Some of these
are covered below but these errors are being issued by your SMTP
server and AspMail is merely passing them on to you.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Checking the Mailer.Response property returns </font><p><font
face="Arial">"File Access Denied"</font></p>
<p><font face="Arial">or</font></p>
<p><font face="Arial">"Cannot create file"</font></p>
<p><font face="Arial">or</font></p>
<p><font face="Arial">"I have a TMP/TEMP var but it still isn't working"</font></p>
<p><font face="Arial">What's wrong?</font></td>
<td valign="top">
<ul>
<li><font face="Arial">You probably don't have a TMP or TEMP path set up, or
if you do, the IIS User (or any users authenticating under IIS) don't have read/write
access to the this directory. </font>
<ol>
<li><font face="Arial">Make sure the directory exists.</font></li>
<li><font face="Arial">Make sure you have FREE space on that
partition/directory</font></li>
<li><font face="Arial">Make sure the TMP or TEMP variable exists in your NT/Win95
environment. Under NT this must be a <em>system</em> environment variable, not a user
environment variable. If TShoot (see our tech support page) doesn't show the var it isn't
a system var. It <em>must</em> be a system var.</font></li>
</ol>
</li>
</ul>
<blockquote>
<p><font face="Arial"><a name="TempDirs">How to determine where your TMP/TEMP dir points
to</a></font></p>
<p><font face="Arial">AspMail versions 2.5.8 and higher have a method called GetTempPath.
To display where your TMP path is set to place the following code in an ASP script and run
it.</font></p>
<p><font face="Arial">Set Mailer = Server.CreateObject("SMTPsvg.Mailer")<br>
Response.Write Mailer.GetTempPath<br>
<br>
Your Win32 OS is designed to find your temporary path in the following manner:</font><ol>
<li><font face="Arial">Check for TMP.</font></li>
<li><font face="Arial">If it does not exist, check for TEMP.</font></li>
<li><font face="Arial">If it does not exist use the current directory. ASP tends to use the
\WinNT directory in this case.</font></li>
</ol>
</blockquote>
<ul>
<li><font face="Arial">The problem is the TMP path noted above
99% of the time. If you have double-checked that the <i>system
(not user) env </i>var exists</font>
<ul>
<li><font face="Arial">Make sure all users which need access to the component (the anonymous
IIS user and any other users which authenticate under IIS) have read/write access to this
path.</font></li>
<li><font face="Arial">Make sure that the drive where the TMP
path points to has free disk space</font></li>
<li><font face="Arial">Check to see if the user has a disk space
quota (under NT 4 this would only be available through 3rd
party quota software; this is now built in to Win2K)</font></li>
</ul>
</li>
</ul>
<p><font face="Arial">There are no other known causes for this error
so please check the above issues. If you fail to resolve the issue
then turn security failure auditing on using User Manager (NT only)
run the script for failure, and view the Event Log looking for an
indication of the reason it failed.</font>
</td>
</tr>
<tr>
<td valign="top"><font face="Arial">What would cause an "Operation timed out
error"?</font><p><font face="Arial">or</font></p>
<p><font face="Arial">"AspMail has been working great but suddenly I'm getting an
'Operation timed out' error.</font></td>
<td valign="top"><font face="Arial">Reasons for operation timed out include:</font><ol>
<li><font face="Arial">SMTP server is down, overloaded or simply not responding</font></li>
<li><font face="Arial">Firewall blocking port 25 between AspMail and SMTP server</font></li>
<li><font face="Arial">Packet filtering blocking port 25 between AspMail and SMTP server</font></li>
<li><font face="Arial">IP route is down</font></li>
<li><font face="Arial">Your Winsock configured DNS server is down</font></li>
</ol>
<p><font face="Arial">To check using another method run <br>
<br>
telnet [smtp hostname] 25<br>
<br>
from the IIS server where AspMail is installed. If telnet can see the <br>
SMTP server, then AspMail can see the server also.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">I can successfully send email from
one computer on our network but the same exact code is failing from
another machine on the network.</font></td>
<td valign="top"><font face="Arial">See the first question listed above
"How do I determine a cause of mail failure?" first. If
there are no communications problems the likely cause is that the
first machines IP is not blocked at the SMTP server whereas the 2nd
machines is. Consult with your SMTP server admin to see if anti-spam
features are in use that would prevent the 2nd IP address from sending
mail.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">I'm adding attachments but they aren't getting added
to the actual mailing. What's wrong?</font></td>
<td valign="top"><ol>
<li><font face="Arial">The path specified is not valid.</font></li>
<li><font face="Arial">The user the component is running under, typically the anonymous IIS
user, does not have rights to open the file. The anon IIS user, by default, cannot read
from networked drives so a path such as \\foobar\files\myfile.zip is not valid.</font></li>
<li><font face="Arial">The file is open by another process that's denying reads to the
file (another process you have running has the file open for writing
and is denying read access).</font></li>
</ol>
</td>
</tr>
<tr>
<td valign="top"><font face="Arial">How do I use AspMail with
Microsoft's Proxy Server?</font></td>
<td valign="top"><font face="Arial">If the machine running IIS and
AspMail is separated from your SMTP host by Microsoft's Proxy Server,
you may experience problems connecting to the SMTP server. AspMail
typically reports the error "Host not found" under this
configuration. As a logged-in user you may have no problems connecting
to the SMTP server. You must assign NT user credentials to the IIS
Admin service using the CREDTOOL command-line utility. This utility is
located in the directory \MSP\Clients\I386 on the Proxy Server
machine. Copy this utility to the machine running IIS and execute the
following command at an MS-DOS prompt specifying your own user
credentials:<br>
<br>
credtool -w -n inetinfo -c <username> <domain>
<password> </font>
<p><font face="Arial">This command assigns the credentials of a
specified NT user to the executable inetinfo.exe that hosts the IIS
Admin service. You also need to configure your IIS to recognize those
credentials. You do that by creating the file Wspcfg.ini and placing
it in the directory where inetinfo.exe is located. This is usually
found in the \winnt\system32\inetsrv directory.</font></p>
<p><font face="Arial">The following INI entry should be put in the
wspcfg.ini file:</font></p>
<p><font face="Arial">[Inetinfo]<br>
ForceCredentials=1</font></p>
<p><font face="Arial">After that, you must restart IIS by issuing the
commands:</font></p>
<p><font face="Arial">net stop iisadmin /y</font></p>
<p><font face="Arial">net start w3svc</font>
</td>
</tr>
<tr>
<td valign="top"><font face="Arial">I'm adding files from an array. All
but the last file are getting added, no matter how many files I add.</font></td>
<td valign="top"><font face="Arial">The last array element filename
probably has a chr(0) appended to the end. You'll have to delete the
final character of the filename before calling AddAttachment.</font>
</td>
</tr>
<tr>
<td valign="top"><font face="Arial">Is there a comprehensive list of errors that can be
returned by AspMail?</font></td>
<td valign="top"><font face="Arial">There are quite a few errors that can be returned. We
do not have a comprehensive list, primarily because these errors are returned from systems
AspMail is dependent on. The errors can come from your SMTP server (errors vary from
vendor to vendor), from WinSock errors (documented by Microsoft) and general OS errors
such as out of memory, disk read/write failures etc... (again documented by Microsoft).</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">"AddCC or AddBCC doesn't work" - is this a
bug with AspMail?</font><p><font face="Arial">or</font></p>
<p><font face="Arial">"I'm adding multiple recipients but only the first one is
getting delivered. What's wrong with AspMail?"</font></td>
<td valign="top"><font face="Arial">AddRecipient, AddCC and AddBCC work just as they
should. The problem is not with AspMail. It is likely that your SMTP server is rejecting
"foreign addresses" (see "no relay" question below). </font><p><font
face="Arial">To test whether AspMail is functioning properly use the SMTPLog property to
capture an SMTP session with multiple recipients. All the recipients you send to should
appear in the log as the SMTP envelope is sent. If they all appear then the problem is
with your SMTP server or an SMTP server down the stream (or your addresses are invalid).</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">The syntax</font><p><font face="Arial">Mailer.AddRecipient
= "name", "[email protected]"</font></p>
<p><font face="Arial">and</font></p>
<p><font face="Arial">Mailer.AddRecipient = "[email protected]"</font></p>
<p><font face="Arial">both return a VBScript error. What's wrong?</font></td>
<td valign="top"><font face="Arial">First off, remove the = sign. AddRecipient sounds like
and is actually a method, not a property. Also AddRecipient takes <em>two</em> parameters.
See AddRecipient in the methods listing for details.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">What's the syntax for adding multiple recipients?</font></td>
<td valign="top"><font face="Arial">Call AddRecipient, AddCC or AddBCC for each recipient.
There's no other way to add multiple recipients.</font><p><font face="Arial">Mailer.AddRecipient
"name1", "address1"<br>
Mailer.AddRecipient "name2", "address2"<br>
Mailer.AddBCC "name3", "address3"</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">How do I define the sensitivity of the message?</font></td>
<td valign="top"><font face="Arial">Outlook allows you to define a message sensitivity.
You can do this using as mail by adding the sensitivity header along with the proper text
for the sensitivity header. </font><p><font face="Arial">For example:</font></p>
<p><font face="Arial">Mailer.AddExtraHeader "Sensitivity: Company-Confidential"</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">How do I create a hyperlink in my message?</font></td>
<td valign="top"><font face="Arial">Set Mailer.ContentType = "text/html" and
include the hyperlink just like you would with html.</font><p><font face="Arial"><html><br>
<head><title>AspMail HyperLink</title><head><br>
<body><br>
<H3>AspMail HyperLink</H3><br>
<%<br>
Set Mailer = Server.CreateObject("SMTPsvg.Mailer")<br>
Mailer.FromName = "Status Update Report"<br>
Mailer.FromAddress = "[email protected]"<br>
Mailer.RemoteHost = "your.smtp.server"<br>
Mailer.AddRecipient "Your Recipient",
"[email protected]"<br>
Mailer.Subject = "AspMail Hyperlink"<br>
Mailer.ContentType = "text/html"<br>
Mailer.BodyText = "<html><body>Here's some <a
href=""http://www.serverobjects.com/"">info</a></body></html>"<br>
if Mailer.SendMail then<br>
Response.Write "Mail sent..."<br>
else<br>
Response.Write "Mail failure. Check mail host server name and tcp/ip
connection..."<br>
Response.Write "<p>" & Mailer.Response<br>
end if <br>
%></font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">How do I create a line-break in a message?</font></td>
<td valign="top"><font face="Arial">Under VBScript you can use the predefined constant
VBCrLf. Simply using a Chr(13) or a Chr(10) will not work --you must use both -- the
VBCrLf defined constant is the preferred method. A Carriage-return and line-feed character
are required to create a new line in the message. See the sample scripts for examples.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">How do I send multipart text and
html messages so that text viewers can read the message and HTML
enabled email clients can see and HTML version?</font></td>
<td valign="top"><font face="Arial">See the file multmail.asp that is
located inside the <a href="http://www.serverobjects.com/comp/aspmail.zip">AspMail
zip file</a>. Do not write ServerObjects for a copy. Download the zip
file for AspMail from the ServerObjects Web site if you need a copy.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">"Do I need to install SMTP on my server?"</font>
<p><font face="Arial">or</font></p>
<p><font face="Arial">"Is the Microsoft SMTP service
required?"</font></p>
</td>
<td valign="top"><font face="Arial">AspMail "knows" how to talk SMTP without any
external dependencies. You do not need to have Exchange or other products installed
(outside of the OS / TCP IP) for AspMail to work.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">How do I set the username and password to send mail?</font></td>
<td valign="top"><font face="Arial">Standard SMTP does not use a uid/pwd so it isn't
needed unless your SMTP requires user authentication. AspMail will
support user authentication in a future version but not currently do
so.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">What versions of PGP does AspMail support?</font></td>
<td valign="top"><font face="Arial">AspMail can support any encryption program that uses
command-line parameters. Using PGPPath and PGPParams you can specify input, output and
processing options. The current version of PGP (5.0) does not support command-line
parameters but the commercial PGP 4.x does as well as the freeware (non-commercial use)
PGP 2.6.2.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">How do I troubleshoot PGP usage?</font></td>
<td valign="top"><ol>
<li><font face="Arial">Check permissions on the pgp.exe. The anon IIS user (if you are
calling PGP from that user account) will need rights to read and execute files from the
PGP directory.</font></li>
<li><font face="Arial">Verify the path and params you are setting up to call
PGP.</font></li>
<li><font face="Arial">Verify that the PGP environment variables are
SYSTEM variables, not user environment variables. PGP may execute
but pause to prompt you for information it cannot find in the system
environment (you will probably never see these prompts... PGP for
all practical purposes will "hang" waiting for input it
can never receive.</font></li>
<li><font face="Arial">Use task manager to see if PGP is getting executed on the server.</font></li>
<li><font face="Arial">Check the Mailer.Response property <em>immediately after you call
GetBodyTextFromFile</em> to see if any O/S errors are getting returned by the call to PGP.</font></li>
<li><font face="Arial">If the error returned in the Response property indicates that file
access was denied, or that there was a file access timeout you need to find out...</font><ol>
<li><font face="Arial">If the file is getting created in the path specified.</font></li>
<li><font face="Arial">What has the file open. You can use <a
href="http://www.sysinternals.com/ntfilmon.htm">Filemon for Windows NT</a> and <a
href="http://www.sysinternals.com/nthandlex.htm">HandleEx</a> from Systems Internals to
help debug these issues.</font></li>
</ol>
</li>
</ol>
</td>
</tr>
<tr>
<td valign="top"><font face="Arial">My mail to AOL is bouncing. What am I doing wrong?</font></td>
<td valign="top"><font face="Arial">AOL will not accept anything other than a true address
in the "From:" heading. Just about every mail system out there, except AOL and
Compuserve, will accept the "No Mail Address" as the "From:" header.
(thanks to R.S for this info).<br>
</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">I want to create a mail service like HotMail or Yahoo
Mail. Do you have script code that would serve as a basis for this?</font></td>
<td valign="top"><font face="Arial">No. We only provide the AspMail and AspPOP3
components. You will have to either write the code yourself or find a consultant to do it
for you.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">I want to use AspMail from VB, FoxPro or [insert name
here].</font></td>
<td valign="top"><p align="left"><font face="Arial">The <a href="/products.htm">product
page</a> has several examples of usage from other languages. Be sure you are using AspMail
3.x since this version corrects a problem some users reported with previous versions.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Does AspMail support 8bit messages?</font><p><font
face="Arial">or</font></p>
<p><font face="Arial">"does AspMail support Japanese character set"</font></td>
<td valign="top"><font face="Arial">AspMail supports any 8 bit characters but please note:</font><ol>
<li><font face="Arial">Message bodies may be 8bit.</font></li>
<li><font face="Arial">Some SMTP servers drop the 8th bit in message headers including
Subject lines.</font></li>
<li><font face="Arial">You can encode message subjects using a new method named
EncodeHeader. See the <a href="#methods">methods</a> listing for details. Some character
sets don't work properly using this method, some do. We don't have any support for
character sets that don't work properly using this encoding.</font></li>
<li><font face="Arial">SHIFT-JIS reportedly works fine with the
EncodeHeader method.</font></li>
</ol>
</td>
</tr>
<tr>
<td valign="top"><font face="Arial">Can I repeatedly assign values to the BodyText
property? and "The message text keeps growing with each email I send."</font></td>
<td valign="top"><font face="Arial">Yes, the text will be appended to the message. Use
ClearBodyText if you need to clear the message text.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">How many recipients can I add to a message?</font></td>
<td valign="top"><font face="Arial">To Recipients: 65K; CC's: 65K; BCC's: 65K. But many
SMTP servers won't handle that many so we suggest you reduce the # per message sent.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Can AspMail be used to retrieve files off the client
computer?</font></td>
<td valign="top"><font face="Arial">AspMail is a server-side component. Retrieving files
from the client computer requires a client-side component that has access to the client's
local harddisk or a browser that supports file uploads in addition to a server side
component/extension that can accept those files. AspMail does <em>not </em>support this
function. You can however install a component that handles server side
uploads and use it in conjunction with AspMail. After handling file
uploads to the server they can then be attached using AddAttachment.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">How do I get Exchange to route Internet email to the
Net?</font></td>
<td valign="top"><font face="Arial">Exchange uses a service called the Internet Mail
Connector (IMC) to allow it to act as an SMTP server and transmit and receive mail via a
TCP/IP network. If you are not running the IMC you will not be able to send or receive
mail from the Internet by AspMail or any other means.</font><p><font face="Arial">Once you
have SMTP mail going with the IMC, no further action should be necessary to use AspMail.
(Thanks to Steve Crane for this information).</font></p>
<p><font face="Arial">Note: You must enable the rerouting on your Exchange's Internet Mail
Connector. Go in the properties of your Internet Mail Services (Exchange 5.0). Check the
reroute incoming SMTP mail option and add a route to your domain. Mail sent to
"yourdomain.com" should be accepted as "inbound". Thanks to S�bastien
Stormacq for this information.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">What options does Exchange allow to
prevent spamming or relaying through itself?</font></td>
<td valign="top"><font face="Arial">Exchange provides at least two
options:</font>
<p><font face="Arial">1) You can turn authentication on and prevent
non-authenticated connections from sending SMTP traffic -- But <u>the
problem</u> with this is that AspMail does not currently support
authentication.</font></p>
<p><font face="Arial">2) A better option, and one that works with
AspMail is to use Exchanges ability to block incoming SMTP traffic
from all IP addresses except the IP(s) where AspMail is located.</font></p>
<p><font face="Arial">See your Exchange administrator for details on
how to do this.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">How do I upgrade to the latest version?</font></td>
<td valign="top"><font face="Arial">Download the latest "eval" version and
follow the upgrade directions provided earlier in this document.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Can I redistribute this control with my products?</font></td>
<td valign="top"><font face="Arial">The license agreement does <u><i> not</i></u> permit redistribution
of AspMail.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">The SMTP server is reporting back a "no
relay" error. What's wrong?</font>
<p><font face="Arial">also "foreign traffic not accepted"
and other similar messages...</font></td>
<td valign="top"><font face="Arial">The SMTP server is looking at your FromAddress and
determining that it doesn't know who you are. Some SMTP servers are configured to disallow
the "relaying" or transfer of mail originating from addresses outside of its own
domain. The only solution is to provide a FromAddress that's local to the SMTP server's
domain or get the operator of the SMTP server to allow the FromAddress you are using. This
setting is commonly used by ISP's to prevent spammers from using their resources.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">What does the error "socket not
connected" mean?</font></td>
<td valign="top"><font face="Arial">This error occurs when the remote
SMTP server abnormally closes the Winsock connection that AspMail
established. The reasons may include an SMTP server that is not
functioning properly (misconfigured or failing). In some cases this
error can be generated by a Winsock layer that is failing. To test
your local server, reboot the server and try to run the script again.
If the error continues to occur it is likely that some sort of
configuration problem or failure is occurring on the SMTP server.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">What does error "554 No valid recipients"
mean?</font><p><font face="Arial">or</font></p>
<p><font face="Arial">"503 Need RCPT (recipient)"</font></td>
<td valign="top"><font face="Arial">500 series errors are errors that the SMTP server
generates. This error means that the message recipients given are either not given (you
didn't use AddRecipient, AddCC or AddBCC) OR they are not valid recipients for this SMTP
server. This is often associated with the "no relay" issued covered above. The
SMTP server rejects the given recipients and then issues this error. This typically
happens when you have IgnoreInvalidRecipients set to true. You can verify that the SMTP
server is ignoring your recipients due to the "no relay" issue or for any other
reason by using the SMTPLog property to generate a log and then look at the rejection
errors in the log file.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Some of our emails are getting equal signs at the end
of lines in some messages. Why?<br>
</font></td>
<td valign="top"><font face="Arial">AspMail can encode high characters using a scheme
where the = sign <br>
indicates a character to be decoded follow by the hex string value of <br>
the character to be encoded. This system of course assumes that the client can decode
these characters (which most can). This is called quoted-printable encoding. The default
for AspMail is not to use QP encoding. Things that trigger automatic QP encoding:</font><ol>
<li><font face="Arial">High characters - characters with the following ordinal values
0..31,61,128..255</font></li>
<li><font face="Arial">Long lines of a message body (>255). You can turn wordwrap on to fix this
case</font></li>
</ol>
<p><font face="Arial">Most clients are capable of handling QP encoding. If your client is
not capable then you should upgrade your client or you must work within the above
limitations to prevent the QP encoding from occuring.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Sometimes I get multiple (duplicate)
messages sent when I call
SendMail. Why?</font></td>
<td valign="top"><font face="Arial">AspMail has an internal routine to look for errors. If
an error occurs at any point (even after the text of the message has been sent to the SMTP
server) AspMail will go ahead and attempt to send it a second time in an attempt to
complete the SMTP transaction without any errors <em>if, and only if, you have multiple
RemoteHosts set up in the RemoteHost property.</em> The AspMail routine will only attempt
1 retry in this case.</font><p><font face="Arial">If you only have one host name setup
then the problem will be found in </font><p><font face="Arial"> #1)
you are calling SendMail more than once or </font><p><font face="Arial"> #2) you are
not handling cases where the user does a double/triple-click on his/her browser.</font><p><font face="Arial">#3)
Your smtp server is erroring out before the message transfer is
complete in which case AspMail detects the error and resends till it
gets a successful send (<i>this can only occur with AspQMail</i>) </font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">How do I specify the Return-Path
header in a message?</font></td>
<td valign="top"><font face="Arial">Mailer.AddExtraHeader
"Return-Path: your_route-addr"</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">With AspMail can I have "required fields" on
my HTML forms or other form processing functionality. Can AspMail change the order I get
form field data back?</font></td>
<td valign="top"><ol>
<li><font face="Arial">Microsoft's ASP, not AspMail controls form data order. If you are
looping through the form data in ASP order it probably won't be the original form order.
You'll have to hard code field names to force the data back in a specific or original form
order.</font></li>
<li><font face="Arial">Required fields are a function of HTML and client side scripting, not
AspMail. If you used a CGI library in the past that handled those issues for you, it what
only because they delved into areas outside of SMTP/Mail. AspMail's only function in life
is to send mail. It does not handle client side HTML/scripting.</font></li>
</ol>
</td>
</tr>
<tr>
<td valign="top"><font face="Arial">"Can someone use AspMail to send SPAM through our
system?"</font></td>
<td valign="top"><font face="Arial">AspMail does not accept SMTP connections and therefore
cannot be used to "relay" SMTP traffic. AspMail can generate new SMTP message traffic but
only if you provide a script page to generate it. Therefore it is under the Web operator's
control.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">I am getting blank emails</font>
<p><font face="Arial">OR</font></p>
<p><font face="Arial">We are getting blank emails even when we aren't
calling/using AspMail</font></td>
<td valign="top"><font face="Arial">One of your scripts which calls
AspMail is getting called</font>
<ol>
<li><font face="Arial">By someone using a Web browser or </font></li>
<li><font face="Arial">By a stats package like WebTrends or </font></li>
<li><font face="Arial">By a Web Robot which is parsing your site.</font></li>
</ol>
<p><font face="Arial">AspMail is a component and it doesn't have the
"brains" to generate messages on it's own cognizance.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">WebTrends is generating multiple messages when its
schedule runs.</font></td>
<td valign="top"><font face="Arial">WebTrends is probably parsing your Web tree and
calling the HTML and ASP scripts to determine what they are. In the process the ASP
scripts you have that call AspMail may be getting called at the same time. Your options
are:</font><ol>
<li><font face="Arial">You are going to have to configure WebTrends not to call these
scripts. - or -</font></li>
<li><font face="Arial">Modify your scripts so that if WebTrends is calling them they don't
fire off a message. - or -</font></li>
<li><font face="Arial">Contact WebTrends for another solution. AspMail can't control
WebTrends.</font></li>
</ol>
</td>
</tr>
<tr>
<td valign="top"><font face="Arial">My component is registered. Should the Expires
property return a date?</font></td>
<td valign="top"><font face="Arial">No. Registered versions return N/A for an expiration
date. The registration process (per the instructions you received) should be run on the
server.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">I'm mailing a large number of people. At some point in
the mailing it fails. Can you give me any tips?</font></td>
<td valign="top"><font face="Arial">The first tip is to use the SMTPLog property to write
an SMTP log to disk and see what the point of failure is based on the log. The SMTP server
is probably rejecting your message for some reason and the cause is typically determinable
from the log. </font><p><font face="Arial">Secondly, some SMTP servers only accept mail
for locally known recipients. The SMTP server may be rejecting your message since it is
being addressed to recipients outside the domain of that SMTP server. This is unusual but
could possibly be the problem you are running into.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Using the SMTPLog property I got an error #132. How
can I look up numeric errors returned by AspMail to find out what it means?</font></td>
<td valign="top"><font face="Arial"><a
href="http://www.serverobjects.com/utils/tshoot.zip">TShoot</a> under the file menu has a
Win32 error code lookup form.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">What are some of the issues that affect the speed of
the mailing?</font></td>
<td valign="top"><font face="Arial">A small message should take 3-4 seconds to send if the
server is local and all other conditions are normal. The following list are some items
that can affect transfer speed.</font><ol>
<li><font face="Arial">The slower the TCP connection the longer the mailing will take.
Typically a local server is much faster than a remote server. If you are losing packets
between your server and the SMTP server you can expect longer times due to this packet
loss.</font></li>
<li><font face="Arial">The size of the mailing. The larger the message the longer the
message transfer will take to send.</font></li>
<li><font face="Arial">CPU utilization: If your CPU is experiencing heavy usage you can
expect it to take longer to transfer mail.</font></li>
<li><font face="Arial">SMTP server utilization: If your SMTP server is experiencing heavy
traffic response times from the server are going to take longer thus increasing the time
it takes to send a message.</font></li>
</ol>
<p><font face="Arial">One thing we've found is that by changing the RemoteHost name from a
hostname to an IP address can cut 3 or 4 seconds off some messages. Even if the RemoteHost
name is set to the local server's name, we've found some messages waiting for the hostname
lookup. Just change the address to an IP and you may see an increase in the speed.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Is there a limit to the length of email addresses.</font></td>
<td valign="top"><font face="Arial">AspMail support longer email addresses than anyone has
so there are no practical limits. If your email is not being delivered see the previous
questions for pointers on how to troubleshoot mail failures.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Does the 2 CPU license cover two servers or two
processors?</font></td>
<td valign="top"><font face="Arial">In accordance with the license agreement, the 2 CPU
license would cover either 2 single CPU servers or 1 dual CPU server. With this pricing
model, AspMail is far more inexpensive than any "competing" products.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">The message body occassionally gets
truncated.</font></td>
<td valign="top"><font face="Arial">You are likely low on TEMP path
harddrive space. </font></td>
</tr>
</table>
</div><h3><font face="Arial">Technical Support</font></h3>
<p><font face="Arial">If you require technical support please see our tech support page at
<a href="http://www.serverobjects.com/support.htm">http://www.serverobjects.com/support.htm</a>
</font></p>
<h3><font face="Arial">AspMail Properties</font></h3>
<table border="1" cellpadding="7" cellspacing="1" width="90%">
<tr>
<td><font face="Arial"><strong>Property</strong></font></td>
<td><font face="Arial"><strong>Description</strong></font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">BodyText</font></td>
<td valign="top"><font face="Arial">The message body text. To clear the text once you have
set it use the ClearBodyText Method.</font><p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.BodyText = "Your order for 15 widgets has been
processed"</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">CharSet</font></td>
<td valign="top"><font face="Arial">The character set. By default the char set is US Ascii</font><p><font
face="Arial">Valid values:</font><ul>
<li><font face="Arial">1 = US </font><font face="Arial">ASCII</font></li>
<li><font face="Arial">2 = ISO-8859-1</font></li>
</ul>
<p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.CharSet = 2</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">ConfirmRead</font></td>
<td valign="top"><font face="Arial">The ConfirmReading flag. If this is set to true AND
the recipients email program supports</font><p><font face="Arial">this feature (and it is
enabled) the recipients email program will send a notice back to the FromAddress
confirming that this email has been read.</font></p>
<p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.ConfirmRead = true</font></td>
</tr>
<tr>
<td><font face="Arial">ContentType</font></td>
<td><font face="Arial">The ContentType property allows you to set the ContentType header
of the message's BodyText. If, for example, you wanted to send HTML as the messages's
body, you could set ContentType = "text/html" and EMail programs that support
HTML content could properly display the HTML text.</font><p><font face="Arial">Note: The
ContentType property is ignored if you have file attachments.</font></p>
<p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.ContentType = "text/html"</font></td>
</tr>
<tr>
<td><font face="Arial">CustomCharSet</font></td>
<td><font face="Arial">If you wish to use a character set besides the included types you
can set CustomCharSet to a character set string.</font><p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.CustomCharSet = "ISO-2022" or<br>
Mailer.CustomCharSet = "big5"</font></td>
</tr>
<tr>
<td><font face="Arial">DateTime</font></td>
<td><font face="Arial">AspMail will, by default, create a Date/Time header for your local
system using GMT. If you would like to override the date/time calculation set the DateTime
property to a valid date/time string in the format defined by RFC 822 & RFC 1123.</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.DateTime = "Fri, 02 May 1997 10:53:49 -0500"</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Encoding</font></td>
<td valign="top"><font face="Arial">The encoding type for attachments. The default setting
is MIME.</font><p><font face="Arial">Valid values:</font><ul>
<li><font face="Arial">1 = UUEncoded</font></li>
<li><font face="Arial">2 = MIME</font></li>
</ul>
<p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.Encoding = 1</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Expires</font></td>
<td valign="top"><font face="Arial">If the component is an eval version the expires
property will return the date that the component quits functioning.</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Response.Write "Component Expires: " & Mailer.Expires</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">FromName</font></td>
<td valign="top"><font face="Arial">The message originator’s name.</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.FromName = "Joe’s Widget Shop"</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">FromAddress</font></td>
<td valign="top"><font face="Arial">The message originator’s email address.</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.FromAddress = "[email protected]"</font></td>
</tr>
<tr>
<td><font face="Arial">IgnoreMalformedAddress</font></td>
<td><font face="Arial">Defaults to false. When false AspMail will check for '@' in the
email address for calls to AddRecipient, AddCC and AddBCC. An error would be returned in
the Response property. When this property is set to true AspMail will not perform any
address syntax validation. If you are using AspMail to send a message through an SMS
gateway or fax system you may need to set this property to true.</font></td>
</tr>
<tr>
<td><font face="Arial">IgnoreRecipientErrors</font></td>
<td><font face="Arial">Defaults to true. If true AspMail will ignore error messages
returned by the SMTP server for invalid addresses. This is useful when a mailing is
addressed to a number of recipients.</font></td>
</tr>
<tr>
<td><font face="Arial">Live</font></td>
<td><font face="Arial">Live allows you to test the component without an SMTP server. If
Live is set to false then the NET SEND message will be executed with the FromName property
being used as the recipient of the message. Only the subject is sent to the recipient.</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.FromName = "ASPProgrammer"<br>
Mailer.Live = false</font></td>
</tr>
<tr>
<td><font face="Arial">Organization</font></td>
<td><font face="Arial">Sets the Organization header in the message.</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.Organization = "Your Company Name"</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">PGPPath</font></td>
<td valign="top"><font face="Arial">The path where PGP is located.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">PGPParams</font></td>
<td valign="top"><font face="Arial">Parameters that PGP will use to process message.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Priority</font></td>
<td valign="top"><font face="Arial">Sets the message priority. Priorities are 1-5 and are
reflected in the X-Priority</font><p><font face="Arial">Valid values:</font><ul>
<li><font face="Arial">1 – High</font></li>
<li><font face="Arial">3 – Normal</font></li>
<li><font face="Arial">5 – Low</font></li>
</ul>
<p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.Priority = 1</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">RemoteHost</font></td>
<td valign="top"><font face="Arial">The remote SMTP host that the message will be sent
through. This is typically an SMTP server located at your local ISP or it could be an
internal SMTP server on your companies premises. Up to 3 server addresses can be
specified, separated by a semicolon. If the primary server is down the component will
attempt to send the mail using the secondary server and so on.</font>
<p><font face="Arial">If your RemoteHost uses another port besides 25
then append a colon and port number to the RemoteHost value.</font></p>
<p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.RemoteHost = "mailhost.myisp.net" or</font></p>
<p><font face="Arial">Mailer.RemoteHost = "mailhost.myisp.net;mailhost.myotherisp.net"
or</font>
<p><font face="Arial">Mailer.RemoteHost = "mailhost.myisp.net:160"</font></p>
</td>
</tr>
<tr>
<td><font face="Arial">ReplyTo</font></td>
<td><font face="Arial">The ReplyTo property allows you to specify a different email
address that replies should be sent to. By default mail programs should use the Reply-To:
header for responses if this header is specified.</font></td>
</tr>
<tr>
<td><font face="Arial">Response</font></td>
<td><font face="Arial">The Response property returns any error messages that may occur.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">ReturnReceipt</font></td>
<td valign="top"><font face="Arial">The ReturnReceipt flag. If this is set to true AND the
recipients SMTP server supports</font><p><font face="Arial">this feature (and it is
enabled) the recipients SMTP server will send a notice back to the FromAddress confirming
that this email has been delivered.</font></p>
<p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.ReturnReceipt = false</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">SMTPLog</font></td>
<td valign="top"><font face="Arial">If you need to debug the session give a log file name
here. Make sure the IUSR_XYZ IIS user has security that allows the component to write to
this file. Warning: Do not use this setting in situations where multiple users can access
this component at the same time. This is for single user debugging ONLY!</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.SMTPLog = "c:\smtplog.txt"</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Subject</font></td>
<td valign="top"><font face="Arial">The message subject.</font><p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.Subject = "Stock split announced!"</font></td>
</tr>
<tr>
<td><font face="Arial">SuppressMsgBody</font></td>
<td><font face="Arial">The SuppressMsgBody property is true by default and is used in
conjunction with the SMTPLog property. When SMTPLog is set to a file and SuppressMsgBody is
true the log file receives a copy of the message text. If SuppressMsgBody is false the
message text is not sent to the log.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">TimeOut</font></td>
<td valign="top"><font face="Arial">Timeout is the maximum time that AspMail should wait
for a response from the remote server. The default is 30 seconds.</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.Timeout = 15</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">Urgent</font></td>
<td valign="top"><font face="Arial">The urgent flag sets the X-Urgent header in the
outgoing message. Not all mail readers support this flag.</font><p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.Urgent = true</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">UseMSMailHeaders </font></td>
<td valign="top"><font face="Arial">MS-Mail priority headers, by default, are sent in
addition to the standard SMTP priority headers. You can turn MS-Mail headers off with this
property</font><p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.UseMSMailHeaders = false</font></td>
</tr>
<tr>
<td><font face="Arial">Version</font></td>
<td><font face="Arial">Gets the internal component version number.</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Response.Write "Component Version: " & Mailer.Version</font></td>
</tr>
<tr>
<td><font face="Arial">WordWrap</font></td>
<td><font face="Arial">The WordWrap property is off by default. Setting WordWrap to true
causes the message body to wordwrap at the position specified by the WordWrapLen property.</font></td>
</tr>
<tr>
<td><font face="Arial">WordWrapLen</font></td>
<td><font face="Arial">The WordWrapLen property is set to 70 by default. You can modify
the position that wordwrap occurs by changing this value.</font></td>
</tr>
</table>
<h3><font face="Arial"><a name="methods">AspMail Component Methods</a></font></h3>
<table border="1" cellpadding="7" cellspacing="1" width="90%">
<tr>
<td valign="top"><font face="Arial"><b>Method</b></font></td>
<td valign="top"><font face="Arial"><b>Parameters</b></font></td>
<td valign="top"><font face="Arial"><b>Return Value</b></font></td>
<td valign="top"><font face="Arial"><b>Description</b></font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">SendMail</font></td>
<td valign="top"><font face="Arial">None</font></td>
<td valign="top"><font face="Arial">True or False</font><p><font face="Arial">Example:</font></p>
<p><font face="Arial">if Mailer.SendMail then</font></p>
<p><font face="Arial">Response.Write "Mail sent..."</font></p>
<p><font face="Arial">else</font></p>
<p><font face="Arial">Response.Write "Mail failure. Check mail host server name and
tcp/ip connection..."</font></p>
<p><font face="Arial">end if</font></td>
<td valign="top"><font face="Arial">The SendMail method attempts to send the email. </font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">AddRecipient</font></td>
<td valign="top"><font face="Arial">Mailer.AddRecipient "Jay Jones",
"[email protected]"</font></td>
<td valign="top"><font face="Arial">True/False based upon success or failure.</font></td>
<td valign="top"><font face="Arial">Adds a new recipient, as shown in the message's <em>To:</em>
list.</font></td>
</tr>
<tr>
<td><font face="Arial">ClearRecipients</font></td>
<td><font face="Arial">None</font></td>
<td><font face="Arial">None</font></td>
<td><font face="Arial">Clears any recipients assigned to the <em>To</em> list.</font></td>
</tr>
<tr>
<td><font face="Arial">AddCC</font></td>
<td><font face="Arial">Mailer.AddCC "Jay Jones", "[email protected]"</font></td>
<td><font face="Arial">True/False based upon success or failure.</font></td>
<td><font face="Arial">Adds a new recipient, as shown in the message's <em>CC</em> list.</font></td>
</tr>
<tr>
<td><font face="Arial">ClearCCs</font></td>
<td><font face="Arial">None</font></td>
<td><font face="Arial">None</font></td>
<td><font face="Arial">Clears any recipients assigned to the <em>CC</em> list.</font></td>
</tr>
<tr>
<td><font face="Arial">AddBCC</font></td>
<td><font face="Arial">Mailer.AddBCC "Jay Jones", "[email protected]"</font></td>
<td><font face="Arial">True/False based upon success or failure.</font></td>
<td><font face="Arial">Adds a new Blind Carbon Copy recipient. <em>BCC</em> recipients are
<em>not</em> shown in any message recipient list.</font></td>
</tr>
<tr>
<td><font face="Arial">ClearBCCs</font></td>
<td><font face="Arial">None</font></td>
<td><font face="Arial">None</font></td>
<td><font face="Arial">Clears any recipients assigned to the <em>BCC</em> list.</font></td>
</tr>
<tr>
<td><font face="Arial">ClearAllRecipients</font></td>
<td><font face="Arial">None</font></td>
<td><font face="Arial">None</font></td>
<td><font face="Arial">Clears <em>all</em> recipients assigned to the <em>To</em>, <em>CC</em>
and <em>BCC</em> lists.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">AddAttachment</font></td>
<td valign="top"><font face="Arial">Filename to attach to message.</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.AddAttachment "d:\shipping\proddsk1.zip"</font></td>
<td valign="top"><font face="Arial">N/A</font></td>
<td valign="top"><font face="Arial">Adds attachments to current mailing. You must use an
explicit path to attach files. UNC's are not legal.</font><p><font face="Arial">Make sure that the IUSR_XYZ IIS
user, or the authenticated user has security rights that allow the component to read the
necessary files! Note: Attachments may not be supported in some eval versions.</font></td>
</tr>
<tr>
<td><font face="Arial">ClearAttachments</font></td>
<td><font face="Arial">None</font></td>
<td><font face="Arial">None</font></td>
<td><font face="Arial">Clears any attachments that were previously set.</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.ClearAttachments</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">ClearBodyText</font></td>
<td valign="top"><font face="Arial">None</font></td>
<td valign="top"><font face="Arial">None</font></td>
<td valign="top"><font face="Arial">Clears any text assigned to the message’s body
which may have been set previously by using the <i>BodyText</i> property.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">ClearExtraHeaders</font></td>
<td valign="top"><font face="Arial">None</font></td>
<td valign="top"><font face="Arial">None</font></td>
<td valign="top"><font face="Arial">Clears any X-Headers that were set by use of
AddExtraHeader.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">AddExtraHeader</font></td>
<td valign="top"><font face="Arial">A string value that forms a proper SMTP X-Header</font><p><font
face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.AddExtraHeader<br>
("X-HeaderName: XHdrValue")</font></td>
<td valign="top"><font face="Arial">True or false. Returns true if X-Header was added.</font></td>
<td valign="top"><font face="Arial">Adds extra X-Headers to the mail envelope.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">GetBodyTextFromFile</font></td>
<td valign="top"><font face="Arial">See pgpmail.asp for more information.</font></td>
<td valign="top"><font face="Arial">See pgpmail.asp for more information.</font></td>
<td valign="top"><font face="Arial">Loads message's body text from a file. Optionally runs
PGP on the message text.</font><p><font face="Arial">See pgpmail.asp for more information.</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">EncodeHeader</font></td>
<td valign="top"><font face="Arial">strValue</font></td>
<td valign="top"><font face="Arial">strValue encoded as String</font></td>
<td valign="top"><font face="Arial">Encodes a string in RFC1522 format to provide support
for 8bit mail headers such as 8bit subject headers.</font><p><font face="Arial">Example:</font></p>
<p><font face="Arial">Mailer.Subject = Mailer.EncodeHeader("R�sponse de Service �
la client�le")</font></td>
</tr>
<tr>
<td valign="top"><font face="Arial">GetTempPath</font></td>
<td valign="top"><font face="Arial">N/A</font></td>
<td valign="top"><font face="Arial">strPath</font></td>
<td valign="top"><font face="Arial">Returns the path set up by the OS for temporary mail
files. See the discussion on <a href="#TempDirs">TMP env variables</a> for more
information.</font></td>
</tr>
</table>
</blockquote>
<p> </p>
<blockquote>
<p><font face="Arial" size="1">Copyright � 1996, 1997, 1998, 1999, 2000 by ServerObjects Inc. All Rights
Reserved.</font></p>
</blockquote>
</blockquote>
</body>
</html>