home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / SENDSMS / liesmich.txt < prev    next >
Text File  |  1997-09-13  |  14KB  |  387 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. Zur Registrierung fⁿllen Sie bitte das beiliegenden Formular (bestell.txt)
  22.    aus und senden es mit einem entsprechenden EC-Scheck an folgende Adresse:
  23.  
  24.              Wolfgang B÷cherer
  25.              Im Grⁿn 9
  26.              D-76316 Malsch
  27.  
  28.              Tel.: +49 (0)7246/942484
  29.              Fax.: +49 (0)7246/942485
  30.              EMail: wobo@bai.de
  31.              WWW: http://www.bai.de
  32.  
  33.  
  34.    Die Registrierungsgebⁿhr betrΣgt fⁿr eine Lizenz
  35.    (Installation auf einem Rechner):
  36.  
  37.    private Nutzung                50,-- DM
  38.    kommerzielle Nutzung          200,-- DM
  39.    (Auslandsⁿberweisungen zzgl.   20,-- DM)
  40.    Alle Preise zzgl. der gesetzlichen Mehrwertsteuer von z.Zt. 15%.
  41.  
  42.    (Anfragen zu Mehrfachlizenzen oder Reseller-Optionen willkommen)
  43.  
  44.    Es sind natⁿrlich auch Verrechnungsschecks, Postanweisungen und
  45.    Zahlung gegen Rechnung m÷glich (Privatlinzenzen nur gegen
  46.    Vorausbezahlung).
  47.  
  48.    A C H T U N G!!! Zur Registrierung unbedingt das zu verwendende
  49.    Betriebssystem und die Telefonnummer angeben.
  50.  
  51. 5. Nach Zahlungseingang (unter Angabe der Telefonnummer und des
  52.    verwendeten Betriebsystems) wird ein Registrierungsschlⁿssel an den
  53.    Lizenznehmer verschickt, der ihn zur weiteren Verwendung des
  54.    Programms auf einem Rechner berechtigt. Die Weitergabe des
  55.    zugeteilten Registrierungsschlⁿssel ist untersagt.
  56.  
  57. 6. Die Verwendung des Programms erfolgt auf eigenes Risiko. Fⁿr eventuelle
  58.    SchΣden (z.B. Telefonrechnung) durch Fehlbedienung oder Fehlfunktion des
  59.    Programms wird nicht gehaftet.
  60.  
  61.  
  62. ------------------------------------------------------------------------------
  63.  
  64. Allgemeines
  65. -----------
  66.  
  67. SendSMS ist ein Shareware-Programm zum Versenden von ShortMessages (SMS) zu
  68. GSM-Telephonen oder Pagern mittels der Protokolle TAP bzw. UCP. In Deutschland
  69. sind dies z.B. Telephone mit D1-, D2- oder EPlus-Karte oder verschiedene Pager
  70. (Quix, TeLMI, CityRuf, Scall, Skyper,...). SendSMS hat u.a.
  71. folgende FΣhigkeiten:
  72.  
  73. - UCP- und TAP-Protokoll (z.B.: D1, D2, EPlus, Quix, TeLMI, CityRuf, Scall, Skyper)
  74. - beliebig konfigurierbar fⁿr weitere Dienstanbieter mit TAP oder UCP
  75. - Nachricht kann ⁿber Kommandozeile oder aus einer Datei angegeben werden
  76.   (Batchmodus m÷glich)
  77. - Telefonbuch: anstelle der Telefonnummer k÷nnen definierte Kⁿrzel benutzt
  78.   werden (*)
  79. - Versenden von Nachrichten an mehrere EmpfΣnger in unterschiedlichen Netzen
  80. - fⁿhren einer Protokolldatei (Logdatei) bzw. Protokollierung ⁿber syslogd (*)
  81. - Definition der Anzahl der Wahlwiederholungen m÷glich (*)
  82. - frei definierbare Pause zwischen den Wahlversuchen
  83. - Modem wird zwischen den Wahlversuchen nicht blockiert
  84. - Konfiguration fⁿr beliebige Modems m÷glich
  85. - korrekte Verwendung von Umlauten
  86. - verfⁿgbar auf vielen verschiedenen Betriebssystemen
  87. - Definition von Kopf- und/oder Fu▀zeile
  88.  
  89. Mit (*) gekennzeichnete Punkte sind nur in der registrierten Version verfⁿgbar.
  90.  
  91. ------------------------------------------------------------------------------
  92.  
  93. Installation
  94. ------------
  95.  
  96. Die ZIP-Datei (alternativ auch tar.Z) wird in einem beliebigen Unterverzeichnis
  97. entpackt. Danach gibt es die folgenden Dateien:
  98.  
  99.  
  100.   liesmich.txt        - diese hier
  101.   sendsms[.exe]       - das eigentliche Programm
  102.   sendsms.cfg         - Konfigurationsdatei
  103.   sendsms.err         - Fehlermeldungen
  104.   sendsms.pro         - Telefonnetz-Definitionen
  105.   sendsms.pbk         - Telefonbuch
  106.  
  107. (Die OS/2-Version ben÷tigt die EMX-Runtime-Umgebung
  108. http://www.leo.org/pub/comp/os/os2/leo/index.html)
  109.  
  110. (Die DOS-Version ben÷tigen einen Fossil-Treiber,
  111. z.B. adf.exe http://www.digsys.se)
  112.  
  113. ------------------------------------------------------------------------------
  114.  
  115. Konfiguration
  116. -------------
  117.  
  118. In der Datei 'sendsms.cfg' wird die allgemeine Konfiguration des Pro-
  119. gramms festgelegt.
  120.  
  121. In der Datei 'sendsms.pro' werden die verschiedenen Telefonnetze (welches Netz
  122. benutzt TAP bzw. UCP, ⁿber welche Telephonnummer wird die Nachricht verschickt und
  123. welche Vorwahl haben die Nummern des entsprechenden Netzes) konfiguriert.
  124.  
  125. In der Datei 'sendsms.pbk' werden Kⁿrzel zum WΣhlen mittels symbolischer Namen
  126. anstelle von Telefonnummern definiert.
  127.  
  128. Kommentare werden in durch einen Strichpunkt (;) oder durch
  129. ein Gatter (#) eingeleitet.
  130.  
  131.  
  132. ------------------------------------------------------------------------------
  133. sendsms.cfg
  134. -----------
  135.  
  136. Hier stehen die im Folgenden aufgefⁿhrten Schlⁿsselworte zum Konfigurieren
  137. von SendSMS zu Verfⁿgung. Jedes Schlⁿsselwort mu▀ in einer neuen Zeile stehen.
  138. In der Regel mu▀ diese Datei fⁿr einen Probelauf nicht geΣndert werden (au▀er
  139. MODEMINIT, MODEMDIAL und MODEMDEVICE). Fⁿr die entsprechenden Modembefehle wird
  140. auf ihr Modemhandbuch verwiesen (soweit vorhanden).
  141.  
  142. MODEMINIT=ATL1E1Q0V1
  143. Gibt das Initialisierungskommando fⁿr ihr Modem an.
  144. Vor diesem Kommando wird immer ein ATZ an das Modem gegeben.
  145. Das Modem mu▀ auf
  146.    Echo an
  147.    Antwort an
  148.    Antwort als Text
  149. eingestellt werden.
  150.  
  151. MODEMHANGUP=ATH
  152. Gibt das Kommando zum Auflegen an.
  153.  
  154. MODEMDIAL=ATDT0w
  155. Gibt das Kommando zum wΣhlen einer Nummer an (hier Tonwahl und nach einer '0'
  156. auf das Freizeichen warten)
  157.  
  158. MODEMDEVICE=COM1
  159. Gibt den Anschlu▀ an, an dem das Modem hΣngt (unter Unix z.B. /dev/ttyS0).
  160. (Achtung: unter Unix mu▀ unbedingt darauf geachtet werden, da▀ das richtige
  161. Device angegeben ist und der Benutzer berechtigt ist dies zu benutzen)
  162.  
  163. MODEMESCAPE=+++
  164. Gibt die Fluchtsequenz an, welche zum Umschalten vom Datenmodus in den
  165. Befehlsmodus dient.
  166.  
  167. WAITAFTERWRITE=1
  168. Gibt die Anzahl Sekunden an, die nach jedem Schreiben auf das Modem
  169. gewartet wird (kann in den meistens auf 0 gesetzt werden).
  170.  
  171. BAUD=1200
  172. Gibt die zu verwendende Baudrate an (300, 600, 1200, 2400, 4800 oder 9600)
  173.  
  174. DATABITS=8
  175. Gibt die Anzahl der Datenbits an (7 oder 8)
  176.  
  177. STOPBITS=1
  178. Gibt die Anzahl der Stopbits an (1 oder 2)
  179.  
  180. PARITY=NONE
  181. Gibt die Art der ParitΣt an (NONE, EVEN oder ODD)
  182.  
  183. TIMEOUT=40
  184. Gibt die Zeitdauer (in Sekunden) an, die das Programm auf die CONNECT-Meldung
  185. wartet.
  186.  
  187. LOCKDIR=/var/spool/uucp
  188. Gibt das Verzeichnis an, in dem eine Lockdatei gesucht bzw. angelegt wird
  189. (nur UNIX).
  190.  
  191. BINLOCKS=0
  192. Gibt an, ob die Lockdatei binΣr (1) oder ASCII angelegt wird.
  193.  
  194. LOGFILE=sendsms.log
  195. Gibt das Logfile an, in dem SendSMS alle Aktionen protokolliert. Wird das
  196. File ohne Pfad angegeben, so wird es in dem Verzeichnis in dem das
  197. Programm steht angelegt. Wird als LOGFILE 'syslog' (nur Unix) angegeben,
  198. so wird ⁿber den syslog-DΣmon protokolliert. [nur in der registrierten Version]
  199.  
  200. HEADER=
  201. Gibt einen optionalen Header an (ein Text, der vor jede zu versendende
  202. Nachricht gestellt wird) [nur in der registrierten Version]
  203.  
  204. FOOTER=
  205. Gibt einen optionalen Footer an (ein Text, der an jede zu versendende
  206. Nachricht angehΣngt wird) [nur in der registrierten Version]
  207.  
  208. REDIALCOUNT=1
  209. Gibt die Anzahl von Wahlversuchen an
  210. [nur in der registrierten Version]
  211.  
  212. REDIALDELAY=60
  213. Gibt die Anzahl Sekunden an, die bis zum nΣchsten Wahlversuch gewartet wird.
  214. In der Zeit bis zum nΣchsten Wahlversuch wird das Modem wieder freigegeben.
  215.  
  216. PHONE=
  217. Gibt die eigene Telephonnummer, von der die Nachricht ausgeht, an.
  218.  
  219. MAXERRORS=
  220. Gibt die Anzahl Fehler (Nachricht nicht gesendet) an, die bis zu einem
  221. Programmabbruch akzeptiert werden. Ist dieser Parameter nicht bzw. auf 0
  222. gesetzt, so wird nach einer fehlerhaften oder nicht ⁿbertragenen Nachrich
  223. NICHT abgebrochen. Dieser Parameter hat nur Bedeutung, wenn an mehrere
  224. EmpfΣnger gesendet wird.
  225.  
  226.  
  227. sendsms.pro
  228. -----------
  229.  
  230. Hier werden die verschiedenen Dienstanbieter (in unregistrierter Version
  231. maximal 3) konfiguriert. Fⁿr jeden Dienstanbieter mu▀ ein 'Kapitel'
  232. angelegt werden. Dies erfolgt durch eine Zeile mit dem Namen des
  233. Dienstanbieters in eckigen Klammern ([]) eingeklammert und den
  234. folgenden Parametern:
  235.  
  236. PHONE=
  237. Hier wird die Telefonnummer, ⁿber die Nachrichten an das entsprechende
  238. Netz gesendet werden k÷nnen, angegeben. Ist das letzte Zeichen einer Nummer
  239. ein '&', so bedeutet dies, da▀ beim AnwΣhlen des Providers an diese Nummer
  240. die Nummer des EmpfΣngers angehΣngt wird.
  241.  
  242. PROTOCOL=
  243. Hier mu▀ TAP, UCP, Scall oder Skyper stehen.
  244.  
  245. PREFIX=
  246. Hier steht die Vorwahl des entsprechnden Netzes. Anhand dieser Vorwahl wird
  247. beim Aufruf von SendSMS mit einer Telefonnummer (kein Alias aus dem Telefonbuch)
  248. ⁿberprⁿft, zu welchem Netz die entsprechende Telefonnummer geh÷rt.
  249.  
  250. REMOVEPREFIX=
  251. Die Nummer des EmpfΣngers wird zusammen mit der zu ⁿbersendenden Nachricht verschickt.
  252. Da bei manchen Providern nur die Nummer (ohne Vorwahl) angegeben werden mu▀, kann
  253. man mit diesem Parameter (=1) angeben, da▀ der PREFIX (falls definiert) nicht gesendet
  254. wird.
  255.  
  256. MSGTYPE=
  257. Gibt an, ob die Nachricht nur Ziffern (NUMERIC), beliebige Zeichen
  258. (ALPHANUMERIC) oder gar keine Zeichen (TONE) enthalten darf
  259. (ALPHANUMERIC ist der Standard).
  260.  
  261. MSGLEN=
  262. Hier wird die maximale LΣnge einer Nachricht angegeben.
  263.  
  264.  
  265. z.B.
  266. [D1]
  267. PHONE=01712092522
  268. PROTOCOL=TAP
  269. PREFIX=0171
  270. MSGTYPE=ALPHANUMERIC
  271. MSGLEN=160
  272.  
  273.  
  274. sendsms.pbk
  275. -----------
  276.  
  277. Hier k÷nnen zu den einzelnen in sendsms.pro definierten
  278. Telefonnetzen (jeweils ein eigens Kapitel) Kⁿrzel (Alias) fⁿr eine
  279. bzw. fⁿr mehrere Telefonnummern definiert werden. Jedes Kⁿrzel
  280. steht in einer eigenen Zeile und danach durch '=' getrennt die
  281. zugeh÷rige Nummer (mit Vorwahl). Das Telefonbuch
  282. steht nur in der registrierten Version zur Verfⁿgung!!!!
  283.  
  284. z.B.
  285. [D1]
  286. wobo=01714160598        ; Wolfgang B÷cherer
  287.  
  288. ------------------------------------------------------------------------------
  289.  
  290. Aufruf
  291. ------
  292.  
  293. SendSMS wird wie folgt aufgerufen
  294.  
  295.    sendsms [Optionen] {phoneNo | alias | @<grpFile>} [{message | < msgFile}]
  296.  
  297.    Optionen sind:
  298.       -P<provider>      gibt den Provider zur angegebenen Telefonnummer an
  299.       -F<msgFile>       gibt den Namen eines Files an, dessen Inhalt als
  300.                         Nachricht verschickt werden soll
  301.       -C<cfgFile>       gibt den Namen der Konfigurationsdatei an (sendsms.cfg)
  302.       -R<proFile>       gibt den Namen der Providerdatei an (sendsms.pro)
  303.       -B<pbkFile>       gibt den Namen der Telefonbuchdatei an (sendsms.pbk)
  304.  
  305. Z.B.: sendsms 0171xxxxx "Ich teste SendSMS."
  306.  
  307. Es ist immer mindestens ein Parameter - die Telefonnummer des EmpfΣngers bzw.
  308. ein Alias (Eintrag im Telefonbuch) - notwendig. Beginnt dieser erste Parameter
  309. mit einem Masterspace (@), so gibt dieser nicht eine Nummer bzw. ein Alias an, sondern
  310. den Namen einer Datei, welche die Nummern von mehreren EmpfΣnger beinhaltet. Mit
  311. solch einer Datei eine kann eine Nachricht an beliebig viele EmpfΣnger, welche auch ⁿber
  312. verschiedene Netze erreichbar sind, versendet werden. Eine entsprechende Datei mu▀
  313. folgendes Format haben:
  314.  
  315. [<provider1>]
  316. <nummer1>
  317. <nummer2>
  318. <nummer3>
  319. <alias1>
  320. <alias2>
  321.  
  322. [<provider2>]
  323. <nummer4>
  324.  
  325. Durch eckige Klammern eingerahmt wird ein Provider (mu▀ in der Datei sendsms.pro
  326. vorhanden sein) angegeben, zu welchem in den folgenden Zeilen Telefonnummern fⁿr
  327. EmpfΣnger folgen. Pro Zeile wird eine Nummer bzw. ein Alias angegeben, die
  328. alle ⁿber den entsprechenden Provider erreichbar sind und an die innerhalb von
  329. einer Verbindung die entsprechende Nachricht gesendet wird.
  330. In obigem Fall wird die Nachricht also an 5 Nummern des ersten Providers
  331. und an eine Nummer des zweiten Providers gesendet (in zusammen 2 Verbindungen).
  332.  
  333. Als zweiter Parameter wird die zu versendende Nachricht in Hochkommata angegeben
  334. (ACHTUNG: Je nach verwendeter Shell werden bestimmte Zeichen von dieser
  335. interpretiert und ersetzt (z.B. '!') und mⁿssen anstatt Hochkommata doppelte
  336. Hochkommata angegeben werden). Alternativ kann die zu versendende Nachricht auch
  337. ⁿber eine Umleitung aus einer Datei angegeben werden (< msgFile) oder mit dem
  338. Parameter -F<msgFile>, wobei <msgFile> den Namen einer Datei angibt, deren
  339. Inhalt als Nachricht (zumindest die ersten n Zeichen) versendet wird.
  340. Wird beim Aufruf von SendSMS nur ein Parameter (EmpfΣnger) angegeben,
  341. so wird die zu versendende Nachricht von der Konsole eingelesen bis
  342. eine Zeile mit nur einem Punkt '.' eingegeben wird (nicht in der Version
  343. fⁿr Windows 3.x). Soll eine Nachricht an einen Provider gesendet werden,
  344. welcher anhand der Nummer des EmpfΣngers nicht eindeutig zu identifizieren
  345. ist, so mu▀ ⁿber den Paramere -P<provider> der entsprechende Provider angegeben
  346. werden (Name wie er in der Datei 'sendsms.pro' definiert ist).
  347. Z.B.: Es soll eine Nachricht an einen Quix-EmpfΣnger gesendet werden.
  348. Da SendSMS anhand der Quix-Nummer (7-stellige Nummer ohne Vorwahl) nicht
  349. erkennen kann, was dies fⁿr eine Nummer ist, mu▀ zusΣtzlich beim Aufruf
  350. -PQuix angegeben werden (bei D1-Nummern wird an der Vorwahl (0171) erkannt,
  351. da▀ es eine D1-Nummer ist).
  352.  
  353. ------------------------------------------------------------------------------
  354.  
  355. Wo finde ich die neue Version?
  356. ==============================
  357.  
  358. Die neuste Version finden Sie unter:
  359.  
  360.         http://www.bai.de/sendsms/sendsms.shtml
  361.  
  362. ------------------------------------------------------------------------------
  363.  
  364. Probleme/Fragen
  365. ===============
  366.  
  367. Schicken Sie eine Email mit folgenden Angaben
  368.  
  369. - Fehler-/Problembeschreibung
  370. - Kopie/Hardcopy des Aufrufs
  371. - Kopie der Datei sendsms.cfg
  372. - Kopie der Datei sendsms.pro
  373. - verwendetes Betriebssystems
  374. - verwendete Version von SendSMS
  375. - verwendetes Modem und Telefonanlage
  376.  
  377. an:
  378.  
  379. wobo@bai.de
  380.  
  381. ------------------------------------------------------------------------------
  382. Wolfgang B÷cherer, Luisenstra▀e 62, D-76137 Karlsruhe
  383. Tel.: +49 (0)721/9374060, Fax.: +49 (0)721/9374061
  384.  
  385. EMail: wobo@bai.de
  386. WWW: http://www.bai.de
  387.