Running a BlackBerry Response Application Engine Process

The BlackBerry Response program processes email messages that have been returned from BlackBerry devices. Typically, users set up the BlackBerry Response program to run automatically every few minutes within the process scheduler. The run frequency depends on the individual installation and on the amount of expected traffic of BlackBerry pager email responses.

To perform a BlackBerry response from a run control page:

1. Select PeopleTools, Workflow, Notifications, Process Blackberry Responses.

2. Add a new run control ID.

3. Set the node field name to MCF_GETMAIL.

4. Click the Run button.

Possible Errors Encountered

The BlackBerry Response program processes only email messages that contain the GUID in the subject line. All other emails are ignored and will be left in the POP3 server. The presence of the GUID indicates that the email message is a BlackBerry pager response.

If the program encounters unexpected conditions while running, it logs error information for each email message and the error count increments:

• Find the error count in the Message Catalog for each run of the program.

• Find the error details in the BlackBerry error log, accessible from the BlackBerry Error Log component.

  This component enables users to identify unprocessed BlackBerry pager response email messages. Search for errors by the run process ID of the BlackBerry Pager Response program. The page shows the error condition that was encountered.

Some errors (error numbers 200−299) cause the program to terminate abnormally. If this happens, restart the program to process email messages that were left unfinished. This table describes the errors:

Error	Description
101	No row was found in table PS_PT_WF_NOTFYGUID. This table should always contain a row for the GUID being processed.
102	The email ID of the response email message was not found as a user ID in table PS_PT_WF_NOTFY_TBL.
103	No email ID was found for the current OPRID.
104	The response returning in the email message was not found in the template.
105	No row was found in PS_PT_WF_NOTFY_TBL for the current GUID.
202	The node name was left blank or was invalid in the run control of the program.
203	The call to Synchrequest failed. Unable to connect to the POP3 connector or the POP3 server.
204	An email message with a valid GUID did not return from the POP3 connector with a unique identification listing (UIDL). Normally, the POP3 server always returns a UIDL for each email message. If the POP3 server does not offer a UIDL, BlackBerry Pager Response processing cannot function. This is a requirement.
205	Failed to delete the email message from the POP3 server.