|
|
This chapter describes the supported native interfaces and contains information that is specific for Oracle Communications Services Gatekeeper, and not found in the specifications. For detailed descriptions of the interfaces, methods and parameters, refer to the specifications.
The MM7 specification can be found at http://www.3gpp.org/ftp/Specs/html-info/23140.htm. Messages are compliant with the schema defined by Rel-5-MM7-1-2.xsd. Because the network-facing interface supports Rel-5-MM7-1-5.xsd, Rel-5-MM7-1-2.xsd and a modified version of REL-5-MM7-1-0.xsd, some mapping may be done during processing.
The endpoint for this interface is: http://<host>:<port>/mm7/Mms
where values for host and port depend on the Oracle Communications Services Gatekeeper deployment.
| Note: | The MM7 facade uses HTTP basic authentication, username/password. The username is the application instance ID. |
Sends an application-initiated multimedia message
Oracle Communications Services Gatekeeper delivers a network-triggered message to the application, at an endpoint implemented by the application.
Oracle Communications Services Gatekeeper delivers a delivery report on a previously sent message to the application, at an endpoint implemented by the application.
Oracle Communications Services Gatekeeper delivers a read reply report on a previously sent message to the application, at an endpoint implemented by the application.
The Native SMPP Service Facade exposes SMPP version 3.4 to applications.
The specification ha the title Short Message Peer to Peer, Protocol Specification v3.4, Document Version:- 12-Oct-1999 Issue 1.2 and can be downloaded from http://smsforum.net/
It supports all Protocol Data Units (PDUs), and all header and body elements except when stated otherwise.
An application using this interface acts as an External Short Message Entity (ESME).
An application must bind to the Native SMPP Communications Service. It can bind using:
As a result of a bind operation, Oracle Communications Services Gatekeeper authenticates the application and a session established.
The following is valid for all bind operations:
Oracle Communications Services Gatekeeper Native SMPP Communication Service can be configured to allow only a certain number of sessions per application.
A session is maintained until the application sends an unbind PDU.
Oracle Communications Services Gatekeeper can be configured to terminate a session if:
All errors are reported in the command_status field of a response PDU.
Table 11-2 lists the error codes that are specific for Oracle Communications Services Gatekeeper. Errors from the SMSC are transparently forwarded to the application.
The application binds as an SMPP transmitter to Oracle Communications Services Gatekeeper.
Oracle Communications Services Gatekeeper Native SMPP Communication Service can be configured to:
Oracle Communications Services Gatekeeper sends this PDU to an application as a response to bind_transmitter PDU.
The application binds as an SMPP receiver to Oracle Communications Services Gatekeeper.
The address_range field must be the same as provisioned for the application instance group.
Oracle Communications Services Gatekeeper Native SMPP Communication Service can be configured to:
Oracle Communications Services Gatekeeper sends this PDU to an application as a response to bind_receiver PDU.
The application binds as an SMPP transceiver to Oracle Communications Services Gatekeeper.
address_range field must be the same as provisioned for the application instance group.
Oracle Communications Services Gatekeeper Native SMPP Communication Service can be configured to:
Oracle Communications Services Gatekeeper sends this PDU to an application as a response to bind_transceiver PDU.
The application unbinds from Oracle Communications Services Gatekeeper.
Oracle Communications Services Gatekeeper sends this PDU to an application as a response to unbind PDU.
Oracle Communications Services Gatekeeper sends this PDU as a negative acknowledgement of a PDU sent from the application if the PDU can not be recognized.
If this PDU is sent from the application, it is propagated to the SMPP SMSC.
The application sends a short message to Oracle Communications Services Gatekeeper, which forwards it to the destination address via an SMSC.
Oracle Communications Services Gatekeeper sends this PDU to an application as a response to submit_sm PDU.
The application sends a short message to Oracle Communications Services Gatekeeper, which forwards it to a set of destination addresses via an SMSC.
Oracle Communications Services Gatekeeper sends this PDU to an application when as a response to submit_multi PDU.
Oracle Communications Services Gatekeeper sends this PDU to an application when a network-triggered short message that matches the destination addresses that the application has subscribed for notifications on has been received by Oracle Communications Services Gatekeeper from an SMSC. The PDU contains the short message.
The application sends this PDU to acknowledge the reception of a deliver_sm PDU.
The application sends this PDU to query the status of a previously sent short message.
Oracle Communications Services Gatekeeper Native SMPP Communication Service can be configured to allow or block this operation.
Oracle Communications Services Gatekeeper sends this PDU to an application as a response to query_sm PDU.
The application sends this PDU to cancel the sending of one more previously sent short messages, given that the message has not yet been delivered to the end-user terminal.
Oracle Communications Services Gatekeeper Native SMPP Communication Service can be configured to allow or block this operation.
Oracle Communications Services Gatekeeper sends this PDU to an application as a response to cancel_sm PDU.
The application sends this PDU to replace a previously sent short message with the short message provided in this PDU, given that the message has not yet been delivered to the end-user terminal.
Oracle Communications Services Gatekeeper Native SMPP Communication Service can be configured to allow or block this operation.
Oracle Communications Services Gatekeeper sends this PDU to an application as a response to replace_sm PDU.
The application, or Oracle Communications Services Gatekeeper, sends this PDU to verify the connection between the application and Oracle Communications Services Gatekeeper.
Oracle Communications Services Gatekeeper Native SMPP Communication Service can be configured to send this PDU to the application on a regular interval. When an application receives this PDU it must respond with enquire_link_resp PDU within a certain time-interval. This time-interval is configurable in Oracle Communications Services Gatekeeper Native SMPP Communication Service.
Oracle Communications Services Gatekeeper, or an application, sends this PDU as a response to enquire_link PDU.
|