pollForEvents()

Polls an application for changes to business objects.

Syntax

virtual int pollForEvents() = 0; 

Parameters

None.

Return values

An integer that indicates the outcome status of the polling operation. The following return codes are typically used by the pollForEvents() method.

BON_SUCCESS
The poll action was successful.

BON_FAIL
The method failed in polling.

BON_APPRESPONSETIMEOUT
The application is not responding.

For other return values, see doVerbFor()..

Notes

The connector infrastructure calls the pollForEvents() method, at a time interval that you can configure, so that the connector can detect any event in the application that is interesting to a subscriber. The frequency at which the class library calls this method depends on the poll frequency value that is configured by the PollFrequency connector configuration property.

Important:
The pollForEvents() method is an abstract method that you must implement for the connector.
Note:
If your connector executes in parallel-process mode, it uses a separate polling slave process to handle polling.

See also

See also the description of the SubscriptionHandlerCPP class.

Copyright IBM Corp. 1997, 2004