About AspQMail 2.x

AspQMail builds on the success of the AspMail product and provides all the features that AspMail provides and in addition:

1. Message queuing which allows the message to be sent without any delays to the Web client.
2. An NT Service that sends queued messages

What's New

AspQMail 1.2 added the ability to set the number of message delivery attempts and it also creates a directory for failed messages to be moved into. AspQMail 2.0 adds the following features:

• Thread pooling and queue manager optimizations for greater efficiency
• Multiple SMTP transactions per connection
• Delayed sending of messages

Purchasing AspQMail

1. Evaluation copies will expire. Check the ServerObjects Inc. products page for the latest evaluation copy.

AspQMail Installation and Configuration

Installing AspQMail consists of

1. Downloading the current version of AspQMail.
2. Stopping all IIS related services if you previously had AspMail installed.
3. Running the QMSetup installation program.
   • AspQMail should be installed to a directory named \AspQMail.
   • A directory named \AspQMail\Que will be used to queue messages.
   • A directory named \AspQMail\Que\Failed will hold failed messages.
   • The AspMail component will be installed by setup and registered automatically.
   • Sample AspMail scripts and all documentation will be installed.
4. Running QConfig after installation program is complete to configure and start the service. See the QConfig section below for details on QConfig's options.

To uninstall AspQMail simply start Control Panel. Select Add/Remove software and select AspQMail from the list.

About Upgrades

1. Users can upgrade for free for minor version changes. For example, upgrades from version 1.00 to 1.99 are free. The upgrade from 1.99 to 2.0 may carry an additional license fee.
2. The latest version of the components are always available at http://www.serverobjects.com/products.htm.   If a fee is associated with obtaining the upgrade it will be noted on that page.

Upgrade Instructions

To upgrade the service and component please follow these steps:

1. Stop the AspQMail service
2. Stop all IIS related services
3. Run QMSetup2.exe
4. Run QConfig to configure the service

If you are upgrading from a previous version of AspQMail you must run QConfig and select File/Update Registry Settings from the menu. 

Simple Mail Example

AspQMail uses the AspMail component to send messages to the queue. To use the component you use it the same way you normally would except that you set one additional property.

Mailer.QMessage = true

If QMessage is true then the message will be sent to the \Que directory. If it is false (the default) it will be sent normally via SMTP.

Failed Message Handling

Messages can be retried from 1 to 100 times. The is configurable from the QConfig utility. Once the maximum number of attempts has been made the files are moved into your queue directory path  + \failed. You can either reprocess these messages (see QConfig instructions for details), process them in another fashion or or delete them.

Questions about AspQMail

I'm having problems with AspQMail not sending my messages. What should I check?	If you need to troubleshoot here are the suggested steps: Be sure AspMail functions properly first before turning the queuing feature on. The old Recipient, CC and BCC properties of AspMail are not supported in AspQMail. You must use AddRecipient, AddCC and AddBCC. Be sure the AspQMail service is started. Check the failed subdirectory for failed messages. If you are directing error messages (set in QConfig) to the EventLog check your NT Event Log / Application Events for failure messages. The reason for a failed message will appear there. Or if you are directing them to the message log check your AspQMail / Que directory for a log indicating why the messages are failing. If you don't see any failed messages or failures in the EventLog/Message Log then the messages are apparently getting sent to the designated RemoteHost and you'll have to find out why they aren't getting from your SMTP server to your recipient. This means AspQMail is working but something between the designated RemoteHost (SMTP server) and the recipient's POP3 server is preventing the message from getting delivered. You'll have to troubleshoot this with your SMTP administrator. With queing turned on, check the Response property of the AspMail object after calling SendMail. See if you are getting an error.
My mail server was down. How do I resend messages in the /failed directory?	Using QConfig bump the # of message retries up. Move the files in the \failed directory to the queue directory. Restart the service. Be sure that once sending is complete that you change the # of message retries back to its original value.
I am getting an error from the AspMail Response property, "Unable to save message body". What should I look at?	This can occur for two reasons: You didn't run QConfig and set up your queue message path. The anonymous IIS user IUSR_ and/or IWAM_, or other users authenticating under IIS have no read/write rights to the directory set up as your queue path.
AspMail works fine but when I turn queuing on I get an error: "At least one Recipient, CC or BCC must be entered	The Name part of the AddRecipient method call cannot be blank under AspQMail. Use the email address for both Name and Address parameters if you do not have a recipient Name to use.

Technical Support

If you require technical support please see our tech support page at http://www.serverobjects.com/support.htm

AspMail Properties

Property	Description
QMessage	Determines if message will be sent to queue. If QMessage is true it will be queued and handled by the QMail service. If QMessage is false it will be sent by SMTP. Example: Mailer.QMessage = true
QTime	QTime is the date and time at which a message is approved for transmission. The format of this property is determined by regional registry settings (Short Date & Time Style). Standard U.S. formatting would be  MM/DD/YY HH:MM:SS Under NT you can check these settings by going to Control Panel/Regional Settings and viewing the Time & Date tabs. If the value QTime is set to cannot be interpreted according to the registry settings, the message will be transmitted as soon as the service has an available thread or SMTP connection. The time value should use the 24 hour clock. Mailer.QTime = "07/30/00 22:10:00"

QConfig Options

Message Directory: The value of this field should be the directory where AspMail will drop messages for the  AspQMail service to pickup. Example: C:\AspQMail

RemoteHost: This field is only used when you want to stream all messages through a single SMTP server. Putting the IP or hostname of your SMTP server in this field will allow AspQMail to stream multiple messages through a single SMTP connection increasing message throughput. Example: 127.0.0.1

Max Per Connection: This field determines the maximum number of messages that will be sent through a single SMTP connection. The default value is 20 but may be increased up to any value your SMTP server will accept.

Max Threads: Determines the maximum number of threads that the NT service can simultaneously send to the remote SMTP server. Some servers will only accept a limited number of threads, such as NTMail's Developer version which will only accept 5 concurrent connections.

Max Delivery Attempts: This value indicates the maximum number of times AspQMail should attempt to deliver a message before moving it into the \aspqmail\que\failed directory. It is recommended that you keep this value in the area of 5 attempts for efficiency. If you have a large number of failed messages you can increase this value, restart the service, and then move failed messages back into the \que\ folder for reprocessing.

Event Logging: Determines where event messages are sent. Events recorded to the log file include failures of any type and SendMail successes. Only failures are logged when NT EventLog is selected.

 

Copyright © 1996, 1997, 1998, 1999, 2000 by ServerObjects Inc. All Rights Reserved.