TO SETUP THE IR EMAILER
_______________________________________________

1. emailer_setup.bat , will register the relavant dlls that interactive reporting needs and launch the configuration tab.
	
2. emailer.exe is a program designed to send all the favourite flagged as emails. 
	We suggest creating a scheduled task to run this, at the desired frequency.



The emailer depends on the presence of ir_system3, as it uses this to pick up its system settings.

It is configured from the Email tab of the system settings. There are 5 main settings.
	 These can also be overriden if specified from the command line

Email Source: The email address that the reports are sent from.
SMTP Server:  The SMTP server to use for sending the emails.
SMTP Port:    The Port of the smtp server to use. Typically 25.
URL:          This is the URL used to access the IR Server. Typically this will be http://localhost:5050/ for a desktop version
	      For an IIS install it would be http://localhost/yourvirtualdirectory/
Email Problem Reports: An email address to send problem reports to.





COMMAND LINE OPTIONS
_______________________________________________

-fromname YOUR_NAME		Allows you to specify the sender's name as will appear in the email. Default is "Interactive Reporting".
				Where 'YOUR_NAME' contains one or more spaces, ie "Your Company" then the name must be encapsulated
				by double quotes "". For example: emailer -fromname "Your Company Name"

-dsn DSN_NAME 			Allows you to specify a dsn other name ir_system to connect to send the emails
				This would be useful if you have several IR configs on the same machine, using different dsns

-excel  			Will enable the emailing of excel attachments.

-c CHARSET			Allows you to specify the character set of the email. Otherwise it is read from the system Database.

-auth N				Where N is the authentication method you would like to use.
				0 - No Authentication (default value)
				1 - PLAIN. Most SMTP servers support it. However, the password is not encrypted during the transfer.
				2 - LOGIN. Nearly all SMTP servers support it. The password is not encrypted.
					Note: Not supported when used with -cdo
				3 - CRAM-MD5. The password is encrypted and protected from cracking.
					Note: Not supported when used with -cdo
				4 - NTLM authentication (also known as Secure Password Authentication). 
					Widely used with Microsoft products and services such as IIS SMTP.
				5 - MSN authentication (alias of NTLM). Used with MSN services.
					Note: Not supported when used with -cdo

-user name@domain.com		The username that the program should use in order to connect to the server if authentication is used. 
				If Specified, will override the setting from the IR Mail Config System Tab

-pass PASSWORD			The password that should be used to authenticate the sending of the email.

-server mail.company.com	Specifies the mail server the program is to connect to.
				Can be set to "" in order to tell cdo to use the IIS SMTP service on localhost.
				If Specified, will override the setting from the IR Mail Config System Tab

-port 25			Specifies the port on the server that the program is to connect to.
				If Specified, will override the setting from the IR Mail Config System Tab

-url http://my_server/ir	Allows you to specify the location of the IR on your intranet.
				If Specified, will override the setting from the IR Mail Config System Tab

-ssl				Use SSL when connecting to smtp server.

-starttls			Use StartTls when connecting to smtp server.
					Note: Not supported when used with -cdo

-nolog				Turn off all logging.

-nomailerlog			Turn off just the mailer components log.
				Use this if you get "Run-time error '55': File Already open",
 				Or If you want a less verbose log

-nounicode			Skip formatting the unicode characters in reports to html compatable.
				This can greatly increase the speed of the program in the case of a very large number of reports.

-configure			Launch the configuration form interface.
				This is useful for testing what authentication your mail server uses.

-cdo				Uses the Collaboration Data Objects SMTP service to send the emails.

-fsend				Forces the sending of all emails. Certain emails are not sent when they are empty or if an error has occured.
				This option will force the emailer to send the emails regardless and can be usefull for debugging.

-oemail	ADDRESS@DOMAIN.TLD	Overides the to addresses of all emails for this session.
				Can be usefull for debugging.

-smtptimeout N			Specifies the connection timeout when connecting to the SMTP mail server, in 'N' seconds.
