Sun Java System Instant Messaging 7.2 Administration Guide

Agent Parameters

Agents, such as the Calendar agent, enable functionality within the Instant Messaging server and enhance its interoperability with other Sun Java System servers.

Table A–11 lists and describes agent configuration parameters.

Table A–11 Agent Configuration Parameters

Parameter 

Default Value 

Description 

jms.consumers

None 

Used with the Calendar agent. Contains the name of the alarm. The value for this parameter must be set to: 

cal_reminder

jms.consumer.cal_reminder.destination

None 

Used with the Calendar agent. 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

None 

Used with the Calendar agent. The name of the provider. Typically, this is set to ens. The value for this parameter must be the same as the name in the jms.providers parameter.

jms.consumer.cal_reminder.type

None 

Used with the Calendar agent. The type of alarm to set. The value for this parameter must be set to: 

topic

jms.consumer.cal_reminder.param

None 

Used with the Calendar agent. The alarm parameter. The value for this parameter must be set as follows including the quotes: 

"eventtype=calendar.alarm"

jms.consumer.cal_reminder.factory

None 

Used with the Calendar agent. A listener that registers itself for the new calendar reminder messages. The value for this parameter must be set to: 

com.iplanet.im.server.JMSCalendarMessageListener

jms.providers

None 

Used with the Calendar agent. The name of the provider. Typically, you set the value of this parameter to ens. This must be the same as the value for the jms.consumer.cal_reminder.provider parameter.

jms.provider.ens.broker

None 

Used with the Calendar agent. 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 service.ens.port parameter. The default is 57997. For example:

jms.provider.ens.broker=cal.example.com:57997

jms.provider.ens.factory

None 

Used with the Calendar agent. Factory class used for creating the topic connection objects. The value for this parameter must be set as follows. Enter the value on a single line: 

com.iplanet.ens.jms.EnsTopicConnFactory

iim_agent.enable

False

If TRUE, iim.conf, enables Instant Messaging agents. Set the value to FALSE, or remove the parameter from iim.conf to disable all agents.

iim_agent.agent-calendar.enable

None 

Used with the Calendar agent. If TRUE or absent from iim.conf, loads a component that enables the Calendar agent specifically.

agent-calendar.jid

None 

The JID of the Calendar agent.

agent-calendar.password

None 

Defines the password with which the Calendar agent connects to the Instant Messaging server. 

iim_server.components

None 

Describes the Calendar agent as a component of the Instant Messaging server. The value of this parameter must be set to: 

agent-calendar