Detailed Description

This API is part of the BlackBerry Dynamics Push Channel feature. For an overall description of how to use the feature, see under GDPushChannel.

The Push Connection is the container and conduit for the device's Push Channels. An application may open multiple Push Channels; all will be managed within a single Push Connection.

The Push Connection is automatically established during BlackBerry Dynamics authorization processing, and then maintained by the BlackBerry Dynamics Runtime under application control. The application can instruct the runtime to switch the Push Connection off and on.

When instructed to switch off, the SDK will terminate the Push Connection, and suspend its maintenance. When instructed to switch back on, the SDK will re-establish the Push Connection, and resume maintenance.

Switching off the Push Connection might be an option that the application offers to the end user, for example, allowing them to reduce power consumption on the device.

Push Connection functions cannot be called until BlackBerry Dynamics authorization processing is complete.

PUSH CHANNEL NETWORK

The Push Connection is a link between the application and the BlackBerry Dynamics proxy infrastructure Network Operation Center (NOC). The Push Channel is a link between the application and its application server (App Server). There can be more than one Push Channel; the application can receive push communications from more than one App Server. Push Channels are mediated by the NOC, and sometimes other proxy infrastructure elements.

This is shown in the following diagram.

Reference