test

Sun Java System Instant Messaging 7.2 Administration Guide

Configuring Instant Messaging Pop-ups

This section includes the following configuration instructions:

ProcedureTo Configure Instant Messaging Server for Calendar Pop-ups Using the configure Utility

  1. Run configure.

    See Completing the Configuration Checklist for more information about the configure utility.

  2. On the Calendar Agent configuration screen, select the Enable Calendar Agent checkbox.

  3. Enter the Notification Server hostname and port number.

    Use the same port number as the port number specified by the service.ens.port parameter in the ics.conf file on the Calendar Server.

    The values you provide are combined and stored as the value for the jms.provider.ens.broker parameter in iim.conf. For example, if you enter localhost for the hostname and 57997 for the port number, the jms.provider.ens.broker parameter would be set as follows:


    jms.provider.ens.broker=localhost:57997

  4. Enter the Calendar Alarm URL.

    This URL is the destination of the alarm. For example:


    enp:///ics/customalarm

    Use the same URL as the URL specified by the caldb.serveralarms.url parameter in the ics.conf file on the Calendar Server.

    The value you provide is stored as the value for the jms.consumer.cal_reminder.destination parameter in iim.conf.

  5. Click Next and continue with configuration.

    See Chapter 1, Configuring Instant Messaging After Installation for more information about the configure utility.

ProcedureTo Manually Configure Instant Messaging Server for Calendar Pop-ups

Before You Begin

Gather the information in Table 16–1.

  1. Edit one or more of the parameters in the iim.conf file as shown in Table 16–1.

    See iim.conf File Syntax for instructions on locating and modifying iim.conf.

    The parameter values shown assume you want pop-up reminders for both events and tasks. If these parameters do not already exist in iim.conf, add them.

  2. Start the Calendar agent using imadmin.


    imadmin start agent-calendar

    The imadmin command-line utility is located in the following directory:

    im-svr-base/sbin

    Where im-svr-base is the directory in which you installed Instant Messaging.

ProcedureTo Configure Calendar Server for Pop-ups

  1. Log in to the Calendar server host as an administrator with permission to change the configuration.

  2. Change to the cal-svr-base/SUNWics5/cal/config directory.

    Where cal-svr-base is the directory in which you installed Calendar Server.

  3. Save your old ics.conf file by copying and renaming it.

  4. Confirm that the parameters shown in the following table have the values shown. If they do not, you need to modify them.

    Parameter  

    Description and Default Value  

    caldb.serveralarms

    Enables calendar alarms to be queued. The default is "1" (enabled).

    caldb.serveralarms.contenttype

    Output format for alarm content. The default is "text/xml".

    caldb.serveralarms.dispatch

    Enables calendar alarms to be dispatched. The default is "yes".

    caldb.serveralarms.dispatchtype

    The type of server alarm to dispatch. The default is "ens".

    caldb.serveralarms.url

    This is the URL for alarm retrieving alarm contents. The default is "enp:///ics/customalarm".

  5. Save the ics.conf file.

  6. Restart Calendar server.

    cal-svr-base/SUNWics5/cal/sbin/start-cal

    Where cal-svr-base is the directory in which you installed Sun Java System Calendar Server.

ProcedureTo Configure Instant Messenger for Calendar Pop-ups

  1. On the Instant Messenger Main window, select Tools ->Settings.

  2. On the Settings window, click the Alerts tab.

  3. Check the Show Calendar Reminders option.

  4. Click OK.

    Users can now receive Calendar pop-ups through Instant Messenger while they are online.