NetMailBot Parameter Index

Alphabetical Listing Category Listing
-addrecipient
-altbody
-altbodyfile
-appendbad
-appendgood
-appendlog
-appendsuspect
-attachment
-attachmentdir
-attachmentlist
-authlogin
-authpassword
-bcc
-bcclist
-body
-bodyfile
-cc
-ccfriendly
-cclist
-chars
-config
-connectiontimeout
-customheader
-dbemailcolumn
-dbusecolumnindex
-dbreplacementids
-dbquery
-dbtable
-dbuseaddressee
-debug
-dnsservers
-dsn
-embed
-failsafe *New in 4.0*
-filedatebefore *New in 4.0*
-filedateafter *New in 4.0*
-filedateis *New in 4.0*
-filemask
-filesizelessthan *New in 4.0*
-filesizegreaterthan *New in 4.0*
-filesizeequal *New in 4.0*
-from
-fromfriendly
-generaltimeout
-htmlbody
-logbademail
-logfile
-loggoodemail
-logsuspectemail
-mimetype
-nofixhtml
-personalize
-port
-previewmode
-priority
-popcleanup *New in 4.0*
-popdelete *New in 4.0*
-popdirectory *New in 4.0*
-popforward *New in 4.0*
-popheader *New in 4.0*
-poppassword *New in 4.0*
-popreceive *New in 4.0*
-popreply *New in 4.0*
-popserver *New in 4.0*
-popstatistics *New in 4.0*
-popuser *New in 4.0*
-popwatch *New in 4.0*
-popwatchexit *New in 4.0*
-popwatchwait *New in 4.0*
-q
-receipt
-receiptfriendly
-receive *New in 4.0*
-recipientlimit
-reconnectaftersend
-sendwait
-server
-subject
-test
-to
-tofriendly
-tolist
-verify
-watchdir
-watchdelete
-watchexit
-watchmoveto
-watchwait
-zip
 
Simple Addressing
-bcc
-cc
-from
-to

Authentication
-authlogin
-authpassword

Receive Email from POP3 Server
-popcleanup *New in 4.0*
-popdelete *New in 4.0*
-popdirectory *New in 4.0*
-popforward *New in 4.0*
-popheader *New in 4.0*
-poppassword *New in 4.0*
-popreceive *New in 4.0*
-popreply *New in 4.0*
-popserver *New in 4.0*
-popstatistics *New in 4.0*
-popuser *New in 4.0*
-popwatch *New in 4.0*
-popwatchexit *New in 4.0*
-popwatchwait *New in 4.0*
-receive *New in 4.0*

Multiple Recipients
-bcclist
-cclist
-tolist

Message Content
-altbody
-altbodyfile
-body
-bodyfile

Database, ODBC
-dbemailcolumn
-dbreplacementids
-dbquery
-dbtable
-dbuseaddressee
-dbusecolumnindex
-dsn
-personalize

Email Address Verification
-verify
-dnsservers

Watch
-watchdir
-watchdelete
-watchexit
-watchmoveto
-watchwait



-addrecipient (-ar)

Description:

Adds a recipient to the -to list. Separate multiple email addresses with a space to specify multiple recipients. When used, the -to parameter is ignored but still required.

Optional?   Yes

Other parameters required?   None

See Also:   -to  -cc  -bcc  

Example (cut-and-paste right into your batch file):

NetMailBot -addrecipient myname@email.com another@domain.com -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-to (-t)

Description:

TO email address, e.g. no@no.net.

Specify multiple email addresses, by placing a space between each email address.

NOTE: If the parameter -tolist is specified, this parameter is ignored.

Optional?   No

Other parameters required?   None

See Also:   -tolist  -tofriendly  

Example (cut-and-paste right into your batch file):

NetMailBot -to myname@email.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-from (-f)

Description:

from email address, e.g. you@you.net. When verifying email addresses, some mail servers require a FROM address to know who is asking for verification. If not specified, the email address being verified is used as the from address

Optional?   Yes

Other parameters required?   None

See Also:   -fromfriendly  

Example (cut-and-paste right into your batch file):

NetMailBot -from you@hotmail.com -to email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-subject (-sj)

Description:

subject line of email

Optional?   No

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -subject "This is the subject. Make sure you enclose multiple words in quotes" -to email@domain.com -from email@domain.com -server mail.domain.com

Return to Index

 

 

 

 

 

 


-server (-s)

Description:

