home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 May / PCO_5_97.ISO / FilesBBS / OS2 / SNDSMS16.ARJ / SNDSMS16.ZIP / liesmich.txt < prev    next >
Encoding:
Text File  |  1997-03-17  |  10.0 KB  |  290 lines
  1. Beschreibung von SendSMS
  2. ========================
  3.  
  4.  
  5. Lizenz
  6. ------
  7.  
  8. Dieses Programm ist Shareware. Jeder Anwender erkennt die folgenden Lizenz-
  9. bestimmungen an:
  10.  
  11. 1. Das Programm darf nur in diesem Paket weitergegeben werden.
  12.  
  13. 2. Alle Rechte zur kommerziellen Nutzung verbleiben beim Autor.
  14.  
  15. 3. Fⁿr eine Probezeit von 20 Tagen darf es kostenlos verwendet werden.
  16.    Danach ist eine Registrierung erforderlich, durch die der
  17.    Anwender eine Lizenz zur weiteren Verwendung erwirbt. Andernfalls erlischt
  18.    die Erlaubnis zur Verwendung des Programms, und die Benutzung
  19.    ist gemΣ▀ Urheberrecht verboten.
  20.  
  21. 4. Die Registrierung erfolgt gegen Einsendung eines EC-Schecks an
  22.  
  23.              Wolfgang B÷cherer
  24.              Luisenstra▀e 62
  25.              76137 Karlsruhe
  26.  
  27.              Tel.: +49 (0)721/9374060
  28.              Fax.: +49 (0)721/9374061
  29.              EMail: wobo@bai.de
  30.              WWW: http://www.bai.de
  31.  
  32.  
  33.    Die Registrierungsgebⁿhr betrΣgt fⁿr eine Einzelplatzlizenz
  34.    (ein Benutzer, ein Betriebssystem):
  35.  
  36.    private Nutzung                50,-- DM
  37.    kommerzielle Nutzung          200,-- DM
  38.    (Auslandsⁿberweisungen zzgl.   10,-- DM)
  39.  
  40.    (Anfragen zu Mehrfachlizenzen oder Reseller-Optionen willkommen)
  41.  
  42.    Es sind natⁿrlich auch Verrechnungsschecks, Postanweisungen und
  43.    Zahlung gegen Rechnung m÷glich.
  44.  
  45. 5. Nach Zahlungseingang (unter Angabe der Telefonnummer und des
  46.    verwendeten Betriebsystems) wird ein Registrierungsschlⁿssel an den
  47.    Lizenznehmer verschickt, der ihn zur weiteren Verwendung des
  48.    Programms unter auf einem Rechner berechtigt. Die Weitergabe des
  49.    zugeteilten Registrierungsschlⁿssel ist untersagt.
  50.  
  51. 6. Die Verwendung des Programms erfolgt auf eigenes Risiko. Fⁿr eventuelle
  52.    SchΣden (z.B. Telefonrechnung) durch Fehlbedienung oder Fehlfunktion des
  53.    Programms wird nicht gehaftet.
  54.  
  55.  
  56. ------------------------------------------------------------------------------
  57.  
  58. Allgemeines
  59. -----------
  60.  
  61. SendSMS ist ein Shareware-Programm zum Versenden von ShortMessages (SMS) zu
  62. GSM-Telephonen mittels der Protokolle TAP bzw. UCP. In Deutschland sind dies
  63. zur Zeit Telephone mit D1-, D2- oder EPlus-Karte. Eine SMS-Nachricht kann
  64. bis zu 160 Zeichen lang sein. SendSMS hat u.a. folgende FΣhigkeiten:
  65.  
  66. - UCP- und TAP-Protokoll (z.B.: D1, D2, EPlus)
  67. - beliebig konfigurierbar fⁿr weitere Dienstanbieter mit TAP oder UCP
  68. - Nachricht kann ⁿber Kommandozeile oder aus einer Datei angegeben werden
  69.   (Batchmodus m÷glich)
  70. - Telefonbuch: anstelle der Telefonnummer k÷nnen definierte Kⁿrzel benutzt
  71.   werden (*)
  72. - versenden von Nachrichten an mehrere EmpfΣnger (Gruppendefinition im
  73.   Telefonbuch) (*)
  74. - Definition von mehreren Nummern pro Telefonnetz, ⁿber welche ein Nachricht
  75.   verschickt werden kann (falls eine Nummer besetzt ist, wird die nΣchste benutzt) (*)
  76. - fⁿhren einer Protokolldatei (Logdatei) bzw. Protokollierung ⁿber syslogd (*)
  77. - Definition der Anzahl der Wahlwiederholungen m÷glich (*)
  78. - frei definierbare Pause zwischen den Wahlversuchen
  79. - Modem wird zwischen den Wahlversuchen nicht blockiert
  80. - Konfiguration fⁿr beliebige Modems m÷glich
  81. - korrekte Verwendung von Umlauten
  82. - verfⁿgbar auf vielen verschiedenen Betriebssystemen
  83. - Definition von Kopf- und/oder Fu▀zeile
  84.  
  85. Mit (*) gekennzeichnete Punkte sind nur in der registrierten Version verfⁿgbar.
  86.  
  87. ------------------------------------------------------------------------------
  88.  
  89. Installation
  90. ------------
  91.  
  92. Die ZIP-Datei (alternativ auch tar.Z) wird in einem beliebigen Unterverzeichnis
  93. entpackt. Danach gibt es die folgenden Dateien:
  94.  
  95.  
  96.   liesmich.txt        - diese hier
  97.   sendsms[.exe]       - das eigentliche Programm
  98.   sendsms.cfg         - Konfigurationsdatei
  99.   sendsms.err         - Fehlermeldungen
  100.   sendsms.pro         - Telefonnetz-Definitionen
  101.   sendsms.pbk         - Telefonbuch
  102.  
  103. (Die OS/2-Version ben÷tigt die EMX-Runtime-Umgebung
  104. http://www.leo.org/pub/comp/os/os2/leo/index.html)
  105.  
  106. (Die DOS, Windows 3.x und Windows95-Versionen ben÷tigen einen
  107. Fossil-Treiber z.B. adf.exe http://www.digsys.se)
  108.  
  109. ------------------------------------------------------------------------------
  110.  
  111. Konfiguration
  112. -------------
  113.  
  114. In der Datei 'sendsms.cfg' wird die allgemeine Konfiguration des Pro-
  115. gramms festgelegt.
  116.  
  117. In der Datei 'sendsms.pro' werden die verschiedenen Telefonnetze (welches Netz
  118. benutzt TAP bzw. UCP, ⁿber welche Telephonnummer wird die Nachricht verschickt und
  119. welche Vorwahl haben die Nummern des entsprechenden Netzes) konfiguriert.
  120.  
  121. In der Datei 'sendsms.pbk' werden Kⁿrzel zum WΣhlen mittels symbolischer Namen
  122. anstelle von Telefonnummern definiert.
  123.  
  124. Kommentare werden in durch einen Strichpunkt (;) oder durch
  125. ein Gatter (#) eingeleitet.
  126.  
  127.  
  128. ------------------------------------------------------------------------------
  129. sendsms.cfg
  130. -----------
  131.  
  132. Hier stehen die im Folgenden aufgefⁿhrten Schlⁿsselworte zum Konfigurieren
  133. von SendSMS zu Verfⁿgung. Jedes Schlⁿsselwort mu▀ in einer neuen Zeile stehen.
  134. In der Regel mu▀ diese Datei fⁿr einen Probelauf nicht geΣndert werden (au▀er
  135. MODEMINIT und MODEMDIAL). Fⁿr die entsprechenden Modembefehle wird auf ihr
  136. Modemhandbuch verwiesen (soweit vorhanden).
  137.  
  138. MODEMINIT=ATL1
  139. Gibt das Initialisierungskommando fⁿr ihr Modem an (hier Lautsprecher leise).
  140. Vor diesem Kommando wird immer ein ATZ an das Modem gegeben.
  141.  
  142. MODEMHANGUP=ATH
  143. Gibt das Kommando zum Auflegen an.
  144.  
  145. MODEMDIAL=ATDT0w
  146. Gibt das Kommando zum wΣhlen einer Nummer an (hier Tonwahl und nach einer '0'
  147. auf das Freizeichen warten)
  148.  
  149. MODEMDEVICE=COM1
  150. Gibt den Anschlu▀ an, an dem das Modem hΣngt (unter Unix z.B. /dev/ttyS0).
  151. (Achtung: unter Unix mu▀ unbedingt darauf geachtet werden, da▀ das richtige
  152. Device angegeben ist und der Benutzer berechtigt ist dies zu benutzen)
  153.  
  154. WAITAFTERWRITE=1
  155. Gibt die Anzahl Sekunden an, die nach jedem Schreiben auf das Modem
  156. gewartet wird (unter HP-UX unbedingt setzen).
  157.  
  158. BAUD=1200
  159. Gibt die zu verwendende Baudrate an (300, 600, 1200, 2400, 4800 oder 9600)
  160.  
  161. DATABITS=8
  162. Gibt die Anzahl der Datenbits an (7 oder 8)
  163.  
  164. STOPBITS=1
  165. Gibt die Anzahl der Stopbits an (1 oder 2)
  166.  
  167. PARITY=NONE
  168. Gibt die Art der ParitΣt an (NONE, EVEN oder ODD)
  169.  
  170. TIMEOUT=40
  171. Gibt die Zeitdauer (in Sekunden) an, die das Programm auf die CONNECT-Meldung
  172. wartet.
  173.  
  174. LOCKDIR=/var/spool/uucp
  175. Gibt das Verzeichnis an, in dem eine Lockdatei gesucht bzw. angelegt wird
  176. (nur UNIX).
  177.  
  178. LOGFILE=sendsms.log
  179. Gibt das Logfile an, in dem SenSMS alle Aktionen protokolliert. Wird das
  180. File ohne Pfad angegeben, so wird es in dem Verzeichnis in dem das
  181. Programm steht angelegt. Wird als LOGFILE 'syslog' (nur Unix) angegeben,
  182. so wird ⁿber den syslog-DΣmon protokolliert.
  183.  
  184. HEADER=
  185. Gibt einen optionalen Header an (ein Text, der vor jede zu versendende
  186. Nachricht gestellt wird) [nur in der registrierten Version]
  187.  
  188. FOOTER=
  189. Gibt einen optionalen Footer an (ein Text, der an jede zu versendende
  190. Nachricht angehΣngt wird) [nur in der registrierten Version]
  191.  
  192. REDIALCOUNT=1
  193. Gibt die Anzahl von Wahlversuchen an
  194. [nur in der registrierten Version]
  195.  
  196. REDIALDELAY=60
  197. Gibt die Anzahl Sekunden an, die bis zum nΣchsten Wahlversuch gewartet wird.
  198. In der Zeit bis zum nΣchsten Wahlversuch wird das Modem wieder freigegeben.
  199.  
  200.  
  201. PHONE=
  202. Gibt die eigene Telephonnummer, von der die Nachricht ausgeht, an.
  203.  
  204.  
  205. sendsms.pro
  206. -----------
  207.  
  208. Hier werden die verschiedenen Dienstanbieter (in unregistrierter Version
  209. maximal 3) konfiguriert. Fⁿr jeden Dienstanbieter mu▀ ein 'Kapitel'
  210. angelegt werden. Dies erfolgt durch eine Zeile mit dem Namen des
  211. Dienstanbieters in eckigen Klammern ([]) eingeklammert und den
  212. folgenden Parametern:
  213.  
  214. PHONE=
  215. Hier werden die Telefonnummern, ⁿber welche Nachrichten an das entsprechende
  216. Netz gesendet werden k÷nnen, angegeben. In der registrierten Version k÷nnen
  217. hier durch Kommata getrennt mehrere Nummern angegeben werden. Beim versenden
  218. einer Nachricht wird dann zunΣchst die erste angegebene Nummer angewΣhlt
  219. und falls dies nicht funktioniert die nΣchste. Dies wird im schlimmsten Fall
  220. bis zur letzten angegeben Nummer wiederholt und falls diese auch nicht
  221. Antwortet wird, falls REDIALCOUNT auf einen Wert gr÷▀er 1 gesetzt ist, der
  222. gesamte Vorgang entsprechend oft wiederholt.
  223.  
  224. PROTOCOL=
  225. Hier mu▀ entweder TAP oder UCP, je nach Netz, stehen.
  226.  
  227. PREFIX=
  228. Hier steht die Vorwahl des entsprechnden Netzes. Anhand dieser Vorwahl wird
  229. beim Aufruf von SendSMS mit einer Telefonnummer (kein Alias aus dem Telefonbuch)
  230. ⁿberprⁿft, zu welchem Netz die entsprechende Telefonnummer geh÷rt.
  231.  
  232. z.B.
  233. [D1]
  234. PHONE=01712092522
  235. PROTOCOL=TAP
  236. PREFIX=0171
  237.  
  238.  
  239. sendsms.pbk
  240. -----------
  241.  
  242. Hier k÷nnen zu den einzelnen in sendsms.pro definierten
  243. Telefonnetzen (jeweils ein eigens Kapitel) Kⁿrzel (Alias) fⁿr eine
  244. bzw. fⁿr mehrere Telefonnummern definiert werden. Jedes Kⁿrzel
  245. steht in einer eigenen Zeile und danach durch '=' getrennt die
  246. zugeh÷rige Nummer (mit Vorwahl). Um Gruppen zu definieren, werden
  247. mehrere Nummern/Kⁿrzel durch Kommata getrennt. Das Telefonbuch
  248. steht nur in der registrierten Version zur Verfⁿgung!!!!
  249.  
  250. z.B.
  251. [D1]
  252. wobo=01714160598        ; Wolfgang B÷cherer
  253. ich=0171987654
  254. alle=wobo,ich           ; Wolfgang und ich
  255.  
  256. ------------------------------------------------------------------------------
  257.  
  258. Aufruf
  259. ------
  260.  
  261. SendSMS wird wie folgt aufgerufen
  262.  
  263.    sendsms {phoneNo | alias} [{message | < msgFile}]
  264.  
  265. Es ist mindestens ein Parameter - die Telefonnummer des EmpfΣngers bzw.
  266. ein Alias (Eintrag im Telefonbuch) - notwendig. Als zweiter Parameter wird
  267. die zu versendende Nachricht in Hochkommata angegeben (ACHTUNG: Je
  268. nach verwendeter Shell werden bestimmte Zeichen von dieser Interpretiert
  269. und ersetzt (z.B. '!'). Alternativ kann die zu versendende Nachricht auch
  270. ⁿber eine Umleitung aus einer Datei angegeben werden (< msgFile).
  271. Wird beim Aufruf von SendSMS nur ein Parameter (EmpfΣnger) angegeben,
  272. so wird die zu versendende Nachricht von der Konsole eingelesen bis
  273. eine Zeile mit nur einem Punkt '.' eingegeben wird.
  274.  
  275. ------------------------------------------------------------------------------
  276.  
  277. Wo finde ich die neue Version?
  278. ==============================
  279.  
  280. Die neuste Version finden Sie unter:
  281.  
  282.         http://www.bai.de/sendsms/sendsms.shtml
  283.  
  284. ------------------------------------------------------------------------------
  285. Wolfgang B÷cherer, Luisenstra▀e 62, D-76137 Karlsruhe
  286. Tel.: +49 (0)721/9374060, Fax.: +49 (0)721/9374061
  287.  
  288. EMail: wobo@bai.de
  289. WWW: http://www.bai.de
  290.