Factotum: Documentation Handyman

Ya know, it's actually kinda cool when we use our own products. I'm talking about getting pop-up reminders on your desktop for your Calendar Server appointments. As long as you're running both Calendar Server and Instant Messaging, you can make this happen. And believe it or not, we actually do just that at Sun. Here's how.

To get pop-up reminders, you must have Instant Messaging installed on your network and you must be logged into Instant Messenger. (Instant Messenger can be iconified if you like). With Sun Java Communications Suite 5, the IM configuration wizard configures the iim.conf file for pop-up notifications and there is nothing you need to add to the iim.conf file, unless you want to define an optional password. You still need to modify the Calendar Server ics.conf file and enable calendar reminders in the IM client.

How to do it:

1. Edit the Instant Messaging iim.conf file as shown below, and restart Instant Messaging. (Only required for versions of IM prior to IM 7.2. You can skip the iim.conf configuration steps if running IM 7.2 or later.)

   ! calendar event config
   jms.consumers=cal
   
   jms.providers=ens
   jms.provider.ens.broker=.domain:57997
   jms.provider.ens.factory=com.iplanet.ens.jms.EnsTopicConnFactory
   !
   jms.consumer.cal.destination=enp:///ics/customalarm
   jms.consumer.cal.provider=ens
   jms.consumer.cal.originator=.domain
   jms.consumer.cal.type=topic
   jms.consumer.cal.factory=com.iplanet.im.server.JMSCalendarMessageListener
   jms.consumer.cal.param="eventtype=calendar.alarm"
   iim_agent.enable=true
   iim_agent.agent-calendar.enable=true
   agent-calendar.jid=calimbot..domain
   agent-calendar.password=
   iim_server.components=agent-calendar
   
   *Note: .domain is the fully qualified hostname of the calendar server such as megademo.demo.iplanet.com
   

2. Edit the Calendar Server ics.conf as show belown, and restart Calendar Server.

   caldb.serveralarms = "yes"
   caldb.serveralarms.dispatch = "yes"
   caldb.serveralarms.url = "enp:///ics/customalarm"
   caldb.serveralarms.contenttype = "text/xml"
   caldb.serveralarms.dispatchtype = "ens"
   

3. Click the "Show Calendar Reminders" checkbox in the Instant Messenger client. This is contained in the "Alerts" tab in the Instant Messenger "Settings" popup.