iim.conf Calendar Pop-up Configuration Parameters (Sun Java System Instant Messaging 7 2006Q1 Administration Guide)

Sun Java System Instant Messaging 7 2006Q1 Administration Guide

`iim.conf` Calendar Pop-up Configuration Parameters

When you install Instant Messaging, several configuration parameters used with the Calendar agent are added by default to iim.conf. You can also enable the Calendar agent and provide associated configuration information when you run the configure utility. However, you might want to manually configure pop-ups, for example, if you have customized the resource files for Instant Messenger. If you rerun configure, you will then need to redeploy the resource files. If you choose to manually configure the Instant Messaging server for Calendar pop-ups instead of running the configure utility, you will need to provide values for these parameters. See Chapter 1, Configuring Instant Messaging After Installation for information on the configure utility.

Table 14–1 lists the configuration parameters you will use to configure the Instant Messaging server and the Calendar agent in order to use Calendar pop-ups.

Table 14–1 iim.conf Parameters for Configuring Calendar Pop-ups


Parameter or Section in `iim.conf`	Description and Appropriate Value
JMS Consumers Section
`jms.consumers`	Name of alarm. Set the value to: `cal_reminder`
`jms.consumer.cal_reminder.destination`	Destination of the alarm. This must be the same as the value of the `caldb.serveralarms.url` configuration parameter in the `ics.conf` file. For example, `enp:///ics/customalarm`
`jms.consumer.cal_reminder.provider`	The name of the provider. Set to `ens`. This must be the same as the name in the `jms.providers` parameter in the JMS Providers section.
`jms.consumer.cal_reminder.type`	The type of alarm to set. Set the value to: `topic`
`jms.consumer.cal_reminder.param`	The alarm parameter. Set the value as follows including the quotes: `"eventtype=calendar.alarm"`
`jms.consumer.cal_reminder.factory`	A listener that registers itself for the new calendar reminder messages. Set the value to: `com.iplanet.im.server.JMSCalendarMessageListener` Enter the value on a single line.
JMS Providers Section
`jms.providers`	The name of the provider. Set value to `ens`. This must be the same as the value listed in the JMS Consumers Section for the `jms.consumer.cal_reminder.provider` parameter.
`jms.provider.ens.broker`	Hostname of the ENS and the port number on which the ENS listens for incoming requests. Set to the port specified in the `ics.conf` file parameter `service.ens.port`. The default is 57997. For example: `jms.provider.ens.broker=cal.example.com:57997`
`jms.provider.ens.factory`	Factory class used for creating the topic connection objects. Set the value to: `com.iplanet.ens.jms.EnsTopicConnFactory`
Instant Messaging General Parameters
`iim_agent.enable`	Enables the Calendar agent. Set the value as follows including the quotes: `iim_agent.enable="true"`
`iim_agent.agent-calendar.enable`	Loads a component that enables the Calendar agent. Set the value as follows including the quotes: `iim_agent.agent-calendar.enable="true"`
`agent-calendar.jid`	The JID of the Calendar agent. Set this value as follows: `agent-calendar.jid=calimbot.server.domain`
`agent-calendar.password`	Set this parameter to a password you want the Calendar agent to use to connect to the Instant Messaging server. Set this value as follows: `agent-calendar.password=password`
`iim_server.components`	Set this value as follows: `iim_server.components=agent-calendar`