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 16–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 16–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 agents for Instant Messaging. By default, this parameter is set to False. 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 |