Pushing data to multiple recipient addresses
Pushing data to multiple recipient addresses rather than to a BlackBerry user group allows you to cancel, query, or receive result notifications for individual recipients.
However, using multiple addresses can result in large push requests, which has some complications. For example, the Apache Tomcat server limits the total size of the URL and headers in an HTTP request to about 3KB. A BlackBerry push request that adds a large number of recipient addresses to the query string might exceed this limit, causing Tomcat to close the connection. To avoid this issue, the push initiator should push to fewer recipient addresses at a time.
Push requests might be redirected from a centralized push server to other BlackBerry MDS Connection Services for delivery using the BlackBerry push format. As a result, even if the original push request uses the PAP push format, the URL size limitation can cause a redirection error if enough destination addresses require redirection. In this case, the push initiator can either push to fewer recipient addresses at a time, or submit the push request directly to the BlackBerry MDS Connection Service to which the recipient addresses are mapped.
To push data to multiple recipient addresses
Using the PAP push format: Include an <address> element for each intended recipient. The address-value attribute specifies the email address or BlackBerry device PIN for the recipient, along with the ApplicationID.
The following XML indicates that data should be sent to two BlackBerry device users specified by their email addresses (email@example.com and firstname.lastname@example.org):
<address address-value="WAPPUSH=user1%40blackberry%2ecom%5B%3A7874/TYPE=USER@blackberry.net" /> <address address-value="WAPPUSH=user2%40blackberry%2ecom%5D%3A7874/TYPE=USER@blackberry.net" />Note: All non-alphanumeric characters in the device email portion of the address-value attribute, other than "+", "-", ".", or "_" must be URL encoded as hexadecimal values in the PAP control entity.
Using the BlackBerry push format: Include a separate DESTINATION parameter for each recipient email address or BlackBerry device PIN in the query string.
The following URL indicates that the push request should be sent to two BlackBerry device users specified by their email addresses (email@example.com and firstname.lastname@example.org):
Was this information helpful? Send us your comments.