Support for Windows Accounts
A division of WAASI	For Standard Plans or Dedicated Servers please click here.

Windows Support Home > Using Jmail > Jmail reference manual

Jmail reference manual HTML format 

w3 Jmail is a fast email component specifically designed for ASP which has lots of functions.  Technical Some of the features in version 3.7 Attachments Return Receipt Detailed logging capabilities Priority settings MIME with BASE64, UUEncode and Quoted-Printable Encoding Queued mailings without separate NT service Unlimited redundant servers Blind Carbon Copy (BCC) Carbon Copy (CC) Urgent flagging US ASCII and ISO-8859-1 UUEncoding X-Headers and custom headers MS Mail and Exchange priority headers Internal MX lookup with MX priority and redundancy The log function in JMail allows you to see what actually happens when JMail sends your message. It is a good way to troubleshoot problems that often happen when using misconfigured mail servers JMail have been tested for the following y2k tests: 2000-01-01 Bug - OK 2000-02-29 Bug - OK 2000-04-01 Bug - OK (Found in MS VCRT) JMail addresses all years with 16bit accuracy and therefore limits JMail from dates starting at -32768 to 32768 Details    Body : String    Charset : String    ContentTransferEncoding : String    ContentType : String    DeferredDelivery : Date    Encoding : String    ErrorCode : Integer    ErrorMessage : String    ErrorSource : String    ISOEncodeHeaders : Boolean    Lazysend : Boolean    Log : String    Logging : Boolean    MailDomain : String    MimeVersion : String    Priority : Integer    Recipients : String    ReplyTo : String    ReturnReceipt : Boolean    Sender : String    SenderName : String    ServerAddress : String    Silent : Boolean    SimpleLayout : Boolean    Subject : String    UsePipelining : Boolean    AddAttachment( FileName, [ContentType] )    AddCustomAttachment( FileName, Data )    AddHeader( XHeader, Value )    AddNativeHeader( Header, Value )    AddRecipient( Email )    AddRecipientBCC( Email )    AddRecipientCC( Email )    AddRecipientEx( Email, Name )    AddURLAttachment( bstrURL, bstrAttachAs, [bstrAuth] )    AppendBodyFromFile( FileName )    AppendText( Text )    ClearAttachments()    ClearCustomHeaders()    ClearRecipients()    Close()    Execute() : Boolean    ExtractEmailAddressesFromURL( bstrURL, [bstrAuth] )    GetMessageBodyFromURL( bstrURL, [bstrAuth] )    LogCustomMessage( Message ) Properties Body : String  Back to Top (v3.0) The body of the message. To append text to the body use AppendText JMail.Body = "Hello world" Charset : String Back to top (v3.0) This is the charset of the message. The default is "US-ASCII" JMail.Charset = "US-ASCII" ContentTransferEncoding : String (v3.0) Specifies the content transfer encoding. The default is "Quoted-Printable" JMail.ContentTransferEncoding = "base64" ContentType : String (v3.0) This is the contentype of the message. It defaults to "text/plain" but can be set to whatever you need. If you want to send HTML in your messages, change this to "text/html" JMail.ContentType = "text/html" DeferredDelivery : Date (v3.0) Sets defered delivery of messages. If the mailserver supports it the message wont be delivered before this date and time. JMail.DeferredDelivery = new Date( 2000, 02, 17 ).getVarDate(); Encoding : String (v3.0) This can be used to change the default Attachment encoding from base64. Valid options are "base64", "uuencode" or "quoted-printable" JMail.Encoding = "base64" ErrorCode : Integer (v3.0) Contains the error code if JMail.silent is set to true Response.Write( JMail.ErrorCode ); ErrorMessage : String (v3.0) Contains the error message if JMail.silent is set to true Response.Write( JMail.ErrorMessage ); ErrorSource : String (v3.0) Contains the error source if JMail.silent is set to true Response.Write( JMail.ErrorSource ); ISOEncodeHeaders : Boolean (v3.0) Encodes header stings according to iso-8859-1 character sets. The default is true. JMail.ISOEncodeHeaders = false Lazysend : Boolean (v3.0) This property specifies if JMail is to wait until the mail is sent and then return or if it is to buffer the message and send it in the background. By setting this you do however don get control of error messages etc.<BR><BR><B> NOTE:</B> If you use this option, ServerAddress have NO function. The lazysend function will resolve the Mailserver with DNS queries. This can be a problem in some configurations. JMail.LazySend = true; Log : String (v3.0) This is the log created by JMail when loging is set to true Response.Write( JMail.Log ); Logging : Boolean (v3.0) Enables/Disables logging in JMail JMail.Logging = true MailDomain : String (v3.0) This can be used to override the EHLO/HELO statement to your mailserver JMail.Maildomain = "hello.world.com" MimeVersion : String (v3.0) Specifies the mime version. The default is "1.0" JMail.MimeVersion = "1.0" Priority : Integer (v3.0) This is the priority of the message. The range of priorities can be from 1 to 5.<ol><li>This means that the message is High Priority. Some mailers prefer to call this level "Urgent". </li><li>This is also high priority.</li><li>This is normal priority.</li><li>This is low priority.</li><li>This is the lowest priority.</li></ol> JMail.Priority = 3 Recipients : String (v3.0) Readonly property of all recipients of this message Response.Write( " " + JMail.Recipients + " " ); ReplyTo : String (v3.0) Specifies a optional reply address JMail.ReplyTo = "president@somesite.com" ReturnReceipt : Boolean (v3.0) Specifies wether or not the sender requires a return receipt. The default value of the property is "false" JMail.ReturnReceipt = true Sender : String (v3.0) Specifies the sender address of the message JMail.Sender = "batman@somesite.com" SenderName : String (v3.0) Specifies the sender name of the message JMail.SenderName = "Bat man" ServerAddress : String (v3.0) Specifies the address of the server. There can be more than one server specified by separating the list with a semicolon. If a port other than 25 is used then specify this by adding a colon after the servername. If the serverAddress is left blank JMail will try to resolv the remote Mail server and sen the message directly to that server. JMail.ServerAddress = "mail.mydom.net; mail2.mydom.net:2500" Silent : Boolean (v3.0) Set to true, JMail will not trow exceptions. Instead JMail.execute() will return true or false depending on the success of the operation JMail.silent = true SimpleLayout : Boolean (v3.0) Set to true to reduce the number of headers JMail produces. JMail.SimpleLayout = true Subject : String (v3.0) Specifies the subject of the message JMail.Subject = "Dimac rocks big time!" UsePipelining : Boolean (v3.0) Overrides if JMail should use pipelining on a server that supports it. JMail.Pipelining = false Methods AddAttachment( FileName, [ContentType] ) (v3.0) Adds a file attachment to the mssage JMail.AddAttachment( "c:\\autoexec.bat" );  AddCustomAttachment( FileName, Data ) (v3.0) Adds a custom attachment. This can be used to attach "virtual files" like a generated text string or certificate etc. JMail.AddCustomAttachment( "readme.txt", "Contents of file" ); AddHeader( XHeader, Value ) (v3.0) Adds a user defined X-header to the message JMail.AddHeader( "Originating-IP","193.15.14.623" ); AddNativeHeader( Header, Value ) (v3.0) Adds a header to the message JMail.AddNativeHeader( "MTA-Settings", "route" ); AddRecipient( Email ) (v3.0) Adds a recipient to the message JMail.AddRecipient( "info@somesite.com" ); AddRecipientBCC( Email ) (v3.0) Adds a Blind Carbon Copy recipient to the message JMail.AddRecipientBCC( "someone@somesite.com" ); AddRecipientCC( Email ) (v3.0) Adds a Carbon Copy recipient to the message JMail.AddRecipientCC( "someone@somesite.com" ); AddRecipientEx( Email, Name ) (v3.0) Adds a recipient with a name to the message JMail.AddRecipientEx( "info@somesite.com", "Somesite INFO" ); AddURLAttachment( bstrURL, bstrAttachAs, [bstrAuth] ) (v3.0) Downloads and adds an attachment based on an URL. A seconds argument, "AttachAs", is used for specifying the filename that the attachment will receive in the message. A third and optional argument is used for optional WWW-Authentication. JMail.AddURLAttachment( "http://download.somesite.com/file.exe", "file.exe" ) AppendBodyFromFile( FileName ) (v3.0) Appends body text from a file JMail.AppendBodyFromFile( "c:\\mytext.txt" ); AppendText( Text ) (v3.0) Append "text" to body JMail.AppendText( "Text appended to message Body" ); ClearAttachments() (v3.0) Clears the list of attachments JMail.ClearAttachments(); ClearCustomHeaders() (v3.0) Clears all custom headers JMail.ClearCustomHeaders(); ClearRecipients() (v3.0) Clear the recipient list JMail.ClearRecipients(); Close() (v3.0) Force JMail to close an cached connection to a mailserver. JMail.Close(); Execute()  : Boolean (v3.0) Executes and sends the message to the server JMail.Execute(); ExtractEmailAddressesFromURL( bstrURL, [bstrAuth] ) (v3.0) Downloads and adds email addresses from an URL. JMail.ExtractEmailAddressesFromURL( "http://somesite.com/generateEmailList.asp" ); GetMessageBodyFromURL( bstrURL, [bstrAuth] ) (v3.0) Clears the body of the message and replaces it with the contents of the URL. The contenttype is automaticly set to match the contentype of the URL. The second argument (login and password) is optional JMail.GetMessageBodyFromURL( "http://somesite.com/", "login:password" ) LogCustomMessage( Message ) (v3.0) Logs a custom user message to the JMail log. This function works ONLY if loging is set to true JMail.LogCustomMessage( "Hello world" );