home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / SENDSMS / readme.txt < prev    next >
Text File  |  1997-09-11  |  12KB  |  351 lines
  1. Description of SendSMS
  2. ======================
  3.  
  4.  
  5. Licence
  6. -------
  7.  
  8. This program is shareware. Every user has to aggree to the following licence-conditions:
  9.  
  10. 1. This program may only be distributed in this package.
  11.  
  12. 2. All rights for commercial-use will belong to the author.
  13.  
  14. 3. For a periode of 20 days you may use the program free. To use this software
  15.    after this periode of 20 days you have to register SendSMS.
  16.    If you doesn't register SendSMS you are not allowed to continue using
  17.    the software.
  18.  
  19. 4. To register please fill out the form (order.txt) and send it together with
  20.    a corresponding cheque to the following address:
  21.  
  22.              Wolfgang B÷cherer
  23.              Im Grⁿn 9
  24.              D-76316 Malsch
  25.  
  26.              Tel.: +49 (0)7246/942484
  27.              Fax.: +49 (0)7246/942485
  28.              EMail: wobo@bai.de
  29.              WWW: http://www.bai.de
  30.  
  31.  
  32.    The fee for one licence (installation on one computer) is:
  33.  
  34.    private use                             50,-- DM
  35.    commercial use                         200,-- DM
  36.    (transfers from foreign countrys plus   20,-- DM)
  37.    All prices plus 15% tax.
  38.  
  39.    (please ask for multiple licences)
  40.  
  41.    A T T E N T I O N!!! For registering it is important to specify your
  42.    operating-system and your phonenumber.
  43.  
  44. 5. After I have got the money I will send you a registration-key
  45.    with which you are allowed to use SendSMS on one computer. It is forbitten
  46.    to distribute this registration-key.
  47.  
  48. 6. The use of SendSMS will result on your own risk. I am not responsible for
  49.    any damage (for example your phonebill) through the use of SendSMS (neighter
  50.    damage through errors nor through wrong usage).
  51.  
  52.  
  53. ------------------------------------------------------------------------------
  54.  
  55. SendSMS is a shareware-program to send ShortMessages (SMS) to
  56. GSM-phones or pagers via the protocols TAP or UCP. In Germany
  57. sind dies z.B. Telephone mit D1-, D2- oder EPlus-Karte oder verschiedene Pager
  58. (Quix, TeLMI, CityRuf, Scall, Skyper, ...).
  59. SendSMS has the following topics:
  60.  
  61. - UCP- and TAP-Protocol (ex.: D1, D2, EPlus, Quix, TeLMI, CityRuf, Scall, Skyper)
  62. - completly configurable for providers which use TAP or UCP
  63. - message can be specified on the commandline (batch-processing)
  64. - phonebook: insted of numbers you can use aliases (*)
  65. - sending messages to multiple reciptients through different providers (*)
  66. - event-logging (Logfile) or logging through syslogd (*)
  67. - configurable redialing (*)
  68. - configurable delay between dial-attempts
  69. - modem will not be locked bewteen dial-attempts
  70. - configurable for the most common modems
  71. - available on many operating-systems
  72. - definiton of header- and/or footer-line
  73.  
  74. Topics which are marked with (*) are only available in the registered version.
  75.  
  76. ------------------------------------------------------------------------------
  77.  
  78. Installation
  79. ------------
  80.  
  81. You have only to decompress the ZIP-file (alternativly the tar.Z-file) in any
  82. directory. After that this directory should contain at least the following files:
  83.  
  84.  
  85.   readme.txt          - this file
  86.   sendsms[.exe]       - program-file
  87.   sendsms.cfg         - configuration-file
  88.   sendsms.err         - error-messages
  89.   sendsms.pro         - definition of providers
  90.   sendsms.pbk         - phonebook
  91.  
  92. (the OS/2-version needs the EMX-runtime-environment
  93. http://www.leo.org/pub/comp/os/os2/leo/index.html)
  94.  
  95. (the DOS-version needs a Fossil-driver,
  96. for Example adf.exe http://www.digsys.se)
  97.  
  98. ------------------------------------------------------------------------------
  99.  
  100. Configuration
  101. -------------
  102.  
  103. To configure SendSMS, edit the file sendsms.cfg.
  104.  
  105. In the file sendsms.pro you can define the different providers (which provider uses
  106. TAP or UCP, which phonenumbers are to be used for them and what is the predial-code
  107. for them).
  108.  
  109. Your personal phonebook with aliases can be defined in the file sendsms.pbk.
  110.  
  111. Comments are always prefixed by ';' or '#'.
  112.  
  113.  
  114. ------------------------------------------------------------------------------
  115. sendsms.cfg
  116. -----------
  117.  
  118. In this file you can specify the following keywords to configure SendSMS.
  119. Every keyword has to be entered in an own line (to try SendSMS, it is normaly enough to
  120. edit MODEMINIT, MODEMDIAL and MODEMDEVICE in the including file). Please check your
  121. modem-description (if you have one) for the corresponding modem-commands.
  122.  
  123. MODEMINIT=ATL1E1Q0V1
  124. Specifies the initialisation-commands for your modem. SendSMS will always send ATZ
  125. to the modem before this command. You have to set your modem to:
  126.    echo on
  127.    answer on
  128.    answer as text
  129.  
  130. MODEMHANGUP=ATH
  131. Specifies the comman to hang up.
  132.  
  133. MODEMDIAL=ATDT0w
  134. Specifies the command to dial a number.
  135.  
  136. MODEMDEVICE=COM1
  137. Specifies the device to which your modem is connected.
  138. (Attention: on unix you have to take notice that you are allowed to use the device)
  139.  
  140. MODEMESCAPE=+++
  141. Specifies the escapesequence to switch the modem from data- to command-modus
  142.  
  143. WAITAFTERWRITE=1
  144. Specifies the count of seconds to wait after writing to the modem
  145. (normaly 0)
  146.  
  147. BAUD=1200
  148. Specifies the baudrate (300, 600, 1200, 2400, 4800 or 9600)
  149.  
  150. DATABITS=8
  151. Specifies the count of databits (7 or 8)
  152.  
  153. STOPBITS=1
  154. Specifies the count of stopbits (1 or 2)
  155.  
  156. PARITY=NONE
  157. Specifies the kind of parity (NONE, EVEN or ODD)
  158.  
  159. TIMEOUT=40
  160. Specifies the time (in seconds) to wait for the CONNECT-Message.
  161.  
  162. LOCKDIR=/var/spool/uucp
  163. Specifies the directory to look for and to generate a lock-file
  164. (only on unix).
  165.  
  166. BINLOCKS=0
  167. Specifies whether the lockfile should be binary or ascii.
  168.  
  169. LOGFILE=sendsms.log
  170. Specifies a file in which all actions will be logged. If you specify
  171. 'syslog' (only unix) the logging will be handle via the syslog-daemon.
  172. [only available in the registered version]
  173.  
  174. HEADER=
  175. Specifies an optional headerline (text which will preceed every message)
  176. [only available in the registered version]
  177.  
  178. FOOTER=
  179. Specifies an optional footerline (text which will be appended to every message)
  180. [only available in the registered version]
  181.  
  182. REDIALCOUNT=1
  183. Specifies the count of redial-attempts
  184. [only available in the registered version]
  185.  
  186. REDIALDELAY=60
  187. Specifies the count of seconds to wait between two dial-attempts. While this
  188. time the modem will not be locked.
  189.  
  190. PHONE=
  191. Your own phonenumber, from which the message will be submitted.
  192.  
  193. MAXERRORS=
  194. Specifies the count of errors (not transmitted messages) to accept until SendSMS
  195. will be terminated. If this parameter isn't set or is 0 the program will not
  196. terminate after an error. This parameter has only sense if you send messages
  197. to multiple reciptients.
  198.  
  199. sendsms.pro
  200. -----------
  201.  
  202. In this file you can define different providers (in the unregistered version
  203. a maximum of three providers). For every provider you have to enter a
  204. chapter by entering a line of the form:
  205. [<provider>]
  206. In every chapter you can specify the following parameters:
  207.  
  208. PHONE=
  209. Specifies the phonenumber of the provider. If the last character of the number
  210. is a '&', this means that the specified number will be appended by the number
  211. of the reciptient.
  212.  
  213. PROTOCOL=
  214. Specifies the protocol (TAP, UCP, Scall or Skyper) which the provider uses.
  215.  
  216. PREFIX=
  217. Specifies the predialcode for the corresponding provider. With this prefix
  218. SendSMS tries to identify the provider to which the phonenumber of the
  219. reciptient belongs.
  220.  
  221. REMOVEPREFIX=
  222. The number of the reciptient will be send together with the corresponding message.
  223. Because for some providers the number has to be send without any prefix you can
  224. specify with this parameter (=1) that the PREFIX (if defined) will be discarded.
  225.  
  226. MSGTYPE=
  227. Specifies the kind of message: NUMERIC (only digits), ALPHANUMERIC
  228. (characters and digits) or TONE (no characters, only beeping).
  229.  
  230. MSGLEN=
  231. Specifies the max. length of a message.
  232.  
  233.  
  234. for example:
  235. [D1]
  236. PHONE=01712092522
  237. PROTOCOL=TAP
  238. PREFIX=0171
  239. MSGTYPE=ALPHANUMERIC
  240. MSGLEN=160
  241.  
  242.  
  243. sendsms.pbk
  244. -----------
  245.  
  246. In this file you can enter a chapter for every in sendsms.pro
  247. defined provider with aliases. Every chapter starts with
  248. a line of the form:
  249. [<provider>]
  250. Every alias has to be entered in an own line and has to be of the
  251. form:
  252. <alias>=<phone>
  253. The phonenumber has to be entered with the predialcode.
  254. The phonebook is only available in the registered version!!!!
  255.  
  256. for example:
  257. [D1]
  258. wobo=01714160598        ; Wolfgang B÷cherer
  259.  
  260. ------------------------------------------------------------------------------
  261.  
  262. Calling syntax
  263. --------------
  264.  
  265. SendSMS will be executed as follows:
  266.  
  267.    sendsms [options] {phoneNo | alias | @<grpFile>} [{message | < msgFile}]
  268.  
  269.    options are:
  270.       -P<provider>      specifies the provider for the corresponding phonenumber
  271.       -F<msgFile>       specifies a filename which contents will be send as the message
  272.       -C<cfgFile>       specifies the configuration-file (sendsms.cfg)
  273.       -R<proFile>       specifies the provider-definition-file (sendsms.pro)
  274.       -B<pbkFile>       specifies the phonebook-file (sendsms.pbk)
  275.  
  276. Ex.: sendsms 0171xxxxx "I am testing SendSMS"
  277.  
  278.  
  279. You have to specify at least one parameter - the phonenumber of the
  280. recipient or an alias (form the phonebook). If this first parameter starts with a
  281. masterspace (@), the parameter specifies the name of a file which contains
  282. multiple phonenumbers. The specified file must have the following format:
  283.  
  284. [<provider1>]
  285. <number1>
  286. <number2>
  287. <number3>
  288. <alias1>
  289. <alias2>
  290.  
  291. [<provider2>]
  292. <number4>
  293.  
  294. Inclosed in brackets ([]) you have to specify a provider (which is defined in
  295. sendsms.pro), followed by multiple lines with phonenumbers of reciptients.
  296. Every line contains one reciptient (number or alias), which belongs to the
  297. corresponding provider and to which the message will be send in one connection.
  298. In the above example the message will be send to 5 reciptients of the first provider
  299. and to one reciptient of the second provider (with 2 connections).
  300.  
  301. The second parameter is the message, enclodes by ' (ATTENTION: depending on the
  302. shell you are using some characters are substituted by the shell (for example '!')
  303. or you have to enclose the message by " insted of '). Alternativly you
  304. can specify the message by redirecting it from a file (< msgFile) or with the
  305. Parameter -F<msgFile>, where <msgFile> is the name of the file that will be
  306. send (at least the first n characters). If you specify only one parameter
  307. on the commandline (the recipient), the message will be read from the console
  308. until you enter a line only consisting of a single '.'.
  309. If you want to send a message to a provider, which can't be identified by
  310. the predial-code of the reciptients phonenumber you have to specify the
  311. corresponding provider (as defined in sendsms.pro) with the parameter
  312. -P<provider>.
  313. For Example: you want to send a message to a Quix-Pager. SendSMS can't recognize the
  314. provider (Quix), because the number has no predialcode. Thatswhy you have to
  315. specify -PQuix.
  316.  
  317. ------------------------------------------------------------------------------
  318.  
  319. Where can I get the newest version?
  320. ===================================
  321.  
  322. You can always get the newest version under:
  323.  
  324.         http://www.bai.de/sendsms/sendsms.shtml
  325.  
  326. ------------------------------------------------------------------------------
  327.  
  328. Problems/Questions
  329. ==================
  330.  
  331. Please send an Email including the following informations
  332.  
  333. - error-/problemdescription
  334. - hardcopy of the screen (commandline and errormessage)
  335. - your sendsms.cfg
  336. - your sendsms.pro
  337. - used operating-system
  338. - used version of SendSMS
  339. - used modem
  340.  
  341. to:
  342.  
  343. wobo@bai.de
  344.  
  345. ------------------------------------------------------------------------------
  346. Wolfgang B÷cherer, Luisenstra▀e 62, D-76137 Karlsruhe
  347. Tel.: +49 (0)721/9374060, Fax.: +49 (0)721/9374061
  348.  
  349. EMail: wobo@bai.de
  350. WWW: http://www.bai.de
  351.