Nortel Networks Broadcast Server warranty DistributionList Request, Member, page

Appendix A Push XML API

Push XML API Operation

DistributionList Request

The Push XML API enables you to push an alert to specific devices and/or distribution lists. A distribution list is composed of subscribers, which are IP phones that have registered with the Application Gateway. When an IP phone registers with the Application Gateway, the Application Gateway notifies your application about the new subscriber, as described in “Subscribers Response,” page 63. You can then use your application to create distribution lists from the subscriber information.

The Application Gateway uses the DistributionListRequest element to maintain the distribution lists specified with PushMessage. To send more than one DistributionListRequest, you wrap the elements in a ManageDistributionLists element.

The DistributionListRequest element attributes specify a name for the distribution list and the action that the Application Gateway is to perform on the list: create a new list, add or remove devices, and remove the list.

The following DistributionListRequest child element defines the distribution list:

Member, page 62

Note See “ManageDistributionLists,” page 68 for a detailed explanation of the XML.

Member

One or more Member elements can be included in a DistributionListRequest element. The Member element has one attribute that specifies the device ID (that is, the MAC address of the phone).

62Broadcast Server User Guide