SMPP Protocol

The SMPP protocol options are associated with the use of the SMPP protocol
over TCP/IP. The options with names beginning with the string “ESME_” serve to identify the MTA when it acts as an External Short
Message Entity (ESME); that is, when the MTA binds to an SMPP server in order
to submit SMS messages to the server’s associated SMSC. These options
are described in Table 4–36.

Table 4–36 SMS Channel Options: SMPP Protocol

Option

Description

ESME_ADDRESS_NPI (Integer, 0-255)

ESME NPI to specify when binding to the SMPP server. By default, bind
operations specify an ESME NPI value of zero indicating an unknown NPI. With
this option, an alternate integer value in the range 0 to 255 may be assigned. See the description of the DEFAULT_DESTINATION_NPI option for a table of typical NPI values.

ESME_ADDRESS_TON (Integer, 0-255)

ESME TON to specify when binding to the SMPP server. By default, bind
operations specify an ESME TON value of 0. With this option,
an alternate integer value in the range 0 to 255 may
be assigned. See the description of the DEFAULT_DESTINATION_TON option
for a table of typical TON values.

ESME_IP_ADDRESS (String, 0-15 bytes)

IP address of the host running Messaging Server. When binding to the
SMPP server, the bind PDU indicates that the client’s (that is, ESME’s)
address range is an IP address. This is done by specifying a TON of 0x00 and an NPI of 0x0d. The value of the address
range field is then set to be the IP address of the host running the SMS channel.
Specify the IP address in dotted decimal format; for example, 127.0.0.1.

ESME_PASSWORD (String, 0-9 bytes)

Password to present when binding to the SMPP server. If a password is
required, then specify it with this option. By default, a zero-length password
string is presented.

ESME_SYSTEM_ID (String, 0-15 bytes)

System identification to present to the SMSC when binding. If a password
is required, then specify it with this option. By default, a zero-length password
string is presented.

ESME_SYSTEM_TYPE (String, 0-12 bytes)

System type for the MTA to present to the SMSC when binding. By default,
no system type is specified (that is, a zero-length string is used).

MAX_PAGES_PER_BIND (Integer, >=0)

Maximum number of SMS messages to submit during a single session with
an SMPP server. Some SMPP servers may limit the maximum number of SMS messages
submitted during a single, bound session. In recognition of this, this option
allows specification of the maximum number of SMS messages to submit during
a single session. Once that limit is reached, the channel unbinds, closes
the TCP/IP connection, re-connects, and then rebinds.

By default, a value of 1024 is used for MAX_PAGES_PER_BIND. Note that the channel also detects ESME_RTHROTTLED errors
and adjusts MAX_PAGES_PER_BIND during a single run of the
channel accordingly.

REVERSE_ORDER (0 or 1)

Transmission sequence of multi-part SMS messages. When an email message
generates more than one SMS message, those SMS messages can be submitted to
the SMSC in sequential order (REVERSE_ORDER=0), or reverse
sequential order (REVERSE_ORDER=1). Reverse sequential
order is useful for situations where the receiving terminal displays the last
received message first. In such a case, the last received message will be
the first part of the email message rather than the last. By default, REVERSE_ORDER=1 is used.

Note that this option is ignored when USE_SAR=1 is
specified.

SMPP_MAX_CONNECTIONS (Integer, 1-50)

Maximum number of simultaneous SMPP server connections per process.
As each connection has an associated thread, this option also places a limit
on the maximum number of “worker” threads per process. By default, SMPP_MAX_CONNECTIONS=20.

SMPP_PORT (Integer, 1-65535)

TCP port on which the SMPP server listens. The TCP port may be specified
with either this option or the port channel keyword. This
port number must be specified through either of these two mechanisms. If it
is specified with both mechanisms, then the setting made with the SMPP_PORT option takes precedence. Note that there is no default value for
this option.

SMPP_SERVER (String, 1-252 bytes)

Host name of the SMPP server to which to connect. By default, the IP
host name of the SMPP server to which to connect is the official host name
associated with the channel; that is, the host name shown on the second line
of the channel’s definition in MTA’s configuration. This option
may be used to specify a different host name or IP address which overrides
that specified in the channel definition. When specifying an IP address, use
dotted decimal notation; for example, 127.0.0.1

TIMEOUT (Integer, >=2)

Timeout for completion of read and write actions with the SMPP server.
By default, a timeout of 30 seconds is used when waiting for data “writes”
to the SMPP server to complete or for data to be received from the SMPP server.
Use the TIMEOUT option to specify, in units of seconds,
a different timeout value. The specified value should be at least 2 seconds.