@database UCall @node "Main" UCALL - universaler Mailer V 1.9 vom 24.8.1995 Freeware von Lunqual%mab@wsb.freinet.de @{" Einleitung" link "Document_0" 0} @{" Systemvoraussetzungen" link "Document_1" 0} @{"Installation" link "Document_2" 0} @{"Das Programm" link "Document_3" 0} @{" Konfigurationsfile " link "Document_4" 0} @{" Loginscript" link "Document_5" 0} @{" Bugs & anderes" link "Document_6" 0} @endnode @node "Document_0" " Einleitung" UCall ist ein universaler Mailer, d.h. ein Programm, was selbständig eine Mailbox anruft, Pointpuffer abholt und verschickt. Im Gegensatz zu gängigen Produkten verwendet UCall keine festgelegte Loginprozedur, sondern wird von einem Loginscript gesteuert. Nun, wieso gibt es das Programm überhaupt ? Gibts nicht genug andere MAiler ?? Naja, doch, schon... aber diese Mailer fallen in 2 Kategorien: erstens die Teile, die zwar im allgemeinen funktionieren, aber nicht im besonderen, weil meine Leib- und Magenbox halt vor das login noch ein Linefeed gesetzt haben will, was den dämlichen Mailer ganz aus dem Tritt bringt, weil er halt ohne zu fragen gleich den Usernamen + linefeed schickt ! zweitens die Programme, die zwar im allgemeinen wie auch im besonderen funktionieren, aber mir mit der hartnäckigen Behauptung dass ich irgendeinem Raubritter 20 Magg schulden würde stark auf die Nerven fallen. Deswegen zählt UCall zur dritten Kategorie: Lunqualitätsware ! Die neigt zwar im allgemeinen auch zum Versagen, aber funktioniert dafür im besonderen ganz gut. ;) Aber trotzdem: **************************************************************** UCall ist FREEWARE. Das Programm kann ohne Einschränkung kopiert und/oder weitergegeben werden, wenn das Archiv vollständig bleibt. Folgende Dateien sind in diesem Archiv: Bin (dir) catalogs (dir) english (dir) ucall.catalog UCall UCall.info Source (dir) english.ct english.ct.info SCOPTIONS SCoptions.info ucall.c ucall.c.info ucall.cd ucall.cd.info ucall.h ucall.h.info UCall.lnk Dok (dir) UCall.guide UCall.guide.info ucall.history ucall.history.info Script (dir) ucall.config ucall.config.info znetz.login znetz.login.info Bin.info Dok.info Script.info Source.info Der Autor übernimmt keinerlei Haftung für Schäden oder Fehlfunktionen, die aus der Benutzung des Programms entstehen können. ***************************************************************** @endnode @node "Document_1" " Systemvoraussetzungen" Systemvoraussetzungen von UCall: 1. Kickstart/Workbench 2.0 oder besser Wer das noch nicht hat, dem is nimmer zu helfen ! ;) 2. metaxpr.library V2 oder besser. 3. Optional Locale.library (Keine Bedingung) @endnode @node "Document_2" "Installation" Da gibts nicht viel zu installieren. Kopieren Sie die metaxpr.library ins LIBS:-Verzeichnis, sofern sich dort noch keine befindet und das UCall Programm irgendwohin. Die eingebaute Sprache ist Deutsch. Wenn sie (ab WB 2.1+) die englische Version benutzen wollen, sollten sie die Datei bin/catalogs/english/ucall.catalog nach LOCALE:catalogs/english/ kopieren @endnode @node "Document_3" "Das Programm" UCall kann nur aus einer Shell heraus verwendet werden. Programmaufruf: 'UCall <@{"konfigurationsfile" link "Document_4" 0}> <@{"loginscript" link "Document_5" 0}>' Beide Files MÜSSEN vorhanden sein. Im Konfigurationsfile stehen alle Angaben über Modem/Schnittstelle Übertragunsprotokolle usw., während das Loginscript Telefonnummern u.ä. enthält. Das Programm kann jederzeit durch ein herzhaftes control-c abgebrochen werden. @endnode @node "Document_4" " Konfigurationsfile " Das Konfigurationsfile enthält die Befehle für die verwendeten SChnittstelle,Protokolle usw. Die Konfigurationsdaten können in einem beliebigen Textfile (bspw. ums-konfiguration) stehen. Die Daten beginnen mit der Zeile "UCall-config" und enden entweder am Ende des Files oder bei einer weiteren Zeile mit "UCall-config" Das format einer Zeile ist befehl= wobei der Wert DIREKT auf das Gleichheitszeichen folgen muss. Befehle sind : DEVICE= Das verwendete Device, z.B. serial.device, nullmodem.device etc Voreinstellung = serial.device UNIT= Die verwendete Unit, z.B. 0 Voreinstellung = 0 BAUD= Die Schnittstellengeschwindigkeit, z.B. 19200, 38400 usw. Voreinstellung = 19200 BUSY = NOCARRIER= DELAYED= ERROR = CONNECT = Hier werden die Zeichenketten eingetragen, die das Modem im entsprechenden Fall schickt. XPRLIB= Hier ist das verwendete Übertragungsprotokoll einzutragen, z.B. xprzmodem.library usw. Voreinstellung = xprzmodem.library XPROPTS= Die Optionen des Protokolls. Keine Voreinstellung DATABITS =<7/8> Anzahl der Datenbits Voreinstellung 8 PARITY = Parität Voreinstellung None STOPBITS =<0/1/2> Anzahl der Stopbits Voreinstellung 1 RTS/CTS RTS/CTS-Handshake Voreinstellung RTS/CTS XON/XOFF XON/XOFF-Handshake Beispiel-Konfiguration: ----------------------------schnipp---------------------- UCall-config DEVICE =nullmodem.device UNIT =0 BAUD =19200 BUSY =BUSY NOCARRIER =NO CARRIER NODIALTONE =NO DIALTONE DELAYED =DELAYED ERROR =ERROR CONNECT =CONNECT XPRLIB =xprzmodem.library XPROPTS =TN,OR,B256,F0,E20,AN,DN,KY,SN,RN,P DATABITS =8 PARITY =NONE STOPBITS =1 RTC/CTS ----------------------------schnapp---------------------- @endnode @node "Document_5" " Loginscript" Hier wird der Loginvorgang "programmiert" Das geht so, dass Zeichenketten ans Modem gesendet werden, zum initialisieren der SChnittstelle oder zum Wählen und im Gegenzug auf gewisse Schlüsselworte wie "Username:" gewartet wird um entsprechend zu reagieren. Die vorhandenen Befehle im einzelnen: 1. Allgemeine Befehle end Programmende delay Pause von x sekunden. Wenn kein Wert angegeben ist, wird die Länge der Anwahlpause (siehe pause-befehl) benutzt. getenv = Der variablen wird der Wert der Standard-AmigaDos-Environment-Variablen zugewiesen. MUSS unmittelbar nach dem Gleichheitszeichen kommen. Beispiel : getenv ks =Kickstart im Script wird dann an jeder Stelle, an der $ks steht, der Inhalt der Env-Variablen 'Kickstart' eingesetzt. linebuffer Die maximale Länge einer Scriptzeile Voreinstellung ist 1024, mehr ist jederzeit möglich, Mindestwert ist 512 Byte msg Eine Message wird angezeigt. Der Text kann auch \n und \r sowie \x Statements enthalten. pause Die Anwahlpause in Sekunden, wenn die Nummer besetzt ist, oder protocol öffnet die angegebene Protokolldatei protmsg schreibt die in die Protokolldatei showlogin Der gesamte Loginvorgang wird in das File geschrieben. Wenn kein File angegeben ist, dann wird "con:0/0/640/400/UCall-Login" verwendet. set = Die Variable wird auf den Wert gesetzt. Der Wert MUSS unmittelbar nach dem Gleichheitszeichen kommen. Beispiel : set username =LUNQUAL\r\n im Script wird dann an jeder Stelle, an der $username steht, LUNQUAL\r\n eingesetzt. setenv = Die (Standard-AmigaDos-Environment-)Variable wird auf den Wert gesetzt. Der Wert MUSS unmittelbar nach dem Gleichheitszeichen kommen. Beispiel : setenv erfolg =ok Diese Environment-variablen stehen dann global dem System zur Verfügung und können mit getenv ausgelesen werden. system Das angegebene Kommando wird von der Shell ausgeführt timeout Die Zeit, die ein wait-Befehl höchstens brauchen darf. Wird diese Zeit überschritten wird die Programmausführung am timeout_label fortgesetzt oder abgebrochen wenn dieses nicht vorhanden ist. timeout_label Das Script wird nach einem Timeout an dieser Stelle fortgesetzt workdir Das neue Arbeitsverzeichnis wird gesetzt. Muss vor dem Download gesetzt werden, da empfangene Files ins momentane Verzeichnis gehen 2. Senden / Empfangen connect Das Programm versucht einen Connect aufzubauen. Wenn die angegebenen Nummer besetzt ist, wird vor dem nächsten Anwahlversuch sekunden gewartet getfile eine Datei wird mit dem voreingestelleten xpr-protokoll empfangen. Hier ist noch ein Bug, die Datei landet im aktuellen Verzeichnis ;) (Im Zweifelsfall mit workdir setzen) Wenn erfolgreich wird das Flag 1 gesetzt putfile Die angegebene Datei wird mit dem voreingestellten xpr-protokoll gesendet. Wenn erfolgreich, wird das Flag 1 gesetzt. send Die Angegebene Zeichenkette wird an die SChnittstelle ausgegeben. Beispiel: send Das ist ein Test\r\n sendfile Der Inhalt des angegebenen Files wird UNVERÄNDERT als Text an die Schnittstelle geschickt. Nicht zu verwechseln mit 'putfile' ! Da sich das aktuelle Verzeichnis im Programmverlauf ändern kann, wird empfohlen, das File mit komplettem Pfad anzugeben. wait ,,. Es wird auf den die angegebenen Texte von der SChnittstelle gewartet. Die Texte dürfen auch Standard-Amigados Muster enthalten, z.b. "#?wort:", und werden durch Kommata voneinander getrennt. Es sind maximal 16 Muster zu je 64 Zeichen zulässig. Wer mehr braucht, muss in UCall.h das #define MAX_BREAKCHARS ändern und den ganzen Unfug neu übersetzen. Wenn diese Funktion ein Muster gefunden hat, wird dieses gespeichert und steht einer folgenden if- Anweisung zur Verfügung. WICHTIG: Das Programm vergleicht jeweils mit dem LETZTEN Zeichen des Textes, das deswegen KEIN muster SEIN DARF !. Beispiel: wait NO#?CARRIER,ERROR,OK HINWEIS: \n oder \r darf NUR AM ENDE der Zeile vorkommen ! Die Anweisung : wait NO CARRIER\n,ERROR funktioniert NICHT !!! 3. Kontrollstrukturen gosub