Send Query Result in USSD Request Result Process

MATRIXX Engine sends the results of an Unstructured Supplementary Service Data (USSD) query to the subscriber in the Mobile Application Part (MAP) Process-UnstructuredSS-Request result by default.

When a subscriber submits a USSD query request from their handset, the network sends a MAP Process-UnstructuredSS-Request TCAP message to MATRIXX. If the sendAsNotify flag is set to false (this is the default value) in the mtxUssdQueryNotification template, then the query results are returned to the subscriber in the MAP Process-UnstructuredSS-Request result.

USSD Query Processing, Results Sent in USSD Request Result

The USSD query is processed in the following way.

1. The Mobile Switching Center (MSC) sends a USSD query for balance information to MATRIXX Engine in a Mobile Application Part (MAP) Process-UnstructuredSS-Request TCAP message.
2. The USSD incoming service library processes the USSD query and generates an MtxUssdQueryNotification MATRIXX Data Container (MDC). The MDC holds the USSD query in the UssdCode field, and the TCAP OID for the TCAP session. The ActiveMQ gateway delivers the MtxUssdQueryNotification MDC (with attached subscriber balances and general information) to the message broker (ActiveMQ).
3. The Notification Server gets the message from the ActiveMQ notification request queue.
   The Notification Server checks the value of the sendAsNotify flag in the mtxUssdQueryNotification template. When set to:

   • false — The query result is returned in the Process-UnstructuredSS-Request result.
   • true — The query result is sent in a USSD notification.

   In this case, sendAsNotify is set to false.
4. The Notification Server sends the MtxUssdCallOutRequestMsg message to the ActiveMQ USSD request queue. The MtxUssdCallOutRequestMsg MDC includes the USSD properties such as the USSD coding scheme to use.
5. The ActiveMQ gateway receives the MtxUssdCallOutRequestMsg MDC from the ActiveMQ USSD request queue.
6. Based on the configured USSD coding scheme, the USSD service library compresses the notification text and converts it to USSD format. For information about USSD coding schemes, see the 3G TS 23.038 protocol specification.

   Because the sendAsNotify flag is set to false, the USSD incoming service library sends the notification text in USSD format to the Network Enabler in a TCAP END(MAP Process-UnstructuredSS-Request result) message. Based on the SCCP address in the USSD message, Network Enabler sends the TCAP message to the network.

7. The USSD service library returns the MtxUssdCallOutRequest message with the TCAP OID and Notify ID to the ActiveMQ USSD response queue.
8. The Notification Server receives the MtxUssdCallOutRequest message from the ActiveMQ USSD response queue.
9. The Notification Server returns the MtxUssdQueryNotification, and sends it to the ActiveMQ notification response queue.

   A message is written to the system log file recording the Notify ID and TCAP OID for the USSD query result message for correlation purposes.

10. The ActiveMQ gateway gets the message MDC and deletes the notification.

Figure 1 shows how the USSD query is processed:

Process-UnstructuredSS-Request and Result Message Sequence

Figure 2 shows the message flows between the MSC, MATRIXX Engine, and the Notification Server for a USSD query for which the subscriber receives the query results in the Process-UnstructuredSS-Request result message.