Single-Source Push Connection Get Instance or Shared Connection

Deprecated:

This function is deprecated and will be removed in a future release.
This function enabled management of power consumption by the application code. This is no longer required because of advances in the built-in power management of mobile operating systems and devices.

Call this function to establish, or re-establish, the Push Channel connection with the BlackBerry Dynamics proxy infrastructure Network Operation Center (NOC).

Establishing the connection involves a number of messages being exchanged with the NOC. The onStatus callback in the delegate will be invoked as this progresses.

If mobile data coverage is lost after this function has been called, the Push Channel connection will stop operating. The BlackBerry Dynamics Runtime will automatically attempt to re-establish the Push Channel connection when coverage is regained. The BlackBerry Dynamics Runtime uses the native System Configuration feature to be notified of coverage status.