Manage Learn to apply best practices and optimize your operations.

Troubleshoot Lotus Notes Out of Office (OOO) agent error messages

Troubleshoot the Lotus Notes error: '182 Instance member CONFIGUREMAILAGENTTEXT does not exist' message that occurs when enabling Out of Office agents.

Our help desk recently received several calls from users regarding their Out of Office messages. Lotus Notes users have complained that they enabled their Out of Office agents before a holiday without any issues. However, when they tried to disable the agents, they couldn't. Instead, the Out of Office profile displayed a message similar to that in Figure 1.

Lotus Notes out of office error
Figure 1. Out of Office profile error message.

You might recognize that this is the message that is displayed when a Lotus Notes user has "editor" access to his mail file and tries to enable or disable his out of office agent. With editor access, an administration request enables or disables the agent on behalf of the Lotus Notes user.

It's worth noting that the Lotus Notes users received each this message all day. I could not find any administration request on the Lotus Domino server.

I tried to reproduce the error message on my workstation, but couldn't. However, the message was visible in the user's desktop when viewed remotely. Subsequently, an error message that occurred in the status bar stated:

"Notes error: 182 Instance member CONFIGUREMAILAGENTTEXT does not exist."

I searched the IBM Knowledge Base for CONFIGUREMAILAGENTTEXT and found this technote referring to the out-of-office agent error message that states:

In Lotus Notes, you attempt to enable the Out of Office (OOO) agent in your mail file. The agent does not enable and you notice the following error message in the status bar of the Notes client:

"Notes error: 182 Instance member CONFIGUREMAILAGENTTEXT does not exist."

This issue only occurs for users with Editor access to their mail file and only occurs in Notes, regardless of the mail template design being used. The issue does not occur when using Lotus Domino Web Access (DWA) mail.

Background information

Five days after the holiday, I did a mass change on all Lotus Notes users' mail files to ensure that all access control lists (ACLs) only have editor access with all options set except "can create personal agents." Our company uses Lotus Domino server version 7.0.3 and Lotus Notes client version 7.0.2, with a modified dwa7.ntf mail template. These changes, however, do not affect the Out of Office profile. The IBM technote offered the following hint:

NOTE: The DWA7 client that ships with the Notes/Domino 7.0.2 release is incompatible with all previous versions of Notes.

This raises an important question: Does this affect all previous versions of Lotus Notes, including version 7.0.1? The answer is yes; version 7.0.1 is incompatible with dwa7.ntf, which is shipped with client version 7.0.2. Lotus Notes clients using this version could not disable the OOO agent. A long-term solution is to update these clients as soon as possible.

The technote shows that there is another option. I can grant these clients "designer" access. I used the following code to make the changes in the Domino Directory. I suggest creating a new agent in the Domino Designer, then selecting "all selected documents" from the menu and copying the following LotusScript code into the agent:

Option Public
Option Declare

'Use "OpenLogFunctions"
Sub Initialize
'On Error Goto Errorhandler
Dim ws As New NotesUIWorkspace
Dim session As New NotesSession
Dim db As NotesDatabase
Dim dc As NotesDocumentCollection
Dim doc As NotesDocument
Dim total As Long
Dim docnum As Long

Set db = session.CurrentDatabase

Set dc = db.UnprocessedDocuments
total = dc.Count
docnum = 0

Set doc = dc.GetFirstDocument
While Not doc Is Nothing
docnum = docnum + 1
Call UpdateStatusBar(docnum, total) 
Call ProcessPersonDoc(doc)
Set doc = dc.GetNextDocument(doc)
Wend

Call ws.ViewRefresh
'Exit Sub

Errorhandler:
'Call LogError
'Exit Sub

End Sub

Sub UpdateStatusBar
(x As Long, total As Long)
'This will display the percentage c
omplete in the status bar as the agent runs
 
Print "Working..." 
& Cstr(Round((x / total), 2)*100) & "% done"
 
End Sub

Sub ProcessPersonDoc(doc As NotesDocument)
'On Error Goto stackError
Dim s As New NotesSession
Dim profile As NotesDocument
Dim owner As String
Dim ACL As NotesACL
Dim ACLEntry As NotesACLEntry
Dim nn As NotesName

Dim Maildb As New NotesDatabase
( doc.MailServer(0), doc.MailFile(0) )
If Maildb.IsOpen Then
Print( "Succesfully opened " & Maildb.Title )
Set profile = Maildb.GetProfileDocument("CalendarProfile")
Set nn = s.CreateName ( profile.Owner(0) )
  
Set ACL = MailDB.ACL
Set ACLEntry = ACL.GetEntry ( profile.Owner(0) )
If Not ( ACLEntry Is Nothing ) Then
ACLEntry.Remove
ACL.Save
End If
 
'Set OWNER access to DESIGNER
Set ACLENtry = New NotesACLEntry 
( ACL, profile.Owner(0), 5 )
ACLENtry.CanDeleteDocuments = True
ACLENtry.CanCreateLSOrJavaAgent = True 
ACLENtry.IsPerson = True
ACL.Save
 
End If

EXITPOINT:
'Exit Sub
stackError:
'Call LogError()
'Resume EXITPOINT
End Sub

You can select one or more users and run the agent against their mail files. The agent will read the calendar profiles to determine the mail-file owner, and then it will change the ACL.

About the author: Ulrich Krause a.k.a eknori has been working as administrator and developer with Lotus Notes and Domino since Release 4. Ulrich is the project chief of OpenNTF's project !!HELP!!, an open source helpdesk system for Lotus Notes and Domino. You can contact Ulrich through his blog at http://www.eknori.de.

Do you have comments on this tip? Let us know.

Please let others know how useful it is via the rating scale below. Do you have a useful Lotus Notes, Domino, Workplace or WebSphere tip or code snippet to share? Submit it to our monthly tip contest and you could win a prize.

This was last published in April 2008

Dig Deeper on Lotus Notes Domino Access, Permissions and Authentication

Start the conversation

Send me notifications when other members comment.

By submitting you agree to receive email from TechTarget and its partners. If you reside outside of the United States, you consent to having your personal data transferred to and processed in the United States. Privacy

Please create a username to comment.

-ADS BY GOOGLE

SearchWindowsServer

Search400

  • iSeries tutorials

    Search400.com's tutorials provide in-depth information on the iSeries. Our iSeries tutorials address areas you need to know about...

  • V6R1 upgrade planning checklist

    When upgrading to V6R1, make sure your software will be supported, your programs will function and the correct PTFs have been ...

  • Connecting multiple iSeries systems through DDM

    Working with databases over multiple iSeries systems can be simple when remotely connecting logical partitions with distributed ...

SearchDataCenter

SearchExchange

SearchContentManagement

Close