SMS Gateway 4.4 - User's Guide

Table of ContentsPreviousNextIndex

4. Configuring the software

The behavior of SMS Gateway is mainly controlled by a number of keywords used in the configuration file, SMSDIR/config. You can alter the way SMS Gateway acts by modifying config and then restarting smsd. You restart the smsd by finding the process id, kill the process and then start the daemon again. Do not use the -9 option when killing smsd.

4.1 Keywords

To use a new keyword in the configuration file add the keyword, preferably at the end of the file, and then restart smsd.

Examples of some useful keywords when connecting through dial-up:

DIAL_PREFIX
Dial prefix, for example "0" to get out through a PBX
INIT_STRING
Initilisation string for modem
XON_XOFF
Specifies XON/XOFF flow control is to be used
FLOW FLOW=0
Specifies do not try CTS/RTS flow control
EXECUTE_AFTER_SEND
Specifies a program to be executed after transmission
MAX_RETRIES
Maximum number of tries to send a message
RETRY_TIME
Time, in seconds, between tries
ROUND_ROBIN
Used with multiple modem devices

There are about 50 different keywords used by SMS Gateway.

4.2 SMS and Minicall Text in Sweden

By default SMS Gateway is configured with four gateways for the three Swedish SMS operators and Telia Mobitel's paging service Minicall Text. When sending a message using the sms command the message and the recipients are sent to smsd. Smsd looks at the first digits of the recipient's number to determine which gateway to use:

0702, 0703, 0705, 0706, 0730
Telia
0704, 0707, 0736, 0739
Tele2/Comviq
0708, 0709, 0733
Europolitan
0740, 0746
Minicall Text

It then tries to send as many messages as possible to the gateway for the first message in the send list. The cost for the message is the following:

Comviq
The gateway is on a 0707 GSM number so the cost is the normal cost for a mobile phone call.
Europolitan
A 0708 number is used. Otherwise same as Comviq.
Telia
A 0740 number is used which cost SEK 2 for 1 message.
Minicall Text
The cost depends on the number of characters in the message. The cost is invoiced to the customer who needs a special "sändarabonnemang" from Telia Mobitel.

To be able to send Minicall Text messages you need a "sändarabonnemang" from Telia Mobitel. This will get you a specific id and password that the software uses to log on to the gateway. You tell the software which id and password to use by using the keywords MINICALL_ID and MINICALL_PASSWORD in the configuration file. Telia Mobitel will send an invoice directly to the customer for the cost of the messages.

4.3 Defining a custom gateway

A custom gateway needs to be defined using the GATEWAY keyword for operation outside of Sweden and when not connecting through dial-up. The syntax is in the configuration file is GATEWAY="prefix:name:connmode:address:port:protocol[:extra]"

The parameters mean the following:

Prefix
The prefix in the recipient's number. You can also use DEFAULT for a default gateway.
Name
Name for the gateway. Used in lists.
Connmode
Connection mode for the gateway. Possible values: IP, MODEM, TELNET
Adress
Destination address. Depending on the connection mode, either a hostname, an IP address or a phone number.
Port
Used for IP and TELNET gateways. Specifies the port to connect to.
Protocol
Protocol to be used for the gateway.
Possible values: CIMD, CIMD2, SMPP, TAP, THS, UCP, UCPE
Extra
Gateway-specific parameters. See the keyword reference section for mote information

4.4 Adding actions

You can tell smsd that it should execute a specific script or program after a message has been sent or could not be sent. This could be useful if you want to update your own database or similar and is done by using the EXECUTE_AFTER_SEND keyword in the configuration file:

EXECUTE_AFTER_SEND=/usr/local/bin/smsafter

The specified program will be called with the following parameters: ID of the message, recipient's number, return code, number of tries, note, total time connected, time on the format YYMMDD HH:MM, login of the user that sent the message, SCTS and error text.

4.5 Implementing the software

There are a number of situations where it could be nice to receive a message when a certain action takes place or an error occurs. What about the following examples:

· Notification when new mail arrives
· Used by a network management software like HP OpenView to send alerts to system administators
· On an intranet to send information to colleagues

There are probably as many ideas as people using the software but the ones above are a few of the most common situations.

4.6 Configuring a CIMD2 gateway

The SMSC from Nokia uses the CIMD2 protocol. SMS Gateway support bi-directional messaging using CIMD2. It operates in polling mode meaning SMS Gateway asks the SMSC if there are incoming messages and then retrieves the messages.

There are a number of parameters concerning the CIMD2 protocol.

4.7 Configuring a SMPP gateway

SMS Gateway supports SMPP 3.3 which can also be used to connect to SMPP 3.4 SMSCs since SMPP 3.4 in general is backwards compatible with SMPP 3.3.

4.8 Configuring a UCP gateway

The SMSC from CMG Holland uses the UCP/EMI protocol. There are a number of parameters concerning the UCP protocol.

These include UCP_MT, UCP_NRQ, UCP_OT and UCP_VP.

When using authentication though UCP operation 60 you need to specify the following parameters for the GATEWAY: AUTHTON, AUTHNPI, SESSION_USERNAME and SESSION_PASSWORD.

Table of ContentsPreviousNextIndex