How to troubleshoot free/busy time calendar lookup issues in an IBM Lotus Domino environment

Article ID: KB17540

Type: Support Content

Last Modified: 04-05-2012

 

Product(s) Affected:

  • BlackBerry Enterprise Server for IBM Domino
Jump to: Environment | Overview
CollapseEnvironment
  • BlackBerry® Enterprise Server for IBM® Lotus® Domino®
CollapseOverview

A BlackBerry® smartphone user that has BlackBerry Device Software version 4.5 and is associated with a BlackBerry® Enterprise Server version 4.1.6 has the option to perform free/busy calendar lookups within other BlackBerry smartphone user's calendars. When a BlackBerry smartphone user performs a free/busy calendar lookup for another user from the BlackBerry smartphone, the user may not receive any information.

Please see the below items if this scenario is occurring

1)  The BlackBerry Enterprise Server is unable to open the free/busy database on the BlackBerry smartphone user's mail server. The Calconn server add-in task must be running on the BlackBerry Enterprise Server.

To verify that this task is running complete the following steps:

Type show task in the IBM® Lotus® Domino® console.
Verify that Calendar Connector is listed as one of the running tasks.
Note: To verify the Calendar connector starts at IBM Lotus Domino startup make sure calconn exists as one of the items listed in the servertasks= line in the IBM Lotus Domino notes.ini.

If the task is not running, the following log may be displayed when the BlackBerry smartphone user performs a free/busy calendar lookup:

[20252] (03/12 02:47:30.060):{0x16D8} {user name/org} SchContainer_GetFirstSchedule API call failed for availability lookup in time range 03/12/2008 02:47:29 AM - 05/09/2008 12:00:00 PM. (No Message Queue with that name. 0x0462)


2)  When the BlackBerry Enterprise Server performs a lookup for a BlackBerry smartphone user, it must query the free/busy database on the searched BlackBerry smartphone user's home mail server.

The free/busy database will be called by one of the following:

busytime.nsf (if the mail server is not a member of a cluster)
clubusy.nsf (if the mail server is part of a cluster)

If the BlackBerry Enterprise Server attempts to perform a free/busy calendar lookup for a BlackBerry smartphone user and it cannot open one of the above databases from the mail server, the free/busy calendar lookup will not be successful and the following log will be displayed:

[20252] (03/07 14:53:00.098):{0x16D8} {user name/org} SchContainer_GetFirstSchedule API call failed for availability lookup in time range 03/09/2008 02:12:34 PM - 05/08/2008 12:00:00 AM. (File does not exist 0x0103)


3)  The BlackBerry smartphone user being searched for free/busy calendar information must have a profile document in either busytime.nsf or clubusy.nsf.

If the BlackBerry smartphone user does not have a profile document in either database on their home mail server the free/busy calendar lookup will fail and the following log will be displayed:

[20252] (03/20 12:34:36.908):{0x16D8} {user name/org} SchContainer_GetFirstSchedule API call failed for availability lookup in time range 03/20/2008 12:34:36 PM - 05/18/2008 08:00:00 AM. (Can't find schedule record for requested user 0x03E8)


4)  The BlackBerry smartphone user is not found in the IBM Lotus Domino domain.

When a free/busy calendar lookup is performed, the BlackBerry Enterprise Server will search for the BlackBerry smartphone user in the IBM Lotus Domino directory. It must do this to find the mail server the BlackBerry smartphone user is on and be able to check the BlackBerry smartphone user's schedule. If a BlackBerry smartphone user cannot be found in the IBM Lotus Domino directory the BlackBerry Enterprise Server will not be able to perform the free/busy calendar lookup. A common reason for this to occur is if the BlackBerry smartphone user is from an external organization. The BlackBerry smartphone will show the searched BlackBerry smartphone user's free/busy calendar lookup information as dimmed and with the comment data unavailable. The following log will be displayed:

[20250] (03/24 11:08:55.000):{0x874} {user/org} Failed to resolve user@othercompany.com for availability lookup. (User or server name not found in Domino Directory 0x0318)


5)  The BlackBerry smartphone user performing the free/busy calendar lookup does not have access to view the searched BlackBerry smartphone user's information.


BlackBerry smartphone users can restrict who can lookup their schedule data in IBM® Lotus Notes®. To see if a BlackBerry smartphone user has restricted who can view their schedule, complete the following steps:

Open the busytime.nsf or clubusy.nsf on the searched BlackBerry smartphone user's mail server.
Right-click and select document properties.
On the second tab look for the allow list field.
By default, all BlackBerry smartphone users can check all schedules. If the BlackBerry smartphone user has restricted this access, a BlackBerry smartphone user must be in the allow list field for a free/busy calendar lookup to be performed. If the BlackBerry smartphone user performing the free/busy calendar lookup does not have this access, the free/busy calendar lookup will fail and no error will be logged. On the BlackBerry smartphone, the searched BlackBerry smartphone user's schedule will appear dimmed with the comment data unavailable.

6)  A busytime.nsf file (or clubusy.nsf in a clustered pair) doesn't exist on the BlackBerry Enterprise Server.

The usual reason for these files to be missing on the BlackBerry Enterprise Server would be the Calconn server add-in task is not running on the server. These files are created. if they do not exist, when calconn is started.

To verify that this task is running complete the following steps:

Type show task in the IBM Lotus Domino console.
Verify that Calendar Connector is listed as one of the running tasks.
Note: To verify the Calendar connector starts at IBM Lotus Domino startup make sure calconn exists as one of the items listed in the servertasks= line in the IBM Lotus Domino notes.ini.

If the busytime.nsf/clubusy.nsf files are missing, the following log line may be displayed on the Domino console when the BlackBerry smartphone user performs a free/busy calendar lookup:

[07/28/2011 06:18:38 AM {Test User/Test} Notes API Error: [In function:'SchSrvRetrieveExt', Reason:'(0x0103) File does not exist LNWrapper call failed for availability lookup in time range 07/28/2011 06:18:38 AM - 09/25/2011 12:00:00 AM.

 

Disclaimer

By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.


Visit the BlackBerry Technical Solution Center at www.blackberry.com/btsc.