SMS Gateway 4.4 - User's Guide
12. Keyword reference
Here we describe the syntax of each keyword in the configuration file, SMSDIR/config.
The keywords below are used in the configuration file SMSDIR/config. The file can be modified with an ordinary text editor. After modifying the file the smsd has to be stopped and restarted for the changes to become activated.
When using multiple modem devices keywords specific for a certain tty (local keywords) can be used by using the following syntax:
LINE tty <
LINE tty1a <
This makes it possible to use different modems etc.
Please note that the global keywords, keywords used for all lines, must be defined before the local keywords. If a keyword is used more than once the last instance will be used.
12.1 General parameters
Defines which port(s) to use. /dev should not be included in the name. Please note that the number of ports used is limited by the license as well. Example: LINES=tty1A
Specifies which hosts or network can access the HTTP server.
See also: USER_FILE
Specifies which hosts or network can access the SMTP server.
See also: USER_FILE
Specifies that only the given users are allowed to use a modem device. Useful when having multiple devices where a specific device should be dedicated to specific users.
See also: DENY_USERS
Defines which users are system administrators. As a SMS system administrator you can display and manage all users message queues. More than one administrator can be defined by separating user names with colon ":". Example:
Defines the number of transmission tries when the recipient number is busy. If BUSY_FAIL is not defined the number of tries is defined by MAX_TRIES.
CHAR_SET=character set or
Specifies the character set to be used.
Default: 5 (swedish 7-bit mapping)
Specifies the login to use with the CIMD protocol.
Specifies the password to use with the CIMD protocol.
Defines, for the CIMD protocol, how long, in seconds, a message will be stored in the SMSC. A negative number indicates that the message should not be stored if it cannot be sent immediately.
Write debug information to standard output, that is to the display.
Specifies that the default gateways (dial-up gateways for swedish operators) should be added. This makes it possible to add a gateway to the existing ones. If DEFAULT_GATEWAYS is omitted none of the default gateways will be added if there is a GATEWAY definition in the config file.
Specifies that the given users are not allowed to use a modem device. Useful when having multiple devices where a specific device should not be available to specific users.
See also: ACCEPT_USERS
Defines a prefix added to the phone number when dialing out. For example, use something like DIAL_PREFIX="0W" to get through a switchboard.
Defines the number of seconds to wait after dialing the phone number, before the try is considered a failure if a connection has not been established.
Used to define a direct serial connection instead of a modem connection to the SMSC.
Specifies the domain name to use when sending e-mail.
Defines the work directory to use for commands executed by EXECUTE_AFTER_SEND.
Gives a program which is executed after receiving a message.The program is executed with the following arguments in the sequence given:
Defines a program, or script, to be executed after a message has been transmitted or is considered a failure.The program is executed with the following parameters:
Specifies a command string to be sent to the modem after a transmission. Please note that ATZ (reset) is always sent to the modem before the specified string.
Use FLOW=0 to disable hardware flow control for modem connections.
Makes it possible to define custom gateways.
Europolitan via modem:
Specifies which host that runs the SMS Gateway server, smsd, usually the local machine. An IP address or host name can be used. If a host name is used the name resolver must work. Hence, using an IP address is more reliable but has to be changed if the IP address of the machine changes.
Specifiy rules for HTTP access.
Enable the SMS Gateway integrated HTTP server.
Specifies which port the HTTP server should listen on.
Specifies the sender or originator for a message. This, for example, corresponds to the OAdC field in UCP. Usually the originating GSM subscriber number which the recipient would reply to.
Defines a initialisation string to be sent to the modem before dialing out. Here you can add modem-specific commands needed to set up flow control etc. Example:
Specifies the prefix for international calls. 00 in Sweden.
LANG=language code or
Specifies the language to be used. Possible values eng, swe and swe8.
Specifies the long-distance prefix. Default: 0 in Sweden
Specifies the number of tries when the modem cannot be initiated.
Specifies which directory to use for tty lock files.
Indicates which type of locked files should be created when locking fax lines. This is dependent on the operating system.
3 System V.4
Specifies that an email should be sent to the user sending the message when the message could not be sent.
Specifies that an email should be sent to the user sending the message after the message has been sent.
Specifies the maximum number of tries to send a message before the message is put in the failed messages queue.
Specifies the maximum number of messages to send to the SMSC during one session. Some SMSC's only accept a certain number of messages during one session.
Specifies the number for Telia:s Minicall Text Gateway
Specifies the user id for Minicall Text.
Specifies the password for Minicall Text.
Specifies that no statistics information should be written to ETCDIR/stats.
Specifies which port to use for communication between smsd and the client programs.
Indicates that pulse dialing should be used.
Specifies that client programs should be quiet and not write information to stdout as done by default. This is the same as using the -q option with the sms commands.
Defines the number of minutes between two consecutive transmission tries.
Enable the SMS Gateway integrated SMTP server.
Specifies which port the SMTP server should listen on.
Defines the directory where files used during transmission are stored.
Defines the symbol set to be used.Values: 0 = Roman-8, 1 = Latin-1 (ISO 8859-1).
Default: 1 (Latin-1)
Specify the default password for a TAP gateway.
Specifies that tone dialing should be used (default).
Specifies the default message type for UCP.
Specifies the default NRQ for UCP. Set this to 1 if you want the delivery to be confirmed before the connection is dropped. 0 means to ignore whether the message could be delivered or not, always successful.
Specifies the OT (Operation Type) for UCP.
Default value: 51
Specifies the default validity period for UCP gateways. This is the period in number of seconds a message will be stored in the SMSC if it cannot be delivered.
Specifies that we want static IP. The maximum number of connections is given as argument.
Specify that the server should use Share Memory for inter-process communication. Not all platforms support Shared Memory.
Specifies a file to use for valid users of the HTTP or SMTP server.
Format of the file: username<TAB>password<TAB>type of server
user1 secret HTTP
user2 moresecret HTTP,SMTP
firstname.lastname@example.org sec123 HTTP,SMTP
12.2 Gateway parameters
These parameters can be specified in the last field (extra) of a gateway definition. Multiple parameters can be specfied ","-separated.
String can containg the letters `S' and `R' to specify whether the gateway should be used for sending messages, receiving messages or both.
Specifies that SCA (Service Center Address) should not be included in PDU when sending messages.
If specified this operation will be used as send operation.
For example OPERATION=51 when using UCP will specify that the UCP operation 51 will be used to send messages.
If specified this password will be used when logging in to gateway.
If specified string will be used to set SCA (Sercice Center Address) during init of a GSM phone.
Specifies a password to use with the UCP session management operation, when logging in to a UCP SMSC.
Specifies a username/Large Account to use with the UCP session management operation, when logging in to a UCP SMSC.
Specifies a sender, originating address, for the specific gateway.
String can be "SM" or "ME" to specify which message store (SIM card or Memory) should be used when using a GSM device as gateway.
Specify a string to wait for after connect.