home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Der Mediaplex Sampler - Die 6 von Plex
/
6_v_plex.zip
/
6_v_plex
/
DISK3
/
DFUE_14
/
RU125.ZIP
/
RU.TXT
< prev
next >
Wrap
Text File
|
1992-02-06
|
15KB
|
378 lines
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 verfügbaren 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 früher "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 für 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 für 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 <SPACE> eine kleine Information erfragen.
Seite - 2-
Im einzelnen sieht der Aufruf so aus :
RU [/D<Ziel_Adresse>] [Liste] [ArchivName] [/x]/[/r]/[/n] [/u]
[/l]/[/t]/[/Snn][/Pxxx]
/D<Ziel_Adresse>
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.für "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 für 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, müssen Sie
wieder waehlen, welche Liste Sie benutzen möchten.
/n
steht für "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 für "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 für 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 unterstüzt 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 gewünschte File setzen. Durch <POS1> und <ENDE>
gelangen Sie an den Anfang bzw. an das Ende der Fileliste.
De-/Selektieren
Mit <EINFÜGEN> kann ein File selektiert werden, und durch
<Entfernen> deselektieren Sie das File wieder.
Das Auswahl-Fenster
Mit <TAB> 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 müssen (klar ?). Auch hier entfernt die Taste
<Entf> das File aus der Bestellung beim Server.
Mit der Taste <SPACE> 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, drücken
Sie <M> für "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 Drücken von <P> ein Passwort für das entsprechende File
einzutragen, welches dann beim Verschicken der Nachricht
entsprechende mitgeschickt wird. Bei passwortgeschützten Files,
bzw. bei solchen, bei denen Sie Passwörter angegeben haben,
erscheint ein Zeichen ("«") in der "SELECT"-Liste. Durch
erneutes Drücken von <P> und <Return> wird das Passwort wieder
gelöscht.
{+} Wenn Sie ein File normal mit "Einfügen" selektieren, öffnet
Sich ein Fenster mit den in der Passwort-Liste für diesen Node
eingetragenen Passwörter.
File-Find
Mit <F> (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 <C> (Continue) wird das Suchen forgesetzt, mit <ESC>
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 <C> fortführen.
Jump to line
Mit <J> können Sie eine bestimmte Zeile direkt anspringen.
Alias / Magic-Namen {+}
Mit <A> 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 <ALT><Z> 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 <Alt><G> im "Select"-Fenster die Nachricht abschicken oder
sie mit <ESC> verwerfen.
! ACHTUNG : selbstverstaendlich können Sie an JEDER Stelle des
Programms (ausser beim Compilieren am Anfang) das Programm mittels
<ESC> 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 gekürzt, 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 für 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 <F1>. 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" ungültige 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 genügend Speicher zum Laden des Packers vorhanden
- nicht genügend Speicher zum Erstellen des Index vorhanden
- overlay Datei (RU.ovr) nicht gefunden oder defekt
- nicht genügend Speicher für die Overlay-Datei vorhanden
- Keine Listen im angegebenen Verzeichnis
Ausserdem wird der Fehler in der Datei "RU.ERR" vermerkt.
Viel Spass im Fido-Net wünscht 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 für dieses Programm
überhaupt gibt. Für die Registrierung verwenden Sie bitte das
beigefügte Dokument "REGISTER.TXT". Der Betrag (min. DM15 oder
US-$10) ist zu überweisen an :
MIRKO K. MUCKO
Deutsche Bank Düsseldorf
Ktnr. 5457304 / 00
Blz. 300 700 10
oder per Scheck/bar zu schicken an
Mirko K. Mucko
Thomas-Mann-Str.43
4000 Düsseldorf 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 natürlich 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 für die Entwicklung gestohlen,
daher finde ich es angemessen, daß es auch finanziell ein
Ansporn für mich geben sollte , weiter zu programmieren und
nicht alles hin zu werfen.
Seite - 8-
Garantie :
Ich kann weder für das Programm selbst noch für 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 dafür 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