The way in which an SMTP mail server handles
errors can differ depending on your mail server implementation. For
this reason, you can customize the actions that the delivery service
should take when it encounters specific errors by setting up SMTP
rules in an XML file.
A set of default
rules for error-handling is stored in a sample file provided with IBM® Cognos® software.
To customize the rules, you should create a copy of this file and
amend it. You then configure the delivery service to use this file.
Procedure
- Copy the c10_location\configuration\smtpRules-sample.xml
file to the c10_location\webapps\ p2pd\WEB-INF\classes folder.
Note: To use your own file rather than a copy of
the sample file, copy it to the same folder.
- If you are using the sample file, rename the copied file
to smtpRules-custom.xml.
- Open the required file in an XML or text editor.
- Amend the file to customize the rules.
- Start IBM Cognos Connection.
- Click Launch, IBM Cognos
Administration.
- On the Status tab, click System.
- From the All Servers drop-down menu,
click Services, Delivery.
- From the drop-down menu next to DeliveryService,
click Set properties.
- Click the Settings tab.
- Next to Environment, click Edit.
- In the Parameter column, type the
parameter name smtp.rules.properties.location.
- In the Value column, type the name
of the customized xml file you are using.
- In the Parameter column, type the
parameter name smtp.rules.properties.reread.
Although not mandatory, it is useful to set this parameter
for testing purposes so that the SMTP rules are read for every request.
- In the Value column, type true.
- Click OK.
- In the Set properties page, click OK.
When you have finished testing the rules, you must reset
the smtp.rules.properties.reread parameter.
- Repeat steps 5 to 11 to access the advanced settings.
- In the Value column for the smtp.rules.properties.reread
parameter, type false.
- Click OK.
