The WAP Push communication service implements the BEA Extended Web Services WAP Push interface. Although the specific interface is not standardized, it uses standardized elements. For more information on these elements, see “Appendix A: Standards and Specifications” in the Concepts and Architectural Overview, another document in this set.
Using the WAP Push communication service, an application can:
Send a WAP Push message
Send a replacement WAP Push message
Ask to be notified asynchronously of the status of WAP Push messages that have been sent. The possible values returned include:
Rejected: The message was not accepted
Pending: The message is in process
Delivered: The message was successfully delivered to the end-user
Undeliverable: The message could not be delivered because of a problem
Expired: The message reached the maximum age allowed by server policy or could not be delivered by the time specified in the push submission
Aborted: The mobile device aborted the message
Timeout: The delivery process timed out
Cancelled: The message was cancelled through the cancel operation
Unknown: The server does not know the state of the message
Note:
The result notification message is only sent if the initial push submission was accepted for processing. One result notification message is sent per destination address.
Supported Network Protocols
Off the shelf, WAP Push communication services can be configured to support the following network protocols:
When Network Gatekeeper is configured to use this protocol, the EWS WAP Push communication service supports a subset of its operations including:
push-message: Submits a message to be delivered. This operation is also used to send a replacement message
push-response: The response to the push-message operation. This response includes a code specifying the immediate status of the message submission, of the following general types:
1xxx Success: The action was successfully received, understood, and accepted
2xxx Client Error: The request contains bad syntax or cannot be fulfilled
3xxx Server Error: The server failed to fulfil an apparently valid request
4xxx: Service Failure: The service could not be performed. The operation may be retried
resultnotification-message: Specifies the final outcome of a specific message for a specific recipient. Sent only if the initial request includes the URL to which this notification is to be delivered. Includes both textual indication of state and a status code including the following general types:
1xxx Success: The action was successfully received, understood, and accepted
2xxx Client Error: The request contains bad syntax or cannot be fulfilled
3xxx Server Error: The telecom network node failed to fulfil an apparently valid request
4xxx: Service Failure: The service could not be performed. The operation may be retried
5xxx: Mobile Device Abort: The mobile device aborted the operation.
resultnotification-response: The response to the result notification. This response includes a code specifying the status of the notification
1xxx Success: The action was successfully received, understood, and accepted
2xxx Client Error: The request contains bad syntax or cannot be fulfilled
badmessage-response: A response indicating that request is unrecognizable or is of a protocol version that is not supported. This response contains either a 3002 code (Version not supported) or a 2000 code (Bad Request). In the case of a Bad Request, a fragment of the unrecognizable message is included in the response
Configuration Specifics for the WAP Push Communication Service
Communication services share many common features, covered in the “Introducing Communication Services” chapter of Concepts and Architectural Overview, but each one has a few characteristics that are specific only to that service. This section describes those specific features for the WAP Push communication service, including:
There are two WAP Push specific CDRs. They are written:
When the sendPushMessage response returns from the network
When a sendResultNotificationMessage response returns from the application
Event Data Records
The following is a list of EdrIds created by the EWS WAP Push communication service. For more information see Events, Alarms, and Charging.
Table 13-1 Event types emitted by the EWS WAP Push Message communication service
EdrId
Meaning
14001
sendPushMessage
14002
sendResultNotificationMessage
Statistics
The table below outlines the correlation between the methods being invoked from either the application (in application-initiated requests) or the telecom network (in network-initiated requests) and the transaction type collected by the statistics counters in Network Gatekeeper for the Parlay X 2. Multimedia Messaging communication service:
Note:
Method names for network-initiated requests are specified by the internal Gatekeeper name, which is not necessarily the same as the message from the network.
Table 13-2 Transaction types for EWS WAP Push Message communication service
Method
Transaction type
sendPushMessage
TRANSACTION_TYPE_MESSAGE_SENDER_SEND
sendResultNotificationMessage
TRANSACTION_TYPE_MESSAGE_SENDER_NOTIFY
Supported Address Schemes
The EWS WAP Push Message communication service supports the tel: and wapuser: address schemes.