Sun Java System Messaging Server 6 2005Q4 Administration Guide

SMPP Relay Options

The SMS Gateway Server can have multiple instantiations of its SMPP relay, each with different characteristics chief of which will be the TCP port and interface listened on. Put differently, for each network interface and TCP port pair the SMPP relay listens on, distinct characteristics may be ascribed. These characteristics are specified using the options described in this section.

Each instantiation should be placed within an option group of the form:


[SMPP_RELAY=relay-name]
option-name-1=option-value-1
option-name-2=option-value-2
...
option-name-n=option-value-n

The string relay-name merely serves to differentiate this instantiation from other instantiations.

Table D–22 lists the SMPP relay configuration options.

Table D–22 SMPP Relay Options

Options  

Default  

Description  

LISTEN_BACKLOG

255

Connection backlog for inbound SMPP client connections 

LISTEN_CONNECTION_MAX

 

Maximum number of concurrent inbound connections 

LISTEN_INTERFACE_ADDRESS

 

Network interface for inbound SMPP client connections 

LISTEN_PORT

 

TCP port for inbound SMPP client connections 

LISTEN_RECEIVE_TIMEOUT

600 s

Read timeout for inbound connections from SMPP clients 

LISTEN_TRANSMIT_TIMEOUT

120 s

Write timeout for inbound connections from SMPP clients 

MAKE_SOURCE_ADDRESSES_UNIQUE

1

Make relayed SMS source addresses unique and able to be replied to 

SERVER_HOST

 

Host name or IP address of the SMPP server to relay to 

SERVER_PORT

 

TCP port of the SMPP server to relay to 

SERVER_RECEIVE_TIMEOUT

600 s

Read timeout for outbound SMPP server connections 

SERVER_TRANSMIT_TIMEOUT

120 s

Write timeout for outbound SMPP server connections 

LISTEN_BACKLOG

(integer, in [0,255]) Connection backlog allowed by the TCP stack for inbound SMPP client connections. The default value is 255.

LISTEN_CONNECTION_MAX

(integer, >= 0) The maximum number of concurrent, inbound TCP connections to allow for this SMPP relay instantiation. Note that this value will be ignored if it exceeds the global LISTEN_CONNECTION_MAX setting.

LISTEN_INTERFACE_ADDRESS

(string, "INADDR_ANY" or dotted decimal IP address) The IP address of the network interface to listen to for inbound SMPP client connections. May be either the string “INADDR_ANY” (all available interfaces) or an IP address in dotted decimal form. (For example, 193.168.100.1) The default value is “INADDR_ANY”. Clustered HA configurations will need to set this value to correspond to the HA logical IP address.

LISTEN_PORT

(integer, TCP port number) TCP port to bind to for accepting inbound SMPP client connections. Specification of this option is mandatory; there is no default value for this option. Note also that there is no Internet Assigned Numbers Authority (IANA) assignment for this service.

LISTEN_RECEIVE_TIMEOUT

(integer, seconds > 0) Timeout to allow when waiting to read data from an SMPP client. The default value is 600 seconds (10 minutes).

LISTEN_TRANSMIT_TIMEOUT

(integer, seconds > 0) Timeout to allow when sending data to an SMPP client. The default value is 120 seconds (2 minutes).

MAKE_SOURCE_ADDRESSES_UNIQUE

(0 or 1) By default, the SMPP relay will append to each SMS source address a unique, ten digit string. The resulting SMS source address is then saved along with the other historical data. The result is a unique SMS address which may then be replied to by SMS users. The SMPP server will detect this address when used as an SMS destination address and will then send the SMS message to the correct email originator.

To disable this generating of unique SMS source addresses (for one-way SMS), specify a value of 0 (zero) for this option.

SERVER_HOST

(string, TCP hostname or dotted decimal IP address) SMPP server to relay SMPP client traffic to. Either a hostname or IP address may be specified. Specification of this option is mandatory; there is no default value for this option.

SERVER_PORT

(integer, TCP port number) TCP port for the remote SMPP server to which to relay. Specification of this option is mandatory; there is no default value for this option. There is no IANA assignment for this service; do not confuse with the IANA assignment for SNPP.

SERVER_RECEIVE_TIMEOUT

(integer, seconds > 0) Timeout to allow when waiting to read data from the SMPP server. The default value is 600 seconds (10 minutes).

SERVER_TRANSMIT_TIMEOUT

(integer, seconds > 0) Timeout to allow when sending data to the SMPP server. The default value is 120 seconds (2 minutes).