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 >
Text File  |  1992-02-06  |  15KB  |  378 lines
  1.           Dokumentation zu RequestUtil (RU.exe) Version 1.23
  2.           --------------------------------------------------
  3.  
  4.                     R E Q U E S T    U T I L I T Y
  5.  
  6.                      B E T A - V E R S I O N  1.25
  7.  
  8.                         RELEASED ON 06.02.1992
  9.  
  10.                   WRITTEN BY MIRKO K. MUCKO (2:242/94)
  11.  
  12. Vorab ein herzlicher Dank an alle Beta-Tester und sonstige Personen, die
  13. mir bei der Erstellung dieses Tools hilfreich (?) zur Seite standen,
  14. allen voran folgende Herren :
  15.  
  16. Hanstheo Wolf                                   Wim Abels
  17. Carsten Teske                                   Ingo Pahl
  18. Andreas Brodowski
  19.  
  20.                               DANKE !
  21. Seite - 1-
  22. ------------------------------------------------------------------
  23. Programmversion 1.26 vom 06.02.1992
  24.  
  25. [Zum Thema "neue Struktur" von FrontDoor]
  26.  
  27. "Die Botschaft hoert ich wohl, fuerwahr, mir fehlt der Glaube."  
  28.  
  29. ------------------------------------------------------------------
  30.  
  31. Einleitung
  32.  
  33. RU ist ein Utility, welches Ihnen bei dem sog. Requesten von Files
  34. bei Nodes viel Arbeit ersparen kann.
  35.  
  36. Das einzige, was Sie benötigen, ist ein Account als "Point" oder
  37. "Node" im FIDO-Netz und FrontDoor, Binkley oder  vergleichbare
  38. Programme und optional eine Fileliste aller verfügbaren Files des
  39. Servers, bei dem Sie Files bestellen  möchten.
  40.  
  41. Was tut es ?
  42.  
  43. Mit RU können Sie mittels der Cursor-Tasten Files,
  44. welche Sie requesten wollen, auswaehlen, abwaehlen und bestellen,
  45. kurzum alles, was Sie früher "per Hand und Bleistift" erledigt
  46. haben.
  47.  
  48. Aufruf
  49.  
  50. Aufgerufen wird das Programm mit einem bis drei Parametern oder
  51. ohne Parameter im "Multi-Modus".
  52. Letzters heißt, das nacheinande an verschiedene Boxen mit
  53. verschiedenen Filelisten Filerequests verschickt werden können.
  54. Diese Option ist vor allem für Sysops (wie 2:242/21) gedacht, die
  55. mit einem "Rund-um-Schlag" direkt bei allen Boxen, die er
  56. interessant findet, die jeweilige Filelist zu bestellen. Die
  57. Listennamen ergeben immer den entsprechenden Boxnamen, d.h. aus
  58. "02420094.lst" ist zu erkennen, daß es sich um die  Box 242/94
  59. handelt. Sollten sich bei der Umrechnung Probleme ergeben, fragt
  60. Sie RU zur Sicherheit nach der Adresse.
  61.  
  62. Normalerweise beginnt die Fileliste immer mit der Zonenkennung
  63. (also z.B. 25070013.lst für 2:507/13). Wenn diese Angabe vorhanden
  64. ist, wird sie benutzt , anderenfalls wird die Zone des Absenders,
  65. also Ihre eigene, als Ziel-Zone angnommen. Der "Multi-Modus" ist
  66. nur aktiv, wenn !_KEIN_! Parameter mit übergeben wurde ! Im
  67. "Normal-Modus" brauchen Sie nur den Namen der Fileliste zu
  68. selektieren, Net/Node und alles andere versucht das Programm
  69. selbst zu ermitteln.
  70.  
  71. Falls Sie mal nicht sicher sind, wie alt die Fileliste ist, koennen
  72. sie mit <SPACE> eine kleine Information erfragen.
  73.  
  74. Seite - 2-
  75. Im einzelnen sieht der Aufruf so aus :
  76. RU [/D<Ziel_Adresse>] [Liste] [ArchivName] [/x]/[/r]/[/n] [/u]
  77. [/l]/[/t]/[/Snn][/Pxxx]
  78.  
  79. /D<Ziel_Adresse>
  80.    gibt die Adresse des "remote systems" an, also des Systemes,bei
  81.    dem Sie Files bestellen wollen. Ob ein System Requests zu-
  82.    laesst, sollten Sie vorher abgeklaert haben (z.B. ist
  83.    "2:507/1"ein sog. Mail-Only-System, der Sysop laesst keine
  84.    Requests zu).
  85. Wenn jemend also z.B. bei mir etwas bestellen will, gibt
  86. er"2:242/94" ein. Es ist wichtig, die komplette Adresse
  87. anzugeben,also auch die (laestige) Zonen-Nummer. RU braucht
  88. dieAngabe u.A.für "Inter zone requests", also Requests zu Remote-
  89. Systems in an-deren Zonen.
  90.  
  91. Anbei : diese Requests werden als Crash-Mail geschickt, sie gehen
  92. ohne (!) Gate direkt an ihr Ziel.
  93. Sollte trotz aller Vorsicht die Zone vergessen worden sein, nimmt
  94. RU an, dass der Server sich in der Zone befinden, in der Ihr Point
  95. sich befinden.
  96.  
  97. Liste
  98.    gibt an, wo sich die Liste mit den Files einer Box
  99.    befindet.Gewöhnlich besteht ihr Name aus der Net- und
  100.    Nodenummer, in meinem Falle also "02420094" mit dem Suffix
  101.    ".lst", so daß meine Eingabe "02420094.lst" waere. Ist die
  102.    Listenangabe nicht vorhanden, wird aus der Net/Node-Adresse des
  103.    Users der Name des Listenfiles errechnert und versucht, die
  104.    Liste unter diesem Namen zu finden.
  105.  
  106. ArchiveName
  107.    Dieser Name steht für das Archiv, wenn die /X-Option gesetzt
  108.    wurde, aber das Archiv nicht aus dem Servernamen errechnet
  109.    werden kann oder soll.
  110.  
  111. /x
  112.    Wenn diese Option gesetzt ist, wird die Liste in einem
  113.    komprimierten Archiv vermutet. Entpacker und Directiven
  114.    ermittelt das Programm aus der Extention. Sollte RU Ihren
  115.    Packer nicht widererkennen, wird GUS (tm) geladen und mit ihm
  116.    das File entpackt. In jedem Fall MUSS ein Path auf das
  117.    Verzeichnis, in dem sich die Packer befinden, zeigen.
  118.  
  119. Nach dieser Angabe können Sie die Fileliste, die Sie laden
  120. möchten, mit den Cursortasten aussuchen. Es werden alle Files des
  121. unter "ListPath" in der Konfiguration angegebenen Directories
  122. angezeigt. Befinden sich im Archiv mehrere Files, müssen Sie
  123. wieder waehlen, welche Liste Sie benutzen möchten.
  124.  
  125. /n
  126.    steht für "No list". Es wird keine Liste geladen. Sie können
  127.    aber auf diese Art und Weise komfortabel Programme manuell
  128.    bestellen, z.B. die Fileliste einer Box.
  129.  
  130. ACHTUNG ! Es darf nur eine der obigen "/"-Anweisungen angegeben
  131. werden !
  132.  
  133. Seite - 3-
  134. /l
  135.    Steht für "link a file". Wenn Sie z.B. bei mehreren
  136.    (befreundeten) Sysops Files requesten wollen, freuen sich die
  137.    Sysops bestimmt, wenn sie mal einen "netten Brief" (oder was
  138.    auch immer) erhalten. Wenn Sie also /l angeben, wird ein
  139.    vorbereitetes File (siehe Kapitel "Setup") mitgeschickt. Falls
  140.    das File nicht gefunden wird, wird eine Standartnachricht
  141.    geschickt. Wenn Sie Files bestellen, werden Sie
  142.    sicherheitshalber noch einmal gefragt, ob Sie wirklich einen
  143.    Text mitschicken möchten.
  144.    "/l" kann immer mit angegeben werden, auch wenn eine der
  145.    anderen "/"-Optionen aktiviert wird.
  146.  
  147. /t
  148.    Bei "edit a Textfile" haben Sie die Möglichkeit, an jeden
  149.    Sysop, ähnlich wie bei "link a file", ein TextFile mit
  150.    abzuschicken, jedoch können Sie den Text für jeden Request
  151.    einzeln eingeben (mittels eines externen Editors).
  152.  
  153. /snn
  154.    Setzt die SearchSize (siehe Kapitel "Setup") temporär auf den
  155.    Wert nn.
  156.  
  157. Es kann nur eine der Optionen [/l], [/t] oder [/S] angegeben
  158. werden
  159.  
  160. /Pxxx
  161.    Falls das Archive mit einem Passwort versehen ist, kann es
  162.    mit/Pxxx entpackt werden, wobei "xxx" das Passwort darstellt.
  163.  
  164. Das Programm kann auch nur mit der Ziel_Adresse und "/x"
  165. aufgerufen werden oder im "Multi-Modus" ohne Parameter.
  166.  
  167. /U
  168.   In dieser Version unterstüzt RU erstmals den RequestManager
  169.   von Ulrich Bartelts "TrackM".
  170.   Die Mails werden entsprechend dessen Konventionen generiert.
  171.  
  172. Scrollen
  173.  
  174.    Mit den Cursor- bzw PAGE- Tasten können Sie nun den Balken auf
  175.    das von Ihnen gewünschte File setzen. Durch <POS1> und <ENDE>
  176.    gelangen Sie an den Anfang bzw. an das Ende der Fileliste.
  177.    
  178. De-/Selektieren
  179.  
  180.    Mit <EINFÜGEN> kann ein File selektiert werden, und durch
  181.    <Entfernen> deselektieren Sie das File wieder.
  182.  
  183. Das Auswahl-Fenster
  184.  
  185.    Mit <TAB> gelangen Sie in das "Selected"-Fenster. Hier können
  186.    Sie durch direktes Auswaehlen der schon gewaehlten Files diese
  187.    aus der Liste wieder streichen, ohne sie lange in der obigen
  188.    Liste suchen zu müssen (klar ?). Auch hier entfernt die Taste
  189.    <Entf> das File aus der Bestellung beim Server.
  190.    Mit der Taste <SPACE> erhalten Sie genauere Informationen ueber
  191.    das selektierte File.
  192.  
  193.  
  194. ACHTUNG : Sie können maximal 36 Files wählen - dies sollte reichen
  195. und es ist auch das Maximale, was ein Server "verkraftet", bevor
  196. er das "Time out" losschickt und damit die Verbindung unterbricht.
  197. Seite - 4-
  198. Manueller Eintrag
  199.    Um Files zu requesten, die nicht in der Liste stehen, drücken
  200.    Sie <M> für "manuell entry".
  201.  
  202. Passwort
  203.    Da einige Systembetreiber nicht öffentlich requestbare Files
  204.    bei sich lagern, die sie nur begrenzten Personengruppen
  205.    zugaenglich machen, gibt Ihnen RequestUtil die Möglichkeit,
  206.    durch Drücken von <P> ein Passwort für das entsprechende File
  207.    einzutragen, welches dann beim Verschicken der Nachricht
  208.    entsprechende mitgeschickt wird. Bei passwortgeschützten Files,
  209.    bzw. bei  solchen, bei denen Sie Passwörter angegeben haben,
  210.    erscheint ein Zeichen ("«") in der "SELECT"-Liste. Durch
  211.    erneutes Drücken von <P> und <Return> wird das Passwort wieder
  212.    gelöscht.
  213.    {+} Wenn Sie ein File normal mit "Einfügen" selektieren, öffnet
  214.    Sich ein Fenster mit den in der Passwort-Liste für diesen Node
  215.    eingetragenen Passwörter.
  216.    
  217. File-Find
  218.    Mit <F> (Find) können Sie ein File, dessen Namen Ihnen bekannt
  219.    ist, suchen lassen.Wildcards sind nicht nötig. Sollten sie
  220.    dennoch angegeben werden, wertet RU sie als reale Zeichen !!!
  221.    Mit <C> (Continue) wird das Suchen forgesetzt, mit <ESC>
  222.    abgebrochen.
  223.  
  224. Text-Find
  225.    Wie auch bei File-Find können Sie mittels Text-Find einen
  226.    String suchen lassen. Der gesuchte Text kann sich überall in
  227.    der Liste befinden, es werden also nicht nur, wie bei File-
  228.    Find, die ersten 13 Buchstaben einer Zeile gelesen. Auch hier
  229.    läßt sich die Suche mit <C> fortführen.
  230.    
  231. Jump to line
  232.    Mit <J> können Sie eine bestimmte Zeile direkt anspringen.
  233.  
  234. Alias / Magic-Namen {+}
  235.    Mit <A> können sie aus einer Liste von Magic-Namen einen
  236.    auswählen. Sollte zu dem System auch noch ein Passwort im
  237.    Passwort-File stehen, kann es dann ausgewählt werden !
  238.  
  239. DOS-Shell
  240.    Mit <ALT><Z> gelangen Sie in eine temporäre DOS-Umgebung, die
  241.    Sie mit "EXIT" wieder verlassen können.
  242.  
  243. Haben Sie alle Ihnen wichtig erscheinenden Files gewählt, können
  244. Sie mit <Alt><G> im "Select"-Fenster die Nachricht abschicken oder
  245. sie mit <ESC> verwerfen.
  246.  
  247. ! ACHTUNG : selbstverstaendlich können Sie an JEDER Stelle des
  248. Programms (ausser beim Compilieren am Anfang) das Programm mittels
  249. <ESC> verlassen. Ein Verschicken der Nachrichten an das Ziel-
  250. System wird dadurch unterbunden !
  251. Seite - 5-
  252. Verschicken
  253.    Nun erstellt RU die REQUEST-MAIL automatisch. Es werden alle
  254.    Nachrichtenheader durch-"gescannt", um zu erkennen, ob schon
  255.    eine Attachmail an dieses System vorliegt. Sollte dies der Fall
  256.    sein, wird die "neue" Nachricht "appended", also
  257.    "drangehängen", ansonsten wird eine neue Nachricht generiert.
  258.    
  259. Beim nächsten Aufruf Ihres Mailers wird sie als "direct Crash-
  260. Mail" verschickt und die "Bestellung" gelöscht oder gekürzt, je
  261. nachdem, was in der Konfiguration angegeben wurde.
  262.  
  263.  
  264. Dupe Checking {+}
  265.    Sollten Sie im Setup "Dupe check" angegeben haben, wird das
  266.    (hoffentlich vorhandene) File "INDEX.RU" nach den Files
  267.    gescannt, die Sie bestellen wollten. Dies kostet zwar einige
  268.    Sekunden Zeit, ist aber für Sysops, die keinen Überblick über
  269.    Ihre Festplatte haben unentbehrlich.
  270.  
  271. Sollten Sie (immer noch) eine unregistrierte Version von RU haben,
  272. sendet das Programm "freundlicher Weise" eine Tear-Line mit der
  273. Nachricht mit, so daß der Sysop des Zielsystems auch weiß, daß mit
  274. einer unregistrierten Version gearbeitet wurde/wird.
  275.  
  276. Angekommen ?
  277.    Die bestellten Files befinden sich dann in jenem Verzeichnis,
  278.    in das auch ihre sonstigen Programme und downgeloaedete Daten
  279.    "landen", meist ist dies das "INBOUND"-Verzeichnis.
  280.  
  281. Hilfe
  282.    Sollten Sie beim "Bestellen" mal nicht weiter wissen, ist eine
  283.    Mini-Hilfe eingebaut. Sie erreichen sie über <F1>. Die
  284.    Übersicht über die Tastenfunktionen erfahren Sie mit <?>
  285.  
  286. Fehler beim Bestellen :
  287.    - Sie können nicht mehr als 36 Files auswählen.
  288.    - Sie haben ein schon gewaehltes File noch einmal zu waehlen
  289.      versucht.
  290.    - Sie haben ein noch nicht selektiertes File aus der
  291.      Bestelliste zu streichen versucht.
  292.    - Sie versuchen, in der Liste weiter nach oben/unten zu gehen,
  293.      obwohl Sie bereits am Anfang / Ende der Liste sind.
  294.    - Sie haben beim "manuell entry" ungültige Daten eingegeben.
  295. Seite - 7-
  296. Fehler beim Aufrufen :
  297. Es wird immer eine (soweit möglich) genaue Fehlerbeschreibung und
  298. eine Musterbeispiel ausgegeben.
  299. Fehlerquellen :
  300.    - Falsche Origin-Net/Node-Adresse
  301.    - Falsche Destination-Net/Node-Adresse
  302.    - Fileliste ist nicht zu finden
  303.    - Packer nicht gefunden
  304.    - Archiv nicht gefunden
  305.    - nicht genügend Speicher zum Laden des Packers vorhanden
  306.    - nicht genügend Speicher zum Erstellen des Index vorhanden
  307.    - overlay Datei (RU.ovr) nicht gefunden oder defekt
  308.    - nicht genügend Speicher für die Overlay-Datei vorhanden
  309.    - Keine Listen im angegebenen Verzeichnis
  310. Ausserdem wird der Fehler in der Datei "RU.ERR" vermerkt.
  311.  
  312.  
  313. Viel Spass im Fido-Net wünscht Ihnen
  314.  
  315.     Mirko K. Mucko
  316.     2:242/94.0 (Plutonium RA BBS)
  317.  
  318.  
  319. Disclaimer
  320.    Das Programm darf nur mit diesem Text in unverfälschtem Zustand
  321.    weitergegeben werden. Es darf frei kopiert oder maschinell
  322.    verarbeitet, nicht aber in sog. PD-Serien aufgenommen werden.
  323.  
  324. Warum registrieren ?
  325.    Recht einfach zu beantworten ist diese Frage. Anfangs kamen
  326.    immer Netmails mit "boh, ey, dein schxxxx Programm hat mir die
  327.    Platte dich gemacht" oder ähnlichen zivilisierten Äusserungen.
  328.    Da nun auch diese ausblieben, hab ich eine Art Überblick,
  329.    wieviele interessierte Benutzer es für dieses Programm
  330.    überhaupt gibt. Für die Registrierung verwenden Sie bitte das
  331.    beigefügte Dokument "REGISTER.TXT". Der Betrag (min. DM15 oder
  332.    US-$10) ist zu überweisen an :
  333.  
  334.        MIRKO K. MUCKO
  335.        Deutsche Bank Düsseldorf
  336.        Ktnr. 5457304 / 00
  337.        Blz.  300 700 10
  338.        
  339. oder per Scheck/bar zu schicken an
  340.  
  341.        Mirko K. Mucko
  342.        Thomas-Mann-Str.43
  343.        4000 Düsseldorf 30
  344.        
  345. Der Key gilt fuer diese und alle folgenden Versionen von RU und RUSetup.
  346. Alle Optionen, die mit {+} versehen sind, funktionieren ausschliesslich
  347. in der registrierten Version.
  348.        
  349. Spenden :
  350.    Spenden werden natürlich gern entgegengenommen, auch wenn sie
  351.    noch so klein sind. (grössere Spenden werden später in einer
  352.    Spendenliste mit dem Programm veröffentlicht 8-}. Spaß
  353.    beiseite. Das Programm hat mir - neben einigen schlaflosen
  354.    Naechten - sehr viel Freizeit für die Entwicklung gestohlen,
  355.    daher finde ich es angemessen, daß es auch finanziell ein
  356.    Ansporn für mich geben sollte , weiter zu programmieren und
  357.    nicht alles hin zu werfen.
  358. Seite - 8-
  359. Garantie :
  360. Ich kann weder für das Programm selbst noch für Schäden an Hard-
  361. oder Software die Verantwortung übernehmen. Die Benutzung
  362. geschieht auf eigene Gefahr. Verbesserungsvorschlaege/bugreports
  363. sollten mir aber mitgeteilt werden.
  364. Trotz allem kann ich dafür garantieren, dass mein Tool mehr Platz
  365. auf Ihrer Platte wegnimmt, als Ihnen lieb sein wird...;-}
  366.  
  367. Copyrights
  368. Fido und FidoNet sind Eingetragene Warenzeichen von Tom Jennings.
  369. Es sind die jeweils geltenden Fido-Policies zu beachten !
  370. TrackM ist geistiges Eigentum von Ulrich Bartelt.
  371. FrontDoor ist gestiges Eigentum von Johaquim H. Homrigheusen
  372.                                 und Advanced Egeneering Software SARL
  373.  
  374. Viel Spass im FIDO-Netz !
  375.  
  376. mm+
  377. Mirko Mucko, 06.02.92
  378.