IBM Support

Using email notifications in 10.1.1 IBM Cognos TM1 Applications

Product documentation


In 10.1.1, you can send automated email to users when you take certain actions on your applications.


Email notifications

You can add workflow email notifications to IBM® Cognos® TM1® applications.

To use email notifications

Attention: If you install Cognos TM1 the Cognos BI Runtime solely in support of workflow email notifications, you must provide a supported RDBMS instance, for example DB2, SQL Server or Oracle, to use as a Content Store. Alternatively, the Cognos Content Store based on Apache Derby may be used as a test environment. Apache Derby is not provided with the Cognos BI Runtime that Cognos TM1 users can access, and should not be used for Production systems.

Prerequisites for using email notifications
  • The relevant Cognos TM1 Applications gateway components installed on the Cognos BI Server, and configured correctly, as described in the IBM Cognos TM1 Installation and Configuration Guide. Edit the planning.html file in c10_install_location\webcontent to point to the location of the Cognos TM1 Application Server, for example,
Configuring email notifications

1. Ensure that the Cognos TM1 instance of Cognos Configuration is set to point to a valid Cognos C10 BI server.
2. If you want to have workflow email notifications sent by email in addition to the notifications that will be sent to the user Inbox in Cognos Connection, ensure that a mail server is configured in the Cognos C10 instance of Cognos Configuration:
3. Stop the TM1 Applications Server.
4. Enter the following tag in the pmpsvc_config.xml file for the Cognos TM1 Application Server:

<notifications emailProvider="HTS"/>

so that it looks like the following example.

Replace the specific names here with your system names and do not break the lines when entering them:

<?xml version="1.0" encoding="UTF-8"?>
<pmpsvc_config xmlns:xsi="http://"
<config class=""/>
<service name="PMPService">
<method name="setClients" sessionOptional="true"/>
<!-- Uncomment the line below to change the location of the
planning service application files -->
<!--appdef path="Location of
planning service application files" /-->
<notifications emailProvider="HTS">
<client id="thinClient" type="html-new" uri="http://">
<localeText default="true" locale="en_US" text="TM1 Application Web"/>
<client id="desktopClient" type="cognos-rcp"
<localeText default="true" locale="en_US" text="Cognos Insight - Connected"/>
<client id="distributedClient" type="cognos-rcp" uri="servlet/CogrcpServlet">
<localeText default="true" locale="en_US" text="Cognos Insight - Distributed"/>
5. Re-start the Cognos TM1 Application Server.
6. To see the notifications setting, use Cognos TM1 Performance Modeler on the application.

The notification settings display near the bottom of the list of Properties. By default, notifications are configured for the Submit and Reject workflow actions.

Changing the notifications

To change a notification setting:

1. Click the Notifications row in the Properties file then click the ellipses. The Notifications Setting dialog lists the actions and the current values for each kind of Notification.

2. Re-deploy the Application for changes to the notification settings to take effect.

Remember: Authentication sources such as Active Directory or LDAP will likely have the email address field populated automatically. It is possible to use an authentication source such as NTLM that has no native email field, and to add the email address from the user’s preferences in Cognos Connection.

Users without email addresses will still receive notifications via the Inbox.

Depending on the settings you chose, an action taken on the application such as Reject or Submit, will now generate an email notification to the appropriate owners of the nodes affected by that action.

Reading the notifications

However it is accessed, it is the same underlying Inbox. This is also the Inbox where any Cognos BI-related notifications are sent.

Changing the language used for the notification

You can change the language used for the notification by identifying the language and the translated text in the Applications Properties page.

1. In the Cognos TM1 Applications page, select the Application to use.
2. Click the Properties icon.
3. Click the workflow action you want to use. Only the actions that can use notifications are available.

4. On the Notifications tab, change the language setting, the subject, and the text of the notification to use translated text here. Then copy and paste the translated notifications message into the message area.

CAUTION: Do not alter or remove the metadata tags such as <Current Owner> or <Application Link>. Do not translate those tags.

Document information

More support for: Cognos TM1

Software version: 10.1.1

Operating system(s): Windows

Reference #: 7035837

Modified date: 05 July 2016