Error: The session must be initialized before any operations are possible

Resolving The Problem

To resolve this issue:

1. Select the Mailbox Name in the E-Mail Reader and click on the button Properties.
2. Click on the button Next until the dialog Configure Rational Email Handler displays.
3. Click on the button Configure. The next dialog shows the User, Connection and Database used by the E-Mail Reader to perform actions.
4. Log onto ClearQuest Designer to the same Connection but with another ClearQuest User with Super User Privileges (the default is Admin). Check the Privileges in ClearQuest User Administration for the E-Mail Reader User. It must be an active ClearQuest User and subscribed to the database being monitored by the E-Mail Reader.
5. Check also the Action Controls in the Schema on which the E-Mail Reader database is based on. The E-Mail Reader User must have Permissions on all Actions that can be performed by the E-Mail Reader.
6. Verify that the account for the ClearQuest Mail Service is a specific dedicated account for the Mailreader service. From the Microsoft® Windows® Services Panel, select Properties for the service. Next select This account and enter a local user or a domain user, not the local system account. Reboot the machine after this change and try restarting the Mailreader service.
7. If the E-Mail Reader appears to be setup correctly and the correct accounts are being used with the correct permissions, the issue could be schema related. Verify the admin password being used to create this session. To do the search on "adminsession", simply open the schema and go to Edit/Find in Hooks. If this API method is found, verify the admin password being used to create this session is correct.
8. When verifying the connection, if the E-Mail Reader account is a user account, log in as that user, open the ClearQuest Maintenance Tool, and verify the connection is pointing to the expected database. If not, update the connection profile.