Dokumentation zu RequestUtil (RU.exe) Version 1.23 -------------------------------------------------- R E Q U E S T U T I L I T Y B E T A - V E R S I O N 1.25 RELEASED ON 06.02.1992 WRITTEN BY MIRKO K. MUCKO (2:242/94) Vorab ein herzlicher Dank an alle Beta-Tester und sonstige Personen, die mir bei der Erstellung dieses Tools hilfreich (?) zur Seite standen, allen voran folgende Herren : Hanstheo Wolf Wim Abels Carsten Teske Ingo Pahl Andreas Brodowski DANKE ! Seite - 1- ------------------------------------------------------------------ Programmversion 1.26 vom 06.02.1992 [Zum Thema "neue Struktur" von FrontDoor] "Die Botschaft hoert ich wohl, fuerwahr, mir fehlt der Glaube." ------------------------------------------------------------------ Einleitung RU ist ein Utility, welches Ihnen bei dem sog. Requesten von Files bei Nodes viel Arbeit ersparen kann. Das einzige, was Sie ben”tigen, ist ein Account als "Point" oder "Node" im FIDO-Netz und FrontDoor, Binkley oder vergleichbare Programme und optional eine Fileliste aller verfgbaren Files des Servers, bei dem Sie Files bestellen m”chten. Was tut es ? Mit RU k”nnen Sie mittels der Cursor-Tasten Files, welche Sie requesten wollen, auswaehlen, abwaehlen und bestellen, kurzum alles, was Sie frher "per Hand und Bleistift" erledigt haben. Aufruf Aufgerufen wird das Programm mit einem bis drei Parametern oder ohne Parameter im "Multi-Modus". Letzters heiát, das nacheinande an verschiedene Boxen mit verschiedenen Filelisten Filerequests verschickt werden k”nnen. Diese Option ist vor allem fr Sysops (wie 2:242/21) gedacht, die mit einem "Rund-um-Schlag" direkt bei allen Boxen, die er interessant findet, die jeweilige Filelist zu bestellen. Die Listennamen ergeben immer den entsprechenden Boxnamen, d.h. aus "02420094.lst" ist zu erkennen, daá es sich um die Box 242/94 handelt. Sollten sich bei der Umrechnung Probleme ergeben, fragt Sie RU zur Sicherheit nach der Adresse. Normalerweise beginnt die Fileliste immer mit der Zonenkennung (also z.B. 25070013.lst fr 2:507/13). Wenn diese Angabe vorhanden ist, wird sie benutzt , anderenfalls wird die Zone des Absenders, also Ihre eigene, als Ziel-Zone angnommen. Der "Multi-Modus" ist nur aktiv, wenn !_KEIN_! Parameter mit bergeben wurde ! Im "Normal-Modus" brauchen Sie nur den Namen der Fileliste zu selektieren, Net/Node und alles andere versucht das Programm selbst zu ermitteln. Falls Sie mal nicht sicher sind, wie alt die Fileliste ist, koennen sie mit eine kleine Information erfragen. Seite - 2- Im einzelnen sieht der Aufruf so aus : RU [/D] [Liste] [ArchivName] [/x]/[/r]/[/n] [/u] [/l]/[/t]/[/Snn][/Pxxx] /D gibt die Adresse des "remote systems" an, also des Systemes,bei dem Sie Files bestellen wollen. Ob ein System Requests zu- laesst, sollten Sie vorher abgeklaert haben (z.B. ist "2:507/1"ein sog. Mail-Only-System, der Sysop laesst keine Requests zu). Wenn jemend also z.B. bei mir etwas bestellen will, gibt er"2:242/94" ein. Es ist wichtig, die komplette Adresse anzugeben,also auch die (laestige) Zonen-Nummer. RU braucht dieAngabe u.A.fr "Inter zone requests", also Requests zu Remote- Systems in an-deren Zonen. Anbei : diese Requests werden als Crash-Mail geschickt, sie gehen ohne (!) Gate direkt an ihr Ziel. Sollte trotz aller Vorsicht die Zone vergessen worden sein, nimmt RU an, dass der Server sich in der Zone befinden, in der Ihr Point sich befinden. Liste gibt an, wo sich die Liste mit den Files einer Box befindet.Gew”hnlich besteht ihr Name aus der Net- und Nodenummer, in meinem Falle also "02420094" mit dem Suffix ".lst", so daá meine Eingabe "02420094.lst" waere. Ist die Listenangabe nicht vorhanden, wird aus der Net/Node-Adresse des Users der Name des Listenfiles errechnert und versucht, die Liste unter diesem Namen zu finden. ArchiveName Dieser Name steht fr das Archiv, wenn die /X-Option gesetzt wurde, aber das Archiv nicht aus dem Servernamen errechnet werden kann oder soll. /x Wenn diese Option gesetzt ist, wird die Liste in einem komprimierten Archiv vermutet. Entpacker und Directiven ermittelt das Programm aus der Extention. Sollte RU Ihren Packer nicht widererkennen, wird GUS (tm) geladen und mit ihm das File entpackt. In jedem Fall MUSS ein Path auf das Verzeichnis, in dem sich die Packer befinden, zeigen. Nach dieser Angabe k”nnen Sie die Fileliste, die Sie laden m”chten, mit den Cursortasten aussuchen. Es werden alle Files des unter "ListPath" in der Konfiguration angegebenen Directories angezeigt. Befinden sich im Archiv mehrere Files, mssen Sie wieder waehlen, welche Liste Sie benutzen m”chten. /n steht fr "No list". Es wird keine Liste geladen. Sie k”nnen aber auf diese Art und Weise komfortabel Programme manuell bestellen, z.B. die Fileliste einer Box. ACHTUNG ! Es darf nur eine der obigen "/"-Anweisungen angegeben werden ! Seite - 3- /l Steht fr "link a file". Wenn Sie z.B. bei mehreren (befreundeten) Sysops Files requesten wollen, freuen sich die Sysops bestimmt, wenn sie mal einen "netten Brief" (oder was auch immer) erhalten. Wenn Sie also /l angeben, wird ein vorbereitetes File (siehe Kapitel "Setup") mitgeschickt. Falls das File nicht gefunden wird, wird eine Standartnachricht geschickt. Wenn Sie Files bestellen, werden Sie sicherheitshalber noch einmal gefragt, ob Sie wirklich einen Text mitschicken m”chten. "/l" kann immer mit angegeben werden, auch wenn eine der anderen "/"-Optionen aktiviert wird. /t Bei "edit a Textfile" haben Sie die M”glichkeit, an jeden Sysop, „hnlich wie bei "link a file", ein TextFile mit abzuschicken, jedoch k”nnen Sie den Text fr jeden Request einzeln eingeben (mittels eines externen Editors). /snn Setzt die SearchSize (siehe Kapitel "Setup") tempor„r auf den Wert nn. Es kann nur eine der Optionen [/l], [/t] oder [/S] angegeben werden /Pxxx Falls das Archive mit einem Passwort versehen ist, kann es mit/Pxxx entpackt werden, wobei "xxx" das Passwort darstellt. Das Programm kann auch nur mit der Ziel_Adresse und "/x" aufgerufen werden oder im "Multi-Modus" ohne Parameter. /U In dieser Version unterstzt RU erstmals den RequestManager von Ulrich Bartelts "TrackM". Die Mails werden entsprechend dessen Konventionen generiert. Scrollen Mit den Cursor- bzw PAGE- Tasten k”nnen Sie nun den Balken auf das von Ihnen gewnschte File setzen. Durch und gelangen Sie an den Anfang bzw. an das Ende der Fileliste. De-/Selektieren Mit kann ein File selektiert werden, und durch deselektieren Sie das File wieder. Das Auswahl-Fenster Mit gelangen Sie in das "Selected"-Fenster. Hier k”nnen Sie durch direktes Auswaehlen der schon gewaehlten Files diese aus der Liste wieder streichen, ohne sie lange in der obigen Liste suchen zu mssen (klar ?). Auch hier entfernt die Taste das File aus der Bestellung beim Server. Mit der Taste erhalten Sie genauere Informationen ueber das selektierte File. ACHTUNG : Sie k”nnen maximal 36 Files w„hlen - dies sollte reichen und es ist auch das Maximale, was ein Server "verkraftet", bevor er das "Time out" losschickt und damit die Verbindung unterbricht. Seite - 4- Manueller Eintrag Um Files zu requesten, die nicht in der Liste stehen, drcken Sie fr "manuell entry". Passwort Da einige Systembetreiber nicht ”ffentlich requestbare Files bei sich lagern, die sie nur begrenzten Personengruppen zugaenglich machen, gibt Ihnen RequestUtil die M”glichkeit, durch Drcken von

