Changing the Message ID Format in the SMPP Delivery Notifications

Overview

At times you may want to change the format of message IDs in SMSC delivery responses. For example, the message ID in SMSC delivery responses are displayed in the decimal format, and you want them to be displayed in the same format as in the submit_sm responses, which is hexadecimal. This article describes how to change the message ID format in the SMSC/SMPP delivery notifications.

Information 

The hubsmppv34notificationtextformat field in the semi-static configuration file (common_config.txt) defines how the HUB will handle and display message IDs in the SMPP (v3.4 and later) delivery notifications. Here is the list of available values for this field:

• notext: No text is used in delivery notifications (NULL value).
• emptyidonexcessdigits: When the message ID exceeds 10 digits, the id field is left empty.
• truncate: When the message ID exceeds 10 digits (in hex format), it is truncated to 8 hex digits and presented as a decimal value. If the message ID is not numeric, the id field is left empty. This is the default option.
• decimal: The id field contains the decimal value of the message ID (can contain more than 10 digits). If the message ID is not numeric, the id field is left empty.
• hex: The id field contains the hexadecimal value of the message ID (can contain more than 10 digits). If the message ID is not numeric, the id field is left empty.
• transparent: The message ID (hex or ASCII) is displayed in the id field without any modifications.

Process

Once you have selected the value you want to configure, you need to make the changes in the semi-static configuration file and make them consistent for all nodes.

1. Make a backup of the common_config.txt file that is located in the following directory:
   /usr/TextPass/etc

2. Open the common_config.txt file.

3. Search for the hubsmppv34notificationtextformat attribute and change its value to the desired one.
   For example, if you do not want the message IDs to be modified, you can change the value in the following way:

   hubsmppv34notificationtextformat="transparent"

4. Validate the common_config.txt file by running the following command:

   $ tp_config --validatecommonconfig common_config.txt

5. Go to each of the Traffic Element nodes (including all instances if applicable) and restart the TextPass process to apply changes:

   tp_stop --textpass
   tp_start --textpass

6. After the restart, verify that the parameter has the correct value by running the following command:

   $ tp_walk hubsmppv34notificationtextformat

Back to top