SmppChannel

The SmppChannel sends or receives short message service (SMS) via short message peer-to-peer (SMPP).

Many configuration values require knowledge of SMPP. See http://www.nowsms.com/discus/messages/1/SMPP_v3_4_Issue1_2-24857.pdf.

  • Preferences node: – /businesslayer/com/sybase365/mobiliser/util/messaging/channelmanager/engine/impl/ChannelInstantiator/httpchannel1
  • ConfigAdmin PID: – com.sybase365.mobiliser.util.messaging.channelmanager.engine.impl.ChannelInstantiator.httpchannel1
You can set these configuration options:
Key Default Description
channelId defaultQ Indicates the channel’s ID.
urlSupplement http Appends the supplement to the channel manager URL, making the HTTP channel accessible. It is a suffix on the URL for internal processing.
incomingChannelId brandInQueue Indicates the destination channel ID that is used when this channel submits a message to ChannelManager.
sendAsDataSm false Sends SMS as a SUBMIT_SM. If set to true, then it sends SMS as DATA_SM.
registeredDelivery 0 Defines the value of the registered_delivery to use for outgoing SMS. See 5.2.17 of the SMPP Protocol Specification v3.4.
validityOffset   Defines the message validity period, in seconds, for an outgoing SMS. There is not default value, which delegates the validity offset responsibility to the defaulted defined in the Short Message Service Center (SMSC).
smscTimeZone   Defines the time zone for SMSC. If undefined, the SmppChannel assumes the same time zone as the JVM.  When using validityOffset, the validity string must be computed using the time zone of the SMSC.
ussdManagerNoReponseTimeout 300000 Defines the amount of time, in milliseconds, before a Unstructured Supplementary Service Data (USSD) session is regarded as timed out.
sourceNumberFormatter const Defines the source number format for outgoing messages. Options include:
  • international
  • national
  • const
  • numeric-international
  • short-international
destinationNumberFormatter const Defines the destination number format for outgoing messages. Options include:
  • international
  • national
  • const
  • numeric-international
  • short-international
srcTon 0 Defines the type of number (TON) value to use for the source mobile phone number. This should match the configured formatter. See 5.2.5 of the SMPP Protocol Specification v3.4.
destTon 0 Defines the TON value to use for the destination mobile phone number. This should match the configured formatter. See 5.2.5 of the SMPP Protocol Specification v3.4.
srcNpi 0 Defines the numbering plan identification (NPI) value to use for the source mobile phone number. This should match the configured formatter. See 5.2.6 of the SMPP Protocol Specification v3.4.
destNpi 0 Defines the NPI value to use for the destination mobile phone number. This should match the configured formatter. See 4.1 of the SMPP Protocol Specification v3.4.
bindType transceiver Defines the bind type to use when connecting to the SMSC. Options include:
  • transceiver
  • transmitter
  • receiver
  • transmitterAndReceiver
See 5.2.6 of the SMPP Protocol Specification v3.4. This setting affects all of the remaining options, listed with a leading underscore ( _ ). Therefore, replace the underscore with transceiver, transmitter, or receiver. If you are using transmitterAndReceiver, configure the following twice, once with each prefix.
_.host   Defines the host name of the SMPP server.
_.password   Defines the password of the user connecting to the SMPP server.
_.port   Defines the port number of the SMPP server.
_.systemId   Defines the system ID to use when binding to the SMPP server.
_.systemType   Defines the system type to use when binding to the SMPP server.
_.enquireLinkTimer 60000 Defines the session timer, in milliseconds. If no activity is recorded, the underlying library sends an enquire link request to the server.
_.transactionTimer 10000 Defines the time, in milliseconds, to wait for the response to a sent request. For example, the length of time to wait for the SUBMIT_SM_RESP after sending a SUBMIT_SM.
_.initialReconnectDelay 1000 Defines the time, in milliseconds, to wait after starting the SmppChannel before attempting to connect to the server.
_.reconnectDelay 1000 Defines the time, in milliseconds, to wait before attempting to reconnect to the server after being disconnected.
_.usingSSL   Indicates whether to use a SSL connection when connecting to the SMPP server.
_.disableGsmAlphabet   Encodes the text in the global system for mobile (GSM) communication alphabet, if possible, and falls back to a multibyte encoding. If you are using a language that normally cannot be encoded using the GSM alphabet, set this key to true, which disables this check and always uses a multibyte encoding.
Note: The default channel for all outgoing messages is htmlchannel1. Once an outgoing message is sent by Mobiliser, the contents of the messages can be found at the following URL: https://localhost:8081/mobiliser/channelmgr/html, where you are asked for the Mobiliser mobiliser user before you can view the outgoing messages.  To use the emailchannel1 as the method for sending outgoing messages, you must first deactivate htmlchannel1. To deactivate it, set the "_active" preference entry to false via the Operations Dashboard in: /com/sybase365/mobiliser/util/messaging/channelmanager/engine/impl/ChannelInstantiator/htmlchannel1.
Parent topic: Channels