ein Passwort fr das entsprechende File einzutragen, welches dann beim Verschicken der Nachricht entsprechende mitgeschickt wird. Bei passwortgeschtzten Files, bzw. bei solchen, bei denen Sie Passw”rter angegeben haben, erscheint ein Zeichen ("®") in der "SELECT"-Liste. Durch erneutes Drcken von

und wird das Passwort wieder gel”scht. {+} Wenn Sie ein File normal mit "Einfgen" selektieren, ”ffnet Sich ein Fenster mit den in der Passwort-Liste fr diesen Node eingetragenen Passw”rter. File-Find Mit (Find) k”nnen Sie ein File, dessen Namen Ihnen bekannt ist, suchen lassen.Wildcards sind nicht n”tig. Sollten sie dennoch angegeben werden, wertet RU sie als reale Zeichen !!! Mit (Continue) wird das Suchen forgesetzt, mit abgebrochen. Text-Find Wie auch bei File-Find k”nnen Sie mittels Text-Find einen String suchen lassen. Der gesuchte Text kann sich berall in der Liste befinden, es werden also nicht nur, wie bei File- Find, die ersten 13 Buchstaben einer Zeile gelesen. Auch hier l„át sich die Suche mit fortfhren. Jump to line Mit k”nnen Sie eine bestimmte Zeile direkt anspringen. Alias / Magic-Namen {+} Mit k”nnen sie aus einer Liste von Magic-Namen einen ausw„hlen. Sollte zu dem System auch noch ein Passwort im Passwort-File stehen, kann es dann ausgew„hlt werden ! DOS-Shell Mit gelangen Sie in eine tempor„re DOS-Umgebung, die Sie mit "EXIT" wieder verlassen k”nnen. Haben Sie alle Ihnen wichtig erscheinenden Files gew„hlt, k”nnen Sie mit im "Select"-Fenster die Nachricht abschicken oder sie mit verwerfen. ! ACHTUNG : selbstverstaendlich k”nnen Sie an JEDER Stelle des Programms (ausser beim Compilieren am Anfang) das Programm mittels verlassen. Ein Verschicken der Nachrichten an das Ziel- System wird dadurch unterbunden ! Seite - 5- Verschicken Nun erstellt RU die REQUEST-MAIL automatisch. Es werden alle Nachrichtenheader durch-"gescannt", um zu erkennen, ob schon eine Attachmail an dieses System vorliegt. Sollte dies der Fall sein, wird die "neue" Nachricht "appended", also "drangeh„ngen", ansonsten wird eine neue Nachricht generiert. Beim n„chsten Aufruf Ihres Mailers wird sie als "direct Crash- Mail" verschickt und die "Bestellung" gel”scht oder gekrzt, je nachdem, was in der Konfiguration angegeben wurde. Dupe Checking {+} Sollten Sie im Setup "Dupe check" angegeben haben, wird das (hoffentlich vorhandene) File "INDEX.RU" nach den Files gescannt, die Sie bestellen wollten. Dies kostet zwar einige Sekunden Zeit, ist aber fr Sysops, die keinen šberblick ber Ihre Festplatte haben unentbehrlich. Sollten Sie (immer noch) eine unregistrierte Version von RU haben, sendet das Programm "freundlicher Weise" eine Tear-Line mit der Nachricht mit, so daá der Sysop des Zielsystems auch weiá, daá mit einer unregistrierten Version gearbeitet wurde/wird. Angekommen ? Die bestellten Files befinden sich dann in jenem Verzeichnis, in das auch ihre sonstigen Programme und downgeloaedete Daten "landen", meist ist dies das "INBOUND"-Verzeichnis. Hilfe Sollten Sie beim "Bestellen" mal nicht weiter wissen, ist eine Mini-Hilfe eingebaut. Sie erreichen sie ber . Die šbersicht ber die Tastenfunktionen erfahren Sie mit Fehler beim Bestellen : - Sie k”nnen nicht mehr als 36 Files ausw„hlen. - Sie haben ein schon gewaehltes File noch einmal zu waehlen versucht. - Sie haben ein noch nicht selektiertes File aus der Bestelliste zu streichen versucht. - Sie versuchen, in der Liste weiter nach oben/unten zu gehen, obwohl Sie bereits am Anfang / Ende der Liste sind. - Sie haben beim "manuell entry" ungltige Daten eingegeben. Seite - 7- Fehler beim Aufrufen : Es wird immer eine (soweit m”glich) genaue Fehlerbeschreibung und eine Musterbeispiel ausgegeben. Fehlerquellen : - Falsche Origin-Net/Node-Adresse - Falsche Destination-Net/Node-Adresse - Fileliste ist nicht zu finden - Packer nicht gefunden - Archiv nicht gefunden - nicht gengend Speicher zum Laden des Packers vorhanden - nicht gengend Speicher zum Erstellen des Index vorhanden - overlay Datei (RU.ovr) nicht gefunden oder defekt - nicht gengend Speicher fr die Overlay-Datei vorhanden - Keine Listen im angegebenen Verzeichnis Ausserdem wird der Fehler in der Datei "RU.ERR" vermerkt. Viel Spass im Fido-Net wnscht Ihnen Mirko K. Mucko 2:242/94.0 (Plutonium RA BBS) Disclaimer Das Programm darf nur mit diesem Text in unverf„lschtem Zustand weitergegeben werden. Es darf frei kopiert oder maschinell verarbeitet, nicht aber in sog. PD-Serien aufgenommen werden. Warum registrieren ? Recht einfach zu beantworten ist diese Frage. Anfangs kamen immer Netmails mit "boh, ey, dein schxxxx Programm hat mir die Platte dich gemacht" oder „hnlichen zivilisierten Žusserungen. Da nun auch diese ausblieben, hab ich eine Art šberblick, wieviele interessierte Benutzer es fr dieses Programm berhaupt gibt. Fr die Registrierung verwenden Sie bitte das beigefgte Dokument "REGISTER.TXT". Der Betrag (min. DM15 oder US-$10) ist zu berweisen an : MIRKO K. MUCKO Deutsche Bank Dsseldorf Ktnr. 5457304 / 00 Blz. 300 700 10 oder per Scheck/bar zu schicken an Mirko K. Mucko Thomas-Mann-Str.43 4000 Dsseldorf 30 Der Key gilt fuer diese und alle folgenden Versionen von RU und RUSetup. Alle Optionen, die mit {+} versehen sind, funktionieren ausschliesslich in der registrierten Version. Spenden : Spenden werden natrlich gern entgegengenommen, auch wenn sie noch so klein sind. (gr”ssere Spenden werden sp„ter in einer Spendenliste mit dem Programm ver”ffentlicht 8-}. Spaá beiseite. Das Programm hat mir - neben einigen schlaflosen Naechten - sehr viel Freizeit fr die Entwicklung gestohlen, daher finde ich es angemessen, daá es auch finanziell ein Ansporn fr mich geben sollte , weiter zu programmieren und nicht alles hin zu werfen. Seite - 8- Garantie : Ich kann weder fr das Programm selbst noch fr Sch„den an Hard- oder Software die Verantwortung bernehmen. Die Benutzung geschieht auf eigene Gefahr. Verbesserungsvorschlaege/bugreports sollten mir aber mitgeteilt werden. Trotz allem kann ich dafr garantieren, dass mein Tool mehr Platz auf Ihrer Platte wegnimmt, als Ihnen lieb sein wird...;-} Copyrights Fido und FidoNet sind Eingetragene Warenzeichen von Tom Jennings. Es sind die jeweils geltenden Fido-Policies zu beachten ! TrackM ist geistiges Eigentum von Ulrich Bartelt. FrontDoor ist gestiges Eigentum von Johaquim H. Homrigheusen und Advanced Egeneering Software SARL Viel Spass im FIDO-Netz ! mm+ Mirko Mucko, 06.02.92