SMTP server name smtp.mail.com (no, it doesn't work)

Optional?   No

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -server mail.domain.com -to email@domain.com -from email@domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-body (-b)

Description:

Body of the message (enclose multiple words in quotes)

Optional?   Yes

Other parameters required?   None

See Also:   -bodyfile  -htmlbody  

Example (cut-and-paste right into your batch file):

NetMailBot -body "This is the body of the email. Use this parameter for short messages. Make sure to enclose multiple words with spaces in quotes." -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-bodyfile (-bf)

Description:

Filename of file to be used as the body of the message.

Optional?   Yes

Other parameters required?   None

See Also:   -body  

Example (cut-and-paste right into your batch file):

Example #1: The file C:\tmp\text.txt is loaded as the body of the email. The message body will appear as plain text due to the file extension .txt.
NetMailBot -bodyfile "C:\tmp\text.txt" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Example #2: The file C:\tmp\text.txt is loaded as the body of the email. The message body will appear as HTML due to the file extension .html.

NetMailBot -bodyfile "C:\tmp\rich.html" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Example #3: The website http://www.ExclamationSoft.com is loaded as the body of the email and will appear as HTML in the recipient's email client.

NetMailBot -bodyfile "http://www.ExclamationSoft.com" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-fromfriendly (-ff)

Description:

"Friendly" name that appears in the email. Instead of the from email address appearing, the friendly name will be in its place.

Optional?   Yes

Other parameters required?   -from  

See Also:   -from  

Example (cut-and-paste right into your batch file):

NetMailBot -fromfriendly "John Doe" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-cc (-cc)

Description:

Email address of Carbon Copy recipient.

Specify multiple email addresses, by placing a space between each email address.

Optional?   Yes

Other parameters required?   None

See Also:   -cclist  -ccfriendly  

Example (cut-and-paste right into your batch file):

NetMailBot -cc cc@mail.com -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-ccfriendly (-cf)

Description:

Friendly name to display instead of cc email address.

Optional?   Yes

Other parameters required?   -cc  

See Also:   -cc  

Example (cut-and-paste right into your batch file):

NetMailBot -ccfriendly "George Harrison" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-bcc (-bcc)

Description:

Email address of Blind Carbon Copy recipient.

Specify multiple email addresses, by placing a space between each email address.

Optional?   Yes

Other parameters required?   None

See Also:   -bcclist  

Example (cut-and-paste right into your batch file):

NetMailBot -bcc bcc@mail.com -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-tolist (-tl)

Description:

full filename of to address list. File should contain comma delimited list of email addresses.

Optional?   Yes

Other parameters required?   None

See Also:   -delimeter  -to  

Example (cut-and-paste right into your batch file):

NetMailBot -tolist "c:\temp\maillist.txt" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-cclist (-cl)

Description:

full filename of cc address list. File should contain comma delimited list of email addresses.

Optional?   Yes

Other parameters required?   -to  

See Also:   -delimeter  -cc  

Example (cut-and-paste right into your batch file):

NetMailBot -cclist "c:\temp\maillist.txt" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-bcclist (-bl)

Description:

full filename of bcc address list. File should contain comma delimited list of email addresses.

Optional?   Yes

Other parameters required?   -to  

See Also:   -delimeter  -bcc  

Example (cut-and-paste right into your batch file):

NetMailBot -bcclist "c:\temp\maillist.txt" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-recipientlimit (-rl)

Description:

Sets the number of recipients message is sent to at one time. Default is 100 which most SMTP servers set the limit to. This option is good if you wish to send out a personalized email to each person on your mailing list: by setting this parameter to 1, each individual will be the only adressee on the email.

Optional?   Yes

Other parameters required?   None

See Also:   -tolist  -cclist  -bcclist  -dsn  -dbquery  -dbtable  

Example (cut-and-paste right into your batch file):

NetMailBot -recipientlimit 1 -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-attachment (-a)

Description:

name of the text message attachment you wish to send.

Optional?   Yes

Other parameters required?   None

See Also:   -attachmentlist  

Example (cut-and-paste right into your batch file):

NetMailBot -attachment "c:\temp\documents.zip" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-attachmentlist (-al)

Description:

Pathname of file attachment list. File should contain comma delimited list of filenames.

Optional?   Yes

Other parameters required?   None

See Also:   -attachment  

Example (cut-and-paste right into your batch file):

NetMailBot -attachmentlist "c:\temp\attachment.lst" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-port (-port)

Description:

SMTP server port number. Default = 25 (Unless you have a specific reason for changing the port number, it is not recommended that you set this parameter.)

Optional?   Yes

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -port 8383 -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-test (-test)

Description:

Test mode. Connects to the mail server, and addresses your message but does not actually send the message. This is useful to ensure that all of the parameters you are using are correct. It can also alert you to possibly bad/invalid email addresses.

Optional?   Yes

Other parameters required?   None

See Also:   -debug  

Example (cut-and-paste right into your batch file):

NetMailBot -test -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-logfile (-logfile)

Description:

Filename of file to be used as the logfile. NOTE: The log file is erased and overwritten unless you specify the -appendlog parameter.

Optional?   Yes

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -logfile "c:\temp\logfile.txt" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-loggoodemail (-lg)

Description:

Filename of file to capture all "good" addresses - one's that are accepted by mail server.

Optional?   Yes

Other parameters required?   None

See Also:   -appendgood  

Example (cut-and-paste right into your batch file):

NetMailBot -loggoodemail "c:\temp\Good Email List.txt" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-logbademail (-lb)

Description:

Filename of file to capture all "bad" addresses - one's that are rejected by mail server.

Optional?   Yes

Other parameters required?   None

See Also:   -appendbad  

Example (cut-and-paste right into your batch file):

NetMailBot -logbademail "c:\temp\Bad Email List.txt" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-q (-q)

Description:

Quiet mode. Specifies that NetMailBot should not display anything on the screen. Useful if integrating NetMailBot with your own program.

Optional?   Yes

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -q -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-dsn (-dsn)

Description:

A Data Source Name (DSN) that is used to import email addresses from a database. A data source name is created by using the ODBC manager in the Windows Control Panel. Alternately, you can specify ODBC driver parameters (see examples).

Optional?   Yes

Other parameters required?   None

See Also:   -dbquery  -dbtable  -dbemailcolumn  -dbuseaddressee  -dbreplacementids  

Example (cut-and-paste right into your batch file):

Example #1: To Import a Microsoft Access Database.
NetMailBot -dsn "Provider=Microsoft.Jet.OLEDB.4.0; Data Source=\temp\dsn\MyAccessDatabase.mdb" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Example #2: To Import a Microsoft Excel Spreadsheet.

NetMailBot -dsn "Provider=Microsoft.Jet.OLEDB.4.0; Data Source=\temp\dsn\MyExcelSpreadsheet.xls; Extended Properties=Excel 8.0;" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Example #3: To Import a from a DSN.

NetMailBot -dsn "MyDatabase" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-tofriendly (-tf)

Description:

The -tofriendly parameter adds personalization to your email. Instead of the user's email address "to" appearing in the "to" of the email message heading, a friendly name appears. In the example image below, the "to" is "John Doe" instead of the email address

Optional?   Yes

Other parameters required?   -to  

See Also:   -to  -tolist  

Example (cut-and-paste right into your batch file):

NetMailBot -tofriendly "John Doe" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-verify (-vf)

Description:

(Email Address Verification is no longer supported) Verifies all email addresses specified with -to, -tolist, -cclist, -bcclist parameters. If an email address is specified after the -verify parameter, only that email address will be verified.

Optional?   Yes

Other parameters required?   None

See Also:   -from  -dnsservers  

Example (cut-and-paste right into your batch file):

Example #1: Verify one email address.
NetMailBot -verify email@domain.com -from email@domain.com

Example #2: Verify multiple addresses contained in the comma delimited file named "c:\temp\list.txt".

NetMailBot -verify -tolist "c:\temp\list.txt" -from email@domain.com

Return to Index

 

 

 

 

 

 


-personalize (-pl)

Description:

Turns on personalization or what is more commonly known as "mail merge". This allows the merging of data from an outside source, like a database, into your email message or parts of that message. For a full description, click here.

Message fields that can be personalized are:

  • -altbody
  • -body
  • -altbody
  • -subject
  • -tofriendly
  • -ccfriendly
  • -from
  • -fromfriendly

Refer to the examples on mail merge here

Optional?   Yes

Other parameters required?   None

See Also:   -dsn  -dbquery  -dbtable  -dbemailcolumn  -dbuseaddressee  -dbreplacementids  

Example (cut-and-paste right into your batch file):

NetMailBot -personalize -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-priority (-pr)

Description:

Sets the Microsoft Mail message priority. Valid settings for this parameter: LOW, NORMAL, HIGH.

Optional?   Yes

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -priority low, -priority normal, -priority high -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-preview (-pw)

Description:

Turns on preview mode of an HTML message body. A Internet browser window will open displaying the message body.

Optional?   Yes

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -previewmode -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-receipt (-rr)

Description:

Sets the email address for the receiving email client to send a receipt that the email has been received.

Optional?   Yes

Other parameters required?   None

See Also:   -receiptfriendly  

Example (cut-and-paste right into your batch file):

NetMailBot -receipt email@domain.com -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-receiptfriendly (-rf)

Description:

Sets the friendly name for the -receipt parameter's specified email address.

Optional?   Yes

Other parameters required?   -receipt  

See Also:   -receipt  

Example (cut-and-paste right into your batch file):

NetMailBot -receiptfriendly "John.Doe@domain.com" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-authlogin (-al)

Description:

Sets the SMTP server authentication login id. Some SMTP servers require login before sending email.

Optional?   Yes

Other parameters required?   -authpassword  

See Also:   -authpassword  

Example (cut-and-paste right into your batch file):

NetMailBot -authlogin userid -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-authpassword (-ap)

Description:

Sets the SMTP server authentication password. Some SMTP servers require login before sending email.

Optional?   Yes

Other parameters required?   -authlogin  

See Also:   -authlogin  

Example (cut-and-paste right into your batch file):

NetMailBot -authpassword password123 -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-embed (-em)

Description:

Embeds images into email when sending an HTML email body. Supported file types are .jpg and .gif.

Optional?   Yes

Other parameters required?   -bodyfile  

See Also:   -bodyfile  

Example (cut-and-paste right into your batch file):

NetMailBot -embed -bodyfile "http://www.yahoo.com" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-altbody (-ab)

Description:

Alternate text to display in email programs that do not support/display HTML messages.

Optional?   Yes

Other parameters required?   None

See Also:   -altbodyfile  

Example (cut-and-paste right into your batch file):

NetMailBot -altbody "Since your email program cannot display HTML, we have provided this plain text message" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-altbodyfile (-af)

Description:

Filename of file to be used as alternate text to display in email programs that do not support/display HTML messages.

Optional?   Yes

Other parameters required?   None

See Also:   -altbody  

Example (cut-and-paste right into your batch file):

NetMailBot -altbody "C:\My Documents\plain_text_newsletter.txt" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-appendlog (-ad)

Description:

Appends the log file if it already exists.

Optional?   Yes

Other parameters required?   -logfile  

See Also:   -logfile  

Example (cut-and-paste right into your batch file):

NetMailBot -appendlog -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-appendgood (-agood)

Description:

Appends the good email file if it already exists.

Optional?   Yes

Other parameters required?   -loggoodemail  

See Also:   -loggoodemail  

Example (cut-and-paste right into your batch file):

NetMailBot -appendgood -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-appendbad (-abad)

Description:

Appends the bad email file if it already exists.

Optional?   Yes

Other parameters required?   -logbademail  

See Also:   -logbademail  

Example (cut-and-paste right into your batch file):

NetMailBot -appendbad -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-dbtable (-dbt)

Description:

Sets the database table to use when using -personalize.

Optional?   Yes

Other parameters required?   -dsn  -dbemailcolumn  

See Also:   -dsn  -dbquery  -dbemailcolumn  -dbuseaddressee  -dbreplacementids  

Example (cut-and-paste right into your batch file):

NetMailBot -dbtable "customer" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-dbemailcolumn (-dbe)

Description:

Sets the database column in the specified table, set with SetDBTable, where email addresses are found.

Optional?   Yes

Other parameters required?   -dsn  -dbquery  -dbtable  

See Also:   -dsn  -dbquery  -dbtable  -dbuseaddressee  -dbreplacementids  

Example (cut-and-paste right into your batch file):

NetMailBot -dbemailcolumn "EmailAddress" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-dbreplacementids (-dbr)

Description:

Specifies replacement identifiers used with -personalize. Specify replacement ids wrapped with << and >>, e.g. <<first_name>>, an equals sign, then the name of the corresponding column name. separate multiple replacement identifiers with a comma.

Optional?   Yes

Other parameters required?   Requirements  

See Also:   -dsn  -dbquery  -dbemailcolumn  -dbuseaddressee  -dbtable  

Example (cut-and-paste right into your batch file):

NetMailBot -dbreplacementids "<<first_name>>=first_name" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-dbuseaddressee (-dbu)

Description:

Specifies which addressee should be used with -personalize.

Optional?   Yes

Other parameters required?   -dsn  -dbquery  -dbtable  

See Also:   -dsn  -dbquery  -dbemailcolumn  -dbtable  -dbreplacementids  

Example (cut-and-paste right into your batch file):

NetMailBot -dbuseaddressee "to" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-debug (-db)

Description:

Turns on debug mode. Debug mode logs messages to and from the mail server. Use this option to determine if there is a problem with the mail server.

Optional?   Yes

Other parameters required?   None

See Also:   -test  

Example (cut-and-paste right into your batch file):

NetMailBot -debug -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-nofixhtml (-nfh)

Description:

prevents a bodyfile with html from being "fixed". By default, a message body with HTML is automatically changed so that images and links do not appear broken in the mail client software. Specify this switch to prevent the "fix".

Optional?   Yes

Other parameters required?   -bodyfile  

See Also:   -bodyfile  

Example (cut-and-paste right into your batch file):

NetMailBot -nofixhtml -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-mimetype (-mt)

Description:

Override automatically set MIME content type of the message body. Does not affect any other part of the message. Examples: "text/plain" and "text/html"

Optional?   Yes

Other parameters required?   -body  

See Also:   -body  -htmlbody  

Example (cut-and-paste right into your batch file):

NetMailBot -mimetype "text/html" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-connectiontimeout (-ct)

Description:

Sets the connection timeout in milliseconds.

If the connection to the mail server takes longer than the specified time, the NetMailBot will stop and return an %ERRORLEVEL% of 13. Use the parameter -failsafe to prevent NetMailBot from stopping and to retry indefinitely.

Optional?   Yes

Other parameters required?   None

See Also:   -generaltimeout  -failsafe  

Example (cut-and-paste right into your batch file):

NetMailBot -connectiontimeout 60000 -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-generaltimeout (-gt)

Description:

Sets the general timeout while sending an individual message in milliseconds.

If the process of sending the message, including attachments, exceeds the specified time, NetMailBot will stop and return an %ERRORLEVEL% of 13. Use the parameter -failsafe to prevent NetMailBot from stopping and to retry indefinitely.

Optional?   Yes

Other parameters required?   None

See Also:   -connectiontimeout  -failsafe  

Example (cut-and-paste right into your batch file):

NetMailBot -generaltimeout 600000 -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-logsuspectemail (-gt)

Description:

Specifies the pathname of the file to write suspect email addresses to. This parameter is only valid when used with the -verify parameter. Suspect email addresses are those that NetMailBot is unable to check for validity.

Optional?   Yes

Other parameters required?   None

See Also:   -appendsuspect  

Example (cut-and-paste right into your batch file):

NetMailBot -logsuspectemail "c:\temp\suspect.txt" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-appendsuspect (-asuspect)

Description:

If specified, the suspect email file will be appended to

Optional?   Yes

Other parameters required?   -logsuspectemail  

See Also:   -logsuspectemail  

Example (cut-and-paste right into your batch file):

NetMailBot -appendsuspect -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-dbquery (-dbq)

Description:

Specifies the SQL query for NetMailBot to execute when using the database and mail merge commands

Optional?   Yes

Other parameters required?   -dsn  

See Also:   -dsn  -dbemailcolumn  -dbreplacementids  -dbuseaddressee  

Example (cut-and-paste right into your batch file):

NetMailBot -dbquery "SELECT * FROM Customers" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-htmlbody (-html)

Description:

If specified, the message body's MIME type is set to be TEXT/HTML. Use in conjunction with -body to force NetMailBot to override the default MIME type of TEXT/PLAIN.

Optional?   Yes

Other parameters required?   -body  

See Also:   -bodyfile  

Example (cut-and-paste right into your batch file):

NetMailBot -htmlbody -body "<h1>Use the -htmlbody parameter to force NetMailBot to set the MIME type for the message body to TEXT/HTML.</h1>" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-dnsservers (-dnss)

Description:

Specifies one or more DNS servers used for email address verification. separate multiple server addresses with a comma. If this property is not specified, then NetMailBot will search the registry for addresses.

Optional?   Yes

Other parameters required?   -verify  

See Also:   -verify  

Example (cut-and-paste right into your batch file):

NetMailBot -verify email@domain.com -from email@domain.com -dnsservers 192.168.0.1

Return to Index

 

 

 

 

 

 


-customheader (-ch)

Description:

Allows the adding of one or more strings to the header of the email. Separate multiple values with a semicolon.

Optional?   Yes

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -customheader "Reply-To: email@domain.com;Return-Path:email@domain.com" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-attachmentdir (-ai)

Description:

Specifies a directory to add attachments from. Use with -zip to compress files into one zip file and attach. Use with -filemask to specify only certain files, e.g. "*.txt"

Optional?   Yes

Other parameters required?   None

See Also:   -filemask  -zip  

Example (cut-and-paste right into your batch file):

NetMailBot -attachmentdir "C:\Documents and Settings\Invoices" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-filemask (-fm)

Description:

Specifies a file mask. By default, the mask is *.* - all files.

Optional?   Yes

Other parameters required?   -watchdir  -attachmentdir  

See Also:   -watchdir  -attachmentdir  

Example (cut-and-paste right into your batch file):

NetMailBot -filemask "*.txt" -attachmentdir "c:\Documents and settings\docs" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-watchdir (-wd)

Description:

Specifies a directory to watch for files to send as attachments. NetMailBot will continuously monitor the directory and until the key combination CTRL-C is pressed. Requires -watchmoveto or -watchdelete parameter to be specified

Optional?   Yes

Other parameters required?   -watchdelete  -watchmoveto  

See Also:   -filemask  -watchdelete  -watchexit  -watchmoveto  -watchwait  -zip  

Example (cut-and-paste right into your batch file):

NetMailBot -watchdir "C:\Documents and Settings\reports" -watchdelete -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-watchdelete (-wde)

Description:

Switch used with -watchdir parameter that specifies that files should be deleted after they are sent.

Optional?   Yes

Other parameters required?   -watchdir  

See Also:   -watchdir  

Example (cut-and-paste right into your batch file):

NetMailBot -watchdelete -watchdir "C:\Documents and Settings\reports" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-watchexit (-we)

Description:

Switch used with -watchdir to exit after files are sent after attaching files in the watch directory.

Optional?   Yes

Other parameters required?   -watchdir  

See Also:   -watchdir  

Example (cut-and-paste right into your batch file):

NetMailBot -watchexit -watchdir "C:\Documents and Settings\reports" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-watchmoveto (-wm)

Description:

Switch used with -watchdir to exit after files are sent after attaching files in the watch directory.

Optional?   Yes

Other parameters required?   -watchdir  

See Also:   -watchdir  

Example (cut-and-paste right into your batch file):

NetMailBot -watchmoveto "C:\Documents and Settings\Sent" -watchdir "C:\Documents and Settings\reports" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-watchwait (-ww)

Description:

Specifies the number of milliseconds (1/1000 of a second) to wait between checking the watch directory for new files to send. By default, the waiting time is set to 60000 or 1 minute.

Optional?   Yes

Other parameters required?   -watchdir  

See Also:   -watchdir  

Example (cut-and-paste right into your batch file):

NetMailBot -watchwait 5000 -watchdir "C:\Documents and Settings\reports" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-zip (-zi)

Description:

Switch/Parameter used to compress all attachments into a single zip file as a single attachment. Specify a filename after this parameter to name the attachment; otherwise, "attachment.zip" is used. Works with -watchdir parameters, -attachment, -attachmentdir, and -attachmentlist.

Optional?   Yes

Other parameters required?   None

See Also:   -attachment  -attachmentdir  -attachmentlist  -watchdir  

Example (cut-and-paste right into your batch file):

NetMailBot -zip -attachment "C:\Documents and Settings\report.xls" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-config (-c)

Description:

Specifies a configuration file to load commonly used parameters from. NetMailBot will load parameters from the command line/batch file first, then load parameters from the configuration file. Parameters in the configuration file do not override, but add-to the parameters specified on the command line or in a batch file. As with batch files, all parameters cannot be separated by a carraige return.

Optional?   Yes

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -config c:\temp\config.txt -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-reconnectaftersend (-ra)

Description:

Specifies that after sending a message to disconnect then reconnect.

Optional?   Yes

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -reconnectaftersend -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-sendwait (-sw)

Description:

Sets the number of milliseconds to wait after sending a message. Useful for some mail servers that prevent message sending from causing an overload.

Optional?   Yes

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -sendwait 5000 -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-dbusecolumnindex (-dbi)

Description:

Specifies that a column index is used in place of a column name, e.g., -dbreplacementids "<<first_name>>=2,<<last_name>>=1,<<company>>=3". Applies to -dbreplacementids and -dbemailcolumn

Optional?   Yes

Other parameters required?   None

See Also:   -dbemailcolumn  -dbreplacementids  

Example (cut-and-paste right into your batch file):

NetMailBot -dbusecolumnindex 5000 -dbemailcolumn "0" -dbreplacementids "$first_name$=1" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-receive (-r)

Description:

Instructs NetMailBot to receive email from a POP3 email server

Optional?   Yes

Other parameters required?   -popserver  -popuser  -poppassword  

See Also:   -popuser  -poppassword  -popserver  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popuser (-pu)

Description:

Specifies the email account user name

Optional?   Yes

Other parameters required?   -receive  -poppassword  -popserver  

See Also:   -receive  -poppassword  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popserver (-ps)

Description:

Specifies the name of the POP3 mail server

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  

See Also:   -receive  -popuser  -poppassword  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popserver pop.domain.com -popuser username -poppassword password

Return to Index

 

 

 

 

 

 


-poppassword (-pp)

Description:

Specifies the email account user password

Optional?   Yes

Other parameters required?   -receive  -popuser  -popserver  

See Also:   -receive  -popuser  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -poppassword password -popuser username -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popstatistics (-pops)

Description:

Retrieves the number of messages and the total number of bytes the email messages are using for the specified email account

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  

See Also:   -receive  -popuser  -poppassword  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popstatistics -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popreceive (-popr)

Description:

Specifies a message to retrieve. Each part of the email message, body and attachments, are saved to the hard drive. Specify a message number after this parameter for a single message. If you do not specifiy a message number, all messages will be retrieved.

When an email message from your POP3 mail server is downloaded the message parts are saved in individual files in a folder named "pop3" under your system temporary directory. To view these files, at a DOS command prompt, type "cd %TEMP%\pop3".

Each email message normally will have at least one message part. The text message body part is saved as "text_plain[message number].txt". The HTML message body is saved as "text_html[message number].html". Attachments are saved with their original name. If any of the files exist, they are overwritten.

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  

See Also:   -receive  -popuser  -poppassword  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popreceive 1 -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popheader (-poph)

Description:

Specifies a header to retrieve. Specify a message number after this parameter for a single message header. If you do not specifiy a message number, all messages will be retrieved.

The text from the message header is saved in a file named "header[message number].txt" under a folder named "pop3" under your system temporary directory. To view these files, at a DOS command prompt, type "cd %TEMP%\pop3".

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  

See Also:   -receive  -popuser  -poppassword  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popheader 1 -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popdelete (-popd)

Description:

Specifies a message to delete. Specify a message number after this parameter to delete a single message. If you do not specifiy a message number, all messages will be deleted.

Can be used in conjunction with other POP3 commands. If used with other POP3 commands, deletion will only occur if there are no errors or problems with the other commands.

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  

See Also:   -receive  -popuser  -poppassword  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popdelete 1 -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popdirectory (-pd)

Description:

Specifies the directory name to save retrieved attachments, email message bodies, and other MIME parts. If not specified, then a directory named "pop" is created and used under the system temporary directory

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  

See Also:   -receive  -popuser  -poppassword  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popdirectory "c:\temp" -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popcleanup (-popc)

Description:

Switch used to force all files in the -popdirectory to be deleted before processing. This is useful to keep the -popdirectory from growing too large

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  

See Also:   -receive  -popuser  -poppassword  -popreceive  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popcleanup -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popforward (-popf)

Description:

Switch used to forward email to one or more email addresses. Can be used in combination with any of the other parameters that normally send email.

Additionally specify the parameters -to and -from. If additonal parameters for sending are specified, they will override/overwrite current values in the email that was received. For example, if -subject is specified, the subject from the received email will not be used. See examples for more detail.

If there are no messages are on the server to download, no action is taken

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -server  -popserver  

See Also:   -receive  -popuser  -poppassword  -popreceive  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popforward -to to@domain.com -from from@domain.com -server smtp.domain.com -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popwatch (-pw)

Description:

Switch used to monitor an email account and perform specific actions indefinitely

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  

See Also:   -receive  -popuser  -poppassword  -popreceive  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popwatch -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popwatchexit (-pwe)

Description:

Specifies that NetMailBot should exit a watch, after successfully retrieving at least one email message

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  -popwatch  

See Also:   -receive  -popuser  -poppassword  -popreceive  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popwatchexit -popwatch -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popwatchwait (-pww)

Description:

Specifies the number of milliseconds to wait between monitoring an email account for new messages

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  -popwatch  

See Also:   -receive  -popuser  -poppassword  -popreceive  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popwatchwait 5000 -popwatch -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-popreply (-pre)

Description:

Specifies a message to auto-reply to. Each part of the email message, body and attachments, are saved to the hard drive. Specify a message number after this parameter for a single message. If you do not specifiy a message number, all messages will be replied to.

You must specify either -body or -bodyfile and/or other sending parameters for the reply.

If -subject is not specified, then the original subject is used with the prefix "RE: "

Cannot be used with -popreceive or -popforward.

Optional?   Yes

Other parameters required?   -receive  -popuser  -poppassword  -popserver  -body  -bodyfile  -from  

See Also:   -receive  -popuser  -poppassword  -popreceive  

Example (cut-and-paste right into your batch file):

NetMailBot -receive -popreply 1 -from email@domain.com -server smtp.domain.com -body "Thank you for your interest" -popuser username -poppassword password -popserver pop.domain.com

Return to Index

 

 

 

 

 

 


-filedatebefore (-fdb)

Description:

Only attach files if date is before specified date. Either -attachmentdir or -watchdir parameters are required.

Optional?   Yes

Other parameters required?   -attachmentdir  -watchdir  

See Also:   -filedateafter  -filedateis  -attachmentdir  

Example (cut-and-paste right into your batch file):

NetMailBot -filedatebefore "6/1/2003" -attachmentdir "c:\temp" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-filedateafter (-fda)

Description:

Only attach files if date is after specified date. Either -attachmentdir or -watchdir parameters are required.

Optional?   Yes

Other parameters required?   -attachmentdir  -watchdir  

See Also:   -filedatebefore  -filedateis  -attachmentdir  

Example (cut-and-paste right into your batch file):

NetMailBot -filedateafter "6/1/2003" -attachmentdir "c:\temp" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-filedateis (-fdi)

Description:

Only attach files if date is the specified date. Either -attachmentdir or -watchdir parameters are required.

Optional?   Yes

Other parameters required?   -attachmentdir  -watchdir  

See Also:   -filedatebefore  -filedateafter  -attachmentdir  

Example (cut-and-paste right into your batch file):

NetMailBot -filedateis "6/1/2003" -attachmentdir "c:\temp" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-filesizelessthan (-fsl)

Description:

Only attach files if size is less than number in bytes specified. Either -attachmentdir or -watchdir parameters are required.

Optional?   Yes

Other parameters required?   -attachmentdir  -watchdir  

See Also:   -filesizegreaterthan  -filesizeequal  -attachmentdir  

Example (cut-and-paste right into your batch file):

NetMailBot -filesizelessthan 10000 -attachmentdir "c:\temp" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-filesizegreaterthan (-fsg)

Description:

Only attach files if size is greater than number in bytes specified. Either -attachmentdir or -watchdir parameters are required.

Optional?   Yes

Other parameters required?   -attachmentdir  -watchdir  

See Also:   -filesizelessthan  -filesizeequal  -attachmentdir  

Example (cut-and-paste right into your batch file):

NetMailBot -filesizegreaterthan 10000 -attachmentdir "c:\temp" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-filesizeequal (-fse)

Description:

Only attach files if size is equal to the number in bytes specified. Either -attachmentdir or -watchdir parameters are required.

Optional?   Yes

Other parameters required?   -attachmentdir  -watchdir  

See Also:   -filesizelessthan  -filesizegreaterthan  -attachmentdir  

Example (cut-and-paste right into your batch file):

NetMailBot -filesizeequal 10000 -attachmentdir "c:\temp" -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-failsafe (-sf)

Description:

When specified, NetMailBot will not stop when an error condition is reported, such as a connection timeout, a general timeout, and an unexpected disconnect from the mail server.

Use this parameter with caution: NetMailBot will continuously try to reconnect and send email indefinitely until all messages are successfully sent.

Optional?   Yes

Other parameters required?   None

See Also:   -connectiontimeout  -generaltimeout  

Example (cut-and-paste right into your batch file):

NetMailBot -failsafe -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index

 

 

 

 

 

 


-chars (-cpl)

Description:

Characters per line. Specifies the maximum number of characters per line a message part should be. If plain text message parts appear incorrect - wrapping unintentionally - when viewing in an email client program, e.g., Outlook, set this value to 9999999. The default value is 72.

Optional?   Yes

Other parameters required?   None

See Also:   N/A

Example (cut-and-paste right into your batch file):

NetMailBot -chars 9999999 -to email@domain.com -from email@domain.com -server mail.domain.com -subject "test"

Return to Index