This chapter describes the Oracle Communications Services Gatekeeper interfaces in the supported SOAP Native facade and contains information specific to Services Gatekeeper not found in the specifications.
The MM7 specification is available from the 3GPP website:
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 are the host name and port of the system on which Services Gatekeeper is installed.
Note:
The MM7 interface uses HTTP basic authentication, username/password. The username is the application instance ID.Services Gatekeeper supports the following MM7 operations:
Sends an application-initiated multimedia message
Error code | Reason/Action |
---|---|
4006 |
Service unavailable. Communication error within Services Gatekeeper or between Services Gatekeeper and the MMSC Transient error. The client should try again. |
4007 |
Service denied. The request was not allowed by policy. Contact the Services Gatekeeper administrator. |
<all MMSC fault codes> |
Passed along transparently Contact the Services Gatekeeper administrator. |
Services Gatekeeper delivers a network-triggered message to the application, at an endpoint implemented by the application.
Not supported.
Not supported
Services Gatekeeper delivers a delivery report on a previously sent message to the application, at an endpoint implemented by the application.
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 communication service exposes SMPP version 3.4 to applications.
The specification is the Short Message Peer to Peer, Protocol Specification v3.4, Document Version:- 12-Oct-1999 Issue 1.2. It can be downloaded from
The native SMPP communication service supports all Protocol Data Units (PDUs) for SMPP version 3.4, and all header and body elements except when stated otherwise.
The native SMPP communication service also supports the billing identification parameter in the format defined by SMPP Specification 5.1, section 4.8.4.3. This parameter works with SMPP 5.1 SMSCs. Services Gatekeeper supports it as a tunneled parameter named smpp_billing_id. It also supports the ussd_service_operation parameter, which was expanded to support the deliver_sm opration in SMPP 5.1. Services Gatekeeper supports it as a tunneled parameter named ussd_service_operation. For details about these tunneled parameters, see the discussion on the Tunneled Parameters for Parlay X 2.1 Short Messaging / SMPP in Services Gatekeeper Communication Service Reference Guide.
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, Services Gatekeeper authenticates the application and establishes a session.
The following is valid for all bind operations:
An application binds using host name or IP address and port that depends on the installation. The server to bind to is a network tier server.
The system_id field must be the application instance group ID assigned to the application instance.
The password field must be the same as the password for the application instance group.
A session is maintained until the application sends an "unbind PDU".
Services Gatekeeper can be configured to allow a limited number of sessions per application through the maxSession parameter of the addApplicationSpecificSettings operation. See Services Gatekeeper Communication Service Reference Guide for information about this operation.
Services Gatekeeper can be configured to terminate a session if:
The session is inactive. See the InactivityTimerValue in Services Gatekeeper Communication Service Reference Guide.
The application takes too long time to respond to a request. See the RequestTimerValue in Services Gatekeeper Communication Service Reference Guide.
All errors are reported in the command_status field of a response PDU.
Table 30-2 lists the error codes that are specific for Services Gatekeeper. Errors from the SMSC are transparently forwarded to the application.
Table 30-2 Error Codes for SMPP Communication Service
SMPP PDU | Error Code in Response(command_status) | Description |
---|---|---|
bind_transmitter |
ESME_RBINDFAIL |
Could not bind. |
bind_receiver |
ESME_RBINDFAIL |
Could not bind. |
bind_transceiver |
ESME_RBINDFAIL |
Could not bind. |
submit_sm |
ESME_RTHROTTLED |
Throttling limit or quota limit exceeded. The application has performed too many requests per time unit and has exceeded the Service Level Agreement. |
N/A |
ESME_RSUBMITFAIL |
Could not submit the message. Possible reasons include time-out encountered when sending the message and configuration error. |
submit_sm_multi |
ESME_RTHROTTLED |
Same as for submit_sm. |
N/A |
ESME_RSUBMITFAIL |
Same as for submit_sm. |
The following operations are supported or not supported as indicated.
The application binds to Services Gatekeeper as an SMPP transmitter.
Services Gatekeeper sends this PDU to an application as a response to "bind_transmitter PDU".
The application binds as an SMPP receiver to Services Gatekeeper.
The address_range field must be the same as provisioned for the application instance group in the addressRange parameter to the addApplicationSpecificSettings operation. See Services Gatekeeper Communication Service Reference Guide for information about this operation.
Services Gatekeeper sends this PDU to an application as a response to "bind_receiver PDU".
The application binds as an SMPP transceiver to Services Gatekeeper.
The address_range field must be the same as provisioned for the application instance group in the addressRange parameter to the addApplicationSpecificSettings operation. See Services Gatekeeper Communication Service Reference Guide for information about this operation.
Services Gatekeeper sends this PDU to an application as a response to "bind_transceiver PDU".
The application unbinds from Services Gatekeeper.
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 Services Gatekeeper, which forwards it to the destination address using an SMSC.
Services Gatekeeper sends this PDU to an application as a response to "submit_sm PDU".
The application sends a short message to Services Gatekeeper, which forwards it to a set of destination addresses using an SMSC.
Services Gatekeeper sends this PDU to an application as a response to "submit_multi PDU".
Services Gatekeeper sends this PDU to an application upon receiving from an SMSC a network-triggered short message that matches the destination addresses that the application is interested in. The PDU contains the short message.
The application expresses interest by subscribing for notifications addressed to specific destination addresses.
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.
The communication service can be configured to allow or block this operation through the subsequentOperationsAllowed parameter to the addApplicationSpecificSettings operation.
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, if the message has not yet been delivered to the end-user terminal.
The communication service can be configured to allow or block this operation through the subsequentOperationsAllowed parameter to the addApplicationSpecificSettings operation.
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, if the message has not yet been delivered to the end-user terminal.
The communication service can be configured to allow or block this operation through the subsequentOperationsAllowed parameter to the addApplicationSpecificSettings operation. See Services Gatekeeper Communication Service Reference Guide for information about this operation.
Services Gatekeeper sends this PDU to an application as a response to "replace_sm PDU".
The application or Services Gatekeeper sends this PDU to verify the connection between the application and Services Gatekeeper.
The 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 the configured time-interval. See the EnquireLinkTimerValue attribute for the native SMPP plug-in in Services Gatekeeper Communication Service Reference Guide.
Services Gatekeeper or an application sends this PDU as a response to "enquire_link PDU".
The universal computer protocol (UCP) communication service complies with the Short Message Service Centre EMI-UCP Interface 5.1 specification.
The following errors are reported to the application or the SMSC in the UCP NACK PDU under the conditions described.
The UCP service has received something in suspended mode.
The UCP service has received an openSession request on a connection that has already received an openSession request and has processed an OK response to it. Further openSession requests are not allowed.
The UCP service has received an openSession request on a connection where it is currently processing an openSession request.
All SMSCs have responded with NACK to an openSession request.
The UCP service has received a session management operation on a client-side connection.
The UCP service has received a session management operation that is not of the openSession subtype.
The UCP service has received an operation that it does not understand or support on a server-side connection.
The UCP service has received an operation that it does not understand or support on a client-side connection.
The UCP service received an exception when trying to deliver a PDU that was received on a server-side connection to a plug-in.
The UCP service received an exception when trying to deliver a PDU that was received on a client-side connection to a plug-in.
Any errors triggered in the SMSC are propagated to the application. See the Short Message Service Centre EMI-UCP Interface 4.6 specification for a list of those error codes.
This section describes the native UCP operations in the NativeUCPPluginNorth interface.
Sends a mobile-terminated SMS.
Signature:
submitSM(UcpPDU submitSMPDU, ServerPort sourceServerPort, String sourceConnectionId)
Opens a new UCP session.
Signature:
openSession(UcpPDU openSessionPDU, ServerPort sourceServerPort, String sourceConnectionId)