Jump to: navigation, search

x-smpp-response-max-waiting-time

Section: channel-any_name_for_sms
Default Value: 30000
Valid Values: Integer 1000 - 180000
Changes Take Effect: After restart


Specifies in milliseconds, the maximum time the server waits for a response from SMSC for a submitted SMPP message. SMS Server considers the submission to have failed after this waiting time expires.

x-smpp-submit-window-size

Section: channel-any_name_for_sms
Default Value: 10
Valid Values: Integer 1 - 1000
Changes Take Effect: After restart


Specifies the number of messages that the server will send without a confirmation from the SMSC. Once this limit is reached, the server stops sending, and will send new messages only after receiving confirmation of previous messages.

x-smpp-submit-max-rate

Section: channel-any_name_for_sms
Default Value: 10
Valid Values: Integer 1 - 1000
Changes Take Effect: After restart


Specifies the maximum number of messages per second sent by server to SMSC.

x-smpp-sar-max-segments

Section: channel-any_name_for_sms
Default Value: 255
Valid Values: Integer 2 - 255
Changes Take Effect: After restart


Specifies the maximum number of segments used in transmitting long messages to an SMS Center. Outbound messages that exceed this number are rejected by SMS Server and a negative response is sent to the ESP requester.

x-smpp-extraopt

Section: channel-any_name_for_sms
Default Value: No default value
Valid Values: String with TLV options specification
Changes Take Effect: After restart


Specifies default values for extra options used in SMPP PDU. The option value is used by SMS Server to form extra options of PDU, if this value is not specified in ESP requests to SMS Server.

x-smpp-empty-message

Section: channel-any_name_for_sms
Default Value: No default value
Valid Values: Any string
Changes Take Effect: After restart


Specifies replacement text for inbound empty messages. If the option is empty or is not specified, then one blank character is used as a replacement.

SMS Server Administration

This section provides information for SMS Server administrators. In addition to the topics on this page, see also Supported SMPP v3.4 Operations.

SMS Server Handles Empty Messages

SMS provider sometimes delivers empty messages (no text, no payload). These messages must be processed by an agent. To send empty messages to an agent for processing, enter text for the value of the x-smpp-empty-message configuration option. This text will be delivered to an agent as a content of the original empty message.

Important
The text you specify for the x-smpp-empty-message configuration option can optionally be an empty string.

SMS Server Masks Sensitive Data in Logs

To mask sensitive data, perform the following two steps:

  1. Set the logging-filter-active configuration option in the settings section to true, to activate SMS Server specific filtering.
  2. Apply the standard log filtering. Standard log filtering covers Key-Value pairs in User Data of ESP requests, which can contain sensitive information. Use _smsText, Subject, FromAddr, PhoneNumber, and _smsDestNumber Key-Value pairs for filtering. To filter out information in the target Key-Value pair, in the log-filter-data section create an option with the same name as the Key-Value pair (for example, Subject) and set its value to hide or skip.

SMS Server Processes Extra Parameters for PDU

Some SMPP commands (or PDU – Protocol Data Unit) contain a set of optional parameters. Some SMS providers require these optional parameters to correctly process SMPP protocol. SMS Server supports this functionality – you can define PDU's optional parameters on two levels:

  • As a parameter of ESP request – Inside ESP request in a strategy, optional parameters are defined by the Key-Value pair extraopt in Extra optional parameters of Send SMS Out block.
  • As a server option – In the server, optional parameters are defined by the value of the x-smpp-extraopt option in the channel-any_name_for_sms section.

If optional parameters are defined in the ESP request, they are used in PDU. If optional parameters are not defined in the ESP request, they are taken from server option. If optional parameters are not defined in either the ESP request or the server option, PDU is formed without optional parameters.

Whether defined in the ESP request or the server option, optional parameters are defined by the string of the format, as described below.

In SMPP, optional parameters are defined as a triplet (tag, length, value) called the TLV value. SMS Server implements the following format of the string, representing optional parameters:

 tlvItems:
 [
   { tag:<tag value>, typ:<value type (i.e. byte or int or octets or short or strnz or strz) >, val:<value> }
   . . . MORE TLV SPECIFICATIONS SEPARATED BY COMMAS
 ]

A parameter’s type defines encoding and data size placed in PDU:

  • byte is coded as 1-byte integer binary value
  • int is coded as 4-bytes integer binary value
  • octets is coded as a sequence of bytes, specified as a sequence of hex values
  • short is coded as 2-bytes integer binary value
  • strnz is coded as ASCII sequence with a length, defined by the string content without adding a terminating zero byte
  • strz is coded as ASCII sequence ('CString' as in SMPP specification) with a length, defined by the string content with terminating zero byte added

Example:
{tlvItems:[{tag:5121, typ:octets, val:0011aacc00}, {tag:5122, typ:strz, val:abc123}, {tag:5130, typ:strnz, val:abc123}, {tag:5131}]}

Produces:
(extraopt: (oct: (tlv: 5121) 0011aacc00) (oct: (tlv: 5122) 61626331323300) (oct: (tlv: 5130) 616263313233) (oct: (tlv: 5131) ) ) )

SMS Server Supports Message Throttling by Configurable Rate

The SMS service provider might impose limits on the frequency with which they accept SNMP messages.

SMS Server has configurable options that define parameters of communication with SMSC, including an option to control the maximum rate at which messages are sent to the SMS Center:

Retrieved from "https://docs.genesys.com/Documentation:ES:Admin:SMSSrv:8.5.1 (2019-03-21 14:40:28)"
This page was last modified on November 13, 2018, at 06:26.

Feedback

Comment on this article:

blog comments powered by Disqus