Element: <address>

Search This Document

Download PDF

Valid parent	`<push-message>, <resultnotification-message>, <statusquery-message>, <statusquery-result>, <cancel-message>, <cancel-response>, <subscriptionquery-message>, <subscriptionquery-detail>`
Valid children	—

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.

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.