Reference section - SMPP
Message Submission TLVs
SMPP Message Submission TLVs
Message Submission Request TLVs
This section lists TLVs that may be used for message submission operations.
TLV Name | Description | Ref. |
alert_on_msg_delivery | Request an MS alert signal be invoked on message delivery. | 4.8.4.2 |
billing_identification | Billing information passed from ESME to MC. | 4.8.4.3 |
callback_num | A call-back number associated with the short message. This parameter can be included a number of times for multiple call-back addresses. | 4.8.4.15 |
callback_num_atag | Associates a displayable alphanumeric tag with the call-back number. If this parameter is present and there are multiple instances of the callback_num parameter then this parameter must occur an equal number of instances and the order of occurrence determines the particular callback_num_atag which corresponds to a particular callback_num. | 4.8.4.16 |
callback_num_pres_ind | Defines the call-back number presentation and screening. If this parameter is present and there are multiple instances of the callback_num parameter then this parameter must occur an equal number of instances and the order of occurrence determines the particular callback_num_pres_ind which corresponds to a particular callback_num. | 4.8.4.17 |
dest_addr_np_country | E.164 information to the operator country code. | 4.8.4.20 |
dest_addr_np_information | Number portability information for the destination address. | 4.8.4.21 |
dest_addr_np_resolution | Number portability query indicator. | 4.8.4.22 |
dest_addr_subunit | The subcomponent in the destination device for which the user data is intended. | 4.8.4.23 |
dest_bearer_type | The correct bearer type for delivering the user data to the destination. | 4.8.4.24 |
dest_network_id | Identification of destination network. | 4.8.4.25 |
dest_network_type | The correct network for the destination device. | 4.8.4.26 |
dest_node_id | Identification of destination node. | 4.8.4.27 |
dest_subaddress | The sub-address of the message destination. | 4.8.4.28 |
dest_telematics_id | The telematics identifier associated with the destination. | 4.8.4.29 |
dest_port | Indicates the application port number associated with the destination address of the message. This parameter should be present for WAP applications. | 4.8.4.30 |
display_time | Provides the receiving MS with a display time associated with the message. | 4.8.4.31 |
its_reply_type | The MS user’s reply method to an SMS delivery message received from the network, is indicated and controlled by this parameter. | 4.8.4.33 |
its_session_info | Session control information for Interactive Teleservice. | 4.8.4.34 |
language_indicator | Indicates the language of an alphanumeric text message. | 4.8.4.35 |
message_payload | Contains the extended short message user data. Up to 64K octets can be transmitted. Note: The short message data should be inserted in either the short_message or message_payload fields. Both fields should not be used simultaneously. The sm_length field should be set to zero if using the message_payload parameter. Note: In the case of data_sm, the message_payload TLV is the only means of specifying text. | 4.8.4.36 |
more_messages_to_send | Indicates that there are more messages to follow for the destination SME. | 4.8.4.38 |
ms_msg_wait_facilities | This parameter controls the indication and specifies the message type (of the message associated with the MWI) at the mobile station. | 4.8.4.40 |
ms_validity | Indicates validity information for this message to the recipient MS. | 4.8.4.41 |
number_of_messages | Indicates the number of messages stored in a mail box. | 4.8.4.43 |
payload_type | Defines the type of payload (e.g. WDP, WCMP, etc.). | 4.8.4.44 |
privacy_indicator | Indicates the level of privacy associated with the message. | 4.8.4.45 |
qos_time_to_live | Time to live as a relative time in seconds from submission. | 4.8.4.48 |
sar_msg_ref_num | The reference number for a particular concatenated short message. | 4.8.4.46 |
sar_segment_seqnum | Indicates the sequence number of a particular short message fragment within the concatenated short message. | 4.8.4.49 |
sar_total_segments | Indicates the total number of short message segments within the concatenated short message. | 4.8.4.50 |
set_dpf | Indicator for setting Delivery Pending Flag on delivery failure. | 4.8.4.52 |
sms_signal | Indicates the alerting mechanism when the message is received by an MS. | 4.8.4.53 |
source_addr_subunit | The subcomponent in the destination device, which created the user data. | 4.8.4.54 |
source_bearer_type | The correct bearer type for delivering the user data to the destination. | 4.8.4.55 |
source_network_id | Identification of source network. | 4.8.4.56 |
source_network_type | The correct network associated with the originating device. | 4.8.4.57 |
source_node_id | Identification of source node. | 4.8.4.58 |
source_port | Indicates the application port number associated with the source address of the message. This parameter should be present for WAP applications. | 4.8.4.59 |
source_subaddress | The sub-address of the message originator. | 4.8.4.60 |
source_telematics_id | The telematics identifier associated with the source. | 4.8.4.61 |
user_message_reference | ESME assigned message reference number. | 4.8.4.62 |
user_response_code | A user response code. The actual response codes are implementation specific. | 4.8.4.63 |
ussd_service_op | This parameter is used to identify the required USSD Service type when interfacing to a USSD system. | 4.8.4.64 |
Message Submission Response TLVs
The following table contains TLVs that can be returned in a submit_sm_resp or data_sm_resp PDU. All TLVs are relevant to transaction message mode only (ref. 4.2.10.4).
TLV Name | Description | Ref. |
additional_status_info_text | ASCII text giving a description of the meaning of the response. | 4.8.4.1 |
delivery_failure_reason | Include to indicate reason for delivery failure. | 4.8.4.19 |
dpf_result | Indicates whether the Delivery Pending Flag was set. | 4.8.4.32 |
network_error_code | Error code specific to a wireless network. | 4.8.4.42 |
SMSC Simulator
Looking to test your SMS application or SMS-enabled application before connecting to a live SMS gateway or SMSC? Our SMSC Simulator service allows you to test using the SMPP protocol v3.3, v3.4 and v5. Read more about SMSC Simulator >
SMPP Client
Test an SMPP account and service using the Melrose Labs SMPP Client . Use from your web browser. No software installation necessary.