CCBS Control Tutorial

This tutorial describes how to control the Call Completion to Busy Subscriber (CCBS) service in a call.

The GSM network (CCBS) supplementary service repeatedly calls a destination that is busy at the time of the initial call attempt.

  1. Use RMobileCall::ActivateCCBS() to activate the CCBS service. This can be used on a call whose call set-up request has failed because the remote number is busy, as indicated by its RMobileCall::KCapsActivateCCBS capability being set.
  2. Use RMobileCall::RejectCCBS() to specify that CCBS is not required on a failed call setup. The TSY can tell the network that CCBS is not used and the network can stop all the related timers. If this function is not used, the CCBS eventually times out.
  3. Use RMobilePhone::NotifyCCBSStatusChange() to detect when the remote number becomes free if the CCBS is active.
  4. Use RMobilePhone::AcceptCCBSRecall() to call the remote number.
  5. Do not post the RMobilePhone::NotifyCCBSStatusChange() request until RMobileCall::ActivateCCBS() is complete.
  6. Use RMobilePhone::DeactivateCCBS() to deactivate a previously activated CCBS request.

Note that status information for CCBS requests is provided by RMobilePhone.