Element: <address>

The <address> element specifies the PIN of the BlackBerry® device that is included in a push request, cancellation request, or status query request. The containing element can contain one or more <address> elements. For a push message request, you must include one <address> element for each BlackBerry device that you want to include in the request.

In a push message request, you can specify the attribute and value of address-value="push_all" to push the message to all of the devices that are subscribed in the request.

In a cancellation request or a status query request, the <address> element is optional. If you do not include an <address> element, the request affects all of the BlackBerry devices that are associated with the corresponding request.

Attributes

Attribute

Values

Description

address-value

device_PIN

push_all

This attribute specifies the PIN of the BlackBerry device that an action is performed on (for example, pushing data, cancelling a push request, or querying the status of a push request).

This attribute can have the following values:

  • device_PIN: This value specifies the PIN of the BlackBerry device.
  • push_all: This value specifies all of the BlackBerry devices that are subscribed to the push service.
Previous topic: XML element reference

Was this information helpful? Send us your comments.