home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / bbs / offtag10 / tagger.dok < prev    next >
Encoding:
Text File  |  1993-07-25  |  32.2 KB  |  734 lines
  1. Der OffLine (Online-)Filetagger für Maximus-OS/2 2.01wb Version 1.0:
  2.  
  3. Nutzungs- und Haftungshinweise :
  4. ---------------------------------
  5. Autor  : Michael Mrosowski
  6.          Mühlenweg 1
  7.          2000 Wedel
  8.  
  9. 1. Haftung
  10. Die Benutzung dieses Programms geschieht auf eigene Gefahr. Der Autor
  11. übernimmt keine Verantwortung und keine Haftung für eventuell durch Anwendung
  12. dieses Programmes entstehende Schäden und garantiert auch nicht die einwand-
  13. freie Funktion dieses Programmes.
  14.  
  15. 2. Nutzungsrecht
  16. Dieses Programm ist Public-Domain, das heißt JEDER darf dieses Programm
  17. (Bezeichnung Offline Filetagger v1.0) benutzen solange er will und kopieren
  18. so oft er will, solange er alle darin enthaltenen Dateien vollständig
  19. weitergibt. Alle Nutzungsrechte gelten vorerst nur für diese Programmversion
  20. (v1.0).
  21.  
  22. ABER!
  23.  
  24. Ein Verkauf dieses Programmes ohne ausdrückliche Einwilligung des Autors
  25. ist verboten. D.h. Niemand darf Geld für dieses Programm nehmen. Weiterhin 
  26. dürfen das Programm TAGGER.EXE und die beigefügte Datei TAGGER.DOC nicht in
  27. veränderter Form weitergegeben werden. TAGGER.DOC darf allerdings sinngemäß
  28. übersetzt und dem Paket beigefügt werden.
  29.  
  30.  
  31. ------------------------------------------------------------------------------
  32.                                     INHALT
  33. ------------------------------------------------------------------------------
  34.  
  35. 1.Hallo Allerseits.
  36. 2.Nur kurz mal ansehen
  37. 3.Was macht der eigentlich ?
  38. 4.Welche Konfiguration ist erforderlich ?
  39. 5.Was ist neu ?
  40. 6.Die Installation im Schnellverfahren
  41. 7.Der Tagger im Detail
  42.   7.1 Kommandozeilenparameter
  43.   7.2 TAGGER.CFG
  44.   7.3 Durchführung des Downloads
  45. 8.Bedienung
  46. 9.Weitere Nutzungshinweise
  47. 10.Hall of Fame
  48. ==============================================================================
  49. 1.Hallo Allerseits.
  50. -------------------
  51. Dies ist die Kurzdokumentation zum Offline Filetagger. Sie soll helfen den
  52. Tagger zu installieren und zu benutzen. Der Tagger ist frei Kopier- und Nutz-
  53. bar und kostet nix. Daher habe ich für die Doku auch nicht soviel Zeit aufgewen-
  54. det. Wenn Ihr Probleme bei der Installation habt, dann schickt mir eine NetMail
  55. (Adresse siehe Ende des Textes) ich werde dann baldmöglichst antworten, wenn
  56. ich helfen kann.
  57. ==============================================================================
  58. 2.Nur kurz mal ansehen :
  59. ------------------------
  60. 1. Die Dateien in einem Verzeichnis auf deinem Box-Rechner entpacken.
  61. 2. In einer OS/2 Session in das Verzeichnis ggf. wechseln und
  62.    TAGGER.EXE starten.
  63. 3. Wenn der Tagger (hoffentlich) startet "H" für Hilfe drücken oder einfach
  64.    wild herumprobieren.
  65. 4. Der Download kann im Testbetrieb natuerlich noch nicht gestartet werden.
  66. 5. Begeistert sein. (nicht ?, naja, dann eben nicht)
  67.  
  68. ==============================================================================
  69. 3.Was macht der eigentlich ? :
  70. ------------------------------
  71. Mit dem Filetagger können komfortabel Dateien aus den Fileareas ausgewählt
  72. werden. Die Auswahl erfolgt in ähnlicher Form, wie sie auch aus einigen File-
  73. Managern bekannt ist z.b. FILER oder NC. Wählt der Benutzer "Download" an, dann
  74. führt das Programm ein CMD-file aus, das beliebig angepasst werden kann.
  75. So kann z.b. ein Mecca-file erstellt werden, um die Dateien dann mit Maximus
  76. downzuloaden, oder es kann ein externes Dateiprotokoll aufgerufen werden.
  77. Zu diesem Zweck werden dem CMD-file entsprechende Parameter übergeben.
  78. Die Auswahl erfolgt übrigens Online, der Zusatz OffLine bezeichnet nur den
  79. Namen der Mailbox in der das Programm gebastelt wurde. Ein CMD-file für die
  80. Erstellung eines Mecca-Files ist bereits beigefügt.
  81.  
  82.  
  83. ==============================================================================
  84. 4.Welche Konfiguration ist erforderlich ? :
  85. -------------------------------------------
  86. Der Filetagger ist eine 32Bit OS/2 Anwendung, die unter EMX-Gnu-C compiliert
  87. wurde. Das Programm ist für den Gebrauch mit Maximus v2.01wb entwickelt worden.
  88. Es wurde auf HPFS- und FAT-Partitions getestet, verträgt aber nur Dos-
  89. Dateinamen. Die Benutzer des Filetaggers müssen über eine Ansi-Emulation
  90. verfügen.
  91.  
  92. ==============================================================================
  93. 5.Was ist neu ? :
  94. -----------------
  95. 1. Der Tagger kann ein Logfile führen über seine Aktivitaeten und evtl.
  96.    auftretende Fehler.
  97. 2. Die verbleibende Online-Zeit des Users wird jetzt endlich auch berück-
  98.    sichtigt.
  99. 3. Das lapidare "Du darfst nicht mehr Dateien taggen"-Piep wurde um ent-
  100.    sprechende Textmeldungen ergänzt.
  101. 4. Ein Sysop-Chat für die Plapperfreudigkeit des Sysops mit seinen Usern.
  102.    (hat ja irgendwie noch gefehlt (: )
  103. 5. Der Tagger kann mittels language-dateien an verschiedene Sprachen an-
  104.    gepasst werden.
  105. 6. Die Farben koennen jetzt in tagger.cfg angepasst werden.   
  106. 7. Diverse neue Parameter : CFG=,REMTIME=,INCBARRICADES,PRIV=,KEYS=,
  107.    NOFILESDAT 
  108. 8. Mit dem Parameter MULTILINEDESC koennen jetzt auch mehrzeilige 
  109.    Beschreibungen vollstaendig uebernommen werden.
  110. 8. Bug: Bisher konnten keine Dateien getagged werden, die das nette Zeichen
  111.    "&" enthielten, das wurde durch Einführung von Anführungszeichen unter-
  112.    bunden.
  113. 9. Bug: Ab der 2. Seite der Hilfe wurde wohl manchmal alles in s/w angezeigt.
  114.    Ich hoffe ich habe das auch beseitigt.
  115. 10.Bug: Wenn in einer Area in der filearea.ctl das DownLoad oder das 
  116.    FileAccess Statement fehlte, dann lief der Tagger nicht.
  117. 11.Bug: Die Newfilesfkt lief nicht immer 100pro.   
  118.  
  119. Neuerungen der Version 1.0ß :
  120. -----------------------------
  121. 1. Die Dateiauswahl erstreckt sich nun über mehrere Areas
  122. 2. Benötigte Daten werden soweit möglich aus Maximus-Dateien entnommen das
  123.    hat die Anzahl der erforderlichen Parameter erheblich eingeschränkt.
  124. 3. Der Tagger kann sich in der Darstellung an die bpsrate anpassen.
  125. 4. Timeout und Carrier-Detect Funktion
  126. 5. u.v.m. :-)
  127.  
  128. Neuerungen der Version 0.9 :
  129. ----------------------------
  130. 1. Dateibeschreibungen, können jetzt mit oder ohne Zeilenumbruch angezeigt
  131.    werden. (Taste 'W' und Parameter WRAP)
  132. 2. Die NodeNr kann jetzt als Parameter (NODE=) angegeben werden und wird
  133.    an die Download.cmd weitergegeben. Diese NodeNr wird jetzt von den mit-
  134.    gelieferten Scriptfiles auch an DL.BBS rangehängt.
  135. 3. Es ist jetzt möglich in der Datei tagger.cfg ein Download-Menu mit ver-
  136.    schiedenen Protokollen sowie verschiedenen Download.cmd's zu definieren.
  137. 4. Lokal sind jetzt (endlich) auch die Cursortasten benutzbar.
  138. 5. Probehalber ist der Parameter NOMISSING für CD-Wechsler und Streamer
  139.    eingeführt worden.
  140. 6. Die Tagger.Hlp wurde etwas übersichtlicher gestaltet.
  141.  
  142. Neuerungen der Version 0.9ß:
  143. ----------------------------
  144. 1. Kommentarzeilen, die mit "-" oder " " beginnen werden ignoriert.
  145.    (der Parameter SKIP aus 0.8 ist dadurch unnötig geworden)
  146. 2. /t /b und /tb nach dem Dateinamen werden übergangen.
  147. 3. Beschreibungen dürfen bis zu 255 Zeichen lang sein.
  148. 4. Pfadnamen vor den Dateinamen sind jetzt auch erlaubt und werden erkannt 
  149.    (siehe FULLPATH bei den Parametern).
  150. 5. Dateien auf Read-Only Volumes (CDROM) sollten jetzt eigentlich nicht mehr 
  151.    als "Missing" gemeldet werden.
  152. 6. Die Downloadcounter dürfen jetzt auch in anderen Zeichen als [] stehen
  153.    (siehe DLCDEL bei den Parametern).
  154. 7. Die FILES.BBS muss nicht mehr im Verzeichnis der Filarea stehen.
  155.    (siehe FILESBBS bei den Parametern)
  156. 8. In den Cmd-Files wird an das generierte DL.BBS das Comhandle angehängt.
  157.    Also z.b. DL5.BBS oder DL0.BBS das sollte den Tagger auf Multiline-
  158.    Systemen besser laufen lassen. (Änderung in Menus.ctl nicht vergessen)
  159.  
  160. Neuerungen der Version 0.8:
  161. ----------------------------
  162. 1. Die Datei Download.cmd erstellt jetzt ein BBS-File, dass direkt nach
  163.    der Rückkehr aus dem Tagger von Maximus ausgeführt werden kann.
  164.    Damit findet ab jetzt der Download wieder innerhalb Maximus statt und
  165.    alle Statistiken werden gepflegt und alle Rechte beachtet. Ein externes
  166.    Protokoll ist somit auch NICHT mehr nötig. Dies geht ab der Maximus Version
  167.    2.01, da erst hier das [download] token hinzugekommen ist.
  168.    
  169. 2. Die Version 0.7 übersprang die ersten 8 Zeilen der FILES.BBS, da hier
  170.    ein Header von dem Utility Downsort angenommen wurde. In der Version
  171.    0.8 laesst sich dies mit dem Parameter SKIP= individuell einstellen.
  172.    
  173. 3. Wird der Tagger nach dem Ausführen von download.cmd beendet (parameter
  174.    QUIT) dann gibt er den errorlevel 1 zurück. Bei einer normalen Beendi-
  175.    gung des Taggers ohne Download wird der errorlevel 0 zurückgegeben.
  176.  
  177.  
  178. ==============================================================================
  179. 6.Die Installation im Schnellverfahren :
  180. ----------------------------------------
  181. Erstmal natuerlich ein Verzeichnis eröffnen und alle Dateien dieses Archivs
  182. in das Verzeichnis kopieren. Als da wären :
  183.  
  184.   T.CMD         CMD-File zum Start des Taggers (wird von TAGGER.MEC ausgeführt)
  185.   DOWNMULT.CMD    - " -  für Download mit Downloadmenu
  186.   TAGGER.CFG    enthält die Konfiguration des Taggers
  187.   TAGGER.EXE    das Programm an sich
  188.   TAGGER.HLP    englisches Helpfile als Textdatei
  189.   TAGGER.HLF    deutsches Helpfile
  190.   ENGLISH.LNG   englisches Languagefile
  191.   DEUTSCH.LNG   deutsches Languagefile
  192.   TAGGER.DOK    deutsche Doku (das hier)
  193.   TAGGER.DOC    englische Doku
  194.   EMX.DLL       wird von TAGGER.EXE benötigt
  195.   STDCOLOR.SET  die alten Farben vom Tagger
  196.   SAMPLES.ZIP   alternative Anwendungen des Taggers
  197.   
  198. ------ folgende Dateien dienen nur für einen Testlauf des Taggers -----------
  199. ------ und können nach dem Test gelöscht werden                   -----------
  200.  
  201.   106.BBS       Files-bbs und Files.dat Dateien für den Testlauf
  202.   106.DAT
  203.   504.BBS
  204.   504.DAT
  205.   FILEAREA.CTL  Area definition für den Testlauf
  206.  
  207.   6.1 Einbindung in die Menus.ctl :
  208.   ---------------------------------
  209.   Dann muss der Tagger in der Menus.Ctl in ein passendes Menu eingebunden
  210.   werden.
  211.   -------
  212.          Display_File     c:\tagger\tagger            Limited   "3 Offline Tagger"
  213.   -------                 ^hier das Verzeichnis vom tagger + (tagger.mec)
  214.   Natürlich müssen sämtliche Pfade auf die Verzeichnisse von Maximus und dem
  215.   Tagger entsprechend angepasst werden.
  216.  
  217.   6.2 Aufruf von Tagger.exe :
  218.   ---------------------------
  219.   In folgenden Dateien müssen auch die Pfade angepasst werden :
  220.        (Stellen sind markiert mit "^" und einem passenden Kommentar)
  221.   TAGGER.MEC:
  222.     [colour goto start endcolour]
  223.     Sorry, der Fullscreen-Tagger laeuft nicht mit TTY.
  224.     Stell im Usermenu ANSI an, wenn dein Terminalprogramm das unterstützt.
  225.     [Enter]
  226.     [Exit]
  227.     [/start moreoff xtern_run]cmd.exe /c c:\tagger\t.cmd %P %K
  228.                                           ^hier das taggerverzeichnis
  229.     [link]c:\tagger\dl+K
  230.             ^und nochmal hier
  231.  
  232.   T.CMD:
  233.     cd c:\tagger
  234.         ^ hier ins tagger-verzeichnis
  235.     if exist dl%2.bbs del dl%2.bbs
  236.     tagger P=%1 NODE=%2
  237.     cd c:\box\max
  238.         ^ und hier zurück in das maximus-verzeichnis
  239.  
  240.   TAGGER.CFG:
  241.     .        (die semikolons vor "lastuser" und "maxprm" entfernen)
  242.     .
  243.     Filepaths
  244.       logfile   tagger.log
  245.       arealist  filearea.ctl
  246.                 ^ und den Pfad zur filearea.ctl
  247.       lastuser  lastus%%.bbs
  248.                 ^ hier den kompletten Pfad zur lastuser-Datei
  249.                   z.b. c:\box\max\lastus%%.bbs
  250.       maxprm    max.prm
  251.                 ^ und den Pfad zu max.prm hier eintragen
  252.                   z.b. c:\box\max\max.prm
  253.     ;  filebase  filebase
  254.                 ^ die filebase kann erstmal draussen bleiben
  255.     End Filepaths
  256.     .
  257.     .
  258.     .
  259.  
  260. So das muesste es eigentlich für's erste sein. Wie gesagt, die Pfade muessen
  261. stimmen und die Einbindung des Display_File in ein menu muss passen.
  262. Natuerlich bleiben noch einige Fragen offen. Diese werden hoffentlich
  263. in dem nächsten Kapitel geklärt.
  264.  
  265. ==============================================================================
  266. 7.Der Tagger im Detail :
  267. ------------------------
  268. Hier werden die Konfigurationsmöglichkeiten des Taggers näher erläutert.
  269.  
  270.   7.1 Kommandozeilenparameter :
  271.   -----------------------------
  272.   Die Kommandozeilenparameter werden entweder direkt beim Aufruf (in T.CMD)
  273.   an TAGGER.EXE übergeben, oder sie können in der Parameter-Section von
  274.   TAGGER.CFG aufgeführt werden (siehe 7.2).
  275.  
  276.   RESCAN Aktualisiert die Filebase und verlaesst den Tagger sofort wieder.
  277.          Mehr über die Filebase findet sich in 7.2 (Filepath section).
  278.   P=     Comhandle von Maximus bzw. Binkley. Wird P= nicht angegeben, so läuft
  279.          der Tagger nur im Localmode (P=0).
  280.   NODE=  Gibt die NodeNr dieses Ports an. Dient dazu, die richtige
  281.          lastuser%%.bbs Datei zu laden und die richtigen Download-Mecca Dateien
  282.          zu erstellen.
  283.   CFG=   Mit diesem Parameter kann eine andere cfg-Datei als tagger.cfg ange-
  284.          geben werden. Z.B.: CFG=c:\tagger\nerd.cfg
  285.   ECHO   Echot die Ausgabe des Taggers auf den Bildschirm des Sysop
  286.          (ohne diesen Parameter könnt ihr den Sysop-Chat vergessen)
  287.  
  288.   QUIT   Verlässt den Tagger sofort nach der Ausführung von DOWNLOAD.CMD
  289.         (notwendig wenn in DOWNLOAD.CMD kein externes protokoll aufgerufen 
  290.          wird). Und ist auch nur entscheidend, wenn in tagger.cfg bei den
  291.          Protokollen kein Quit oder NoQuit angegeben wurde.
  292.   DLCDEL=""
  293.          Hiermit kann das Zeichen angegeben werden mit dem ein Downloadcounter
  294.          beginnt. (z.B. DLCDEL="<" für <000> oder DLCDEL="{" für {000})
  295.          (Default hier : "[")
  296.   MULTILINEDESC
  297.          Wenn dieser Parameter angegeben wird, dann werden Comment-Zeilen,
  298.          die auf eine Datei in der FILES.BBS folgen, an die Beschreibung 
  299.          angehaengt.
  300.   DESCID=""
  301.          Das hier angegebene Zeichen muss als erstes in der Zeile stehen,
  302.          damit die Beschreibung bei Benutzung von MULTILINEDESC auch zu
  303.          der Dateibeschreibung hinzugefuegt wird. (Default: DESCID=" ")
  304.   NOMISSING
  305.          Mit diesem Parameter werden Dateien, die in der FILES.BBS stehen und 
  306.          die vom Tagger nicht gefunden werden, trotzdem nicht als "MISSING" 
  307.          angegeben. Dadurch bleiben sie auswählbar. Die Größe wird allerdings
  308.          pauschal auf 1k gesetzt (unbekannterweise). Dieser Parameter wurde
  309.          probehalber für den Betrieb mit Streamertapes eingeführt.
  310.   NOFILESDAT
  311.          Der Tagger liest dann das Datum und die Groesse einer Datei nicht
  312.          aus der "FILES.DAT" Datei sondern holt sich diese Daten aus dem
  313.          Dateisystem. Dies ist allerdings langsamer.
  314.   NOPRIVCHECK
  315.          Bei der Anzeige der Areas wird der Priv-Level des aktuellen Users
  316.          (Aus Lastuser.bbs) nicht mehr beachtet, sondern alle Areas werden
  317.          angezeigt.
  318.   NOKEYCHECK
  319.          Die eventuelle User-Key Begrenzungen der Areas werden hiermit
  320.          ignoriert. Zusammen mit NOPRIVCHECK wird also das Fileaccess
  321.          Statement in der Filearea.ctl voellig ignoriert.
  322.   INCBARRICADES
  323.          Normalerweise werden Areas mit dem Statement "FileBarricade" einfach
  324.          weggelassen, dieser Parameter nimmt sie rein (aber ohne Abfrage).
  325.   CARRIERCHECKOFF
  326.          Schaltet den Carrier-Check aus. Sonst wird beim Verlieren des
  327.          Carriers der Tagger verlassen.
  328.   WRAP
  329.          Startet den Tagger mit umgebrochenen Beschreibungen.
  330.   C=     C=0 für Schwarzweiß- und C=1 für Farbanzeige (Default:C=1)
  331.  
  332.   Folgende Angaben werden vom Tagger normalerweise aus der lastuser.bbs
  333.   Datei von Maximus gelesen. Die Parameter überschreiben diese Werte, wenn
  334.   nötig (Die Default-Werte werden benutzt, wenn in der Tagger.cfg kein
  335.   Pfad für die lastuser.bbs angegeben wurde und auch kein entsprechender
  336.   Parameter übergeben wurde).
  337.  
  338.   X=     Bestimmt die angezeigte Bildschirmbreite (>=80, Default:80)
  339.   Y=     Bestimmt die angezeigten Bildschirmzeilen (>=12,Default:25)
  340.   B=     Bps-Rate des Benutzers                    (Default:14400)
  341.   T=     Heute schon vom Benutzer downgeloadete kb (Default:0)
  342.   REMTIME=
  343.          Dem Benutzer noch verbleibende Online-Zeit. (in minuten)
  344.   PRIV=  Der Priv-Level des Benutzers kann hier direkt im Klartext angegeben
  345.          werden (z.B. PRIV=TWIT od. PRIV=DISGRACE etc.).
  346.   KEYS=  Hiermit koenne die User-Keys direkt angegeben werden.
  347.          (z.B. KEYS=12345678ABCD)
  348.  
  349.   Dieser Wert wird normalerweise vom Tager aus Max.prm gelesen.
  350.   L=     Downloadlimit des Benutzers in kb         (Default:2000)
  351.  
  352.   7.2 TAGGER.CFG :
  353.   ----------------
  354.   Die Konfigurationsdatei TAGGER.CFG sollte im gleichen Verzeichnis wie 
  355.   TAGGER.EXE stehen (ihr Name und Pfad kann aber auch mit dem CFG= Parameter
  356.   uebergeben werden). Sie ist in diverse Sections eingeteilt, deren Reihen-
  357.   folge beibehalten werden sollte. Jede Section wird durch das Wörtchen "End"
  358.   beendet. 
  359.  
  360.   Die Parameters-Section :
  361.   ------------------------
  362.   In der Parameters-Section können Kommandozeilen-Parameter eingetragen werden.
  363.   Diese werden dann genauso behandelt, als ob sie direkt an das Programm
  364.   übergeben worden wären, mit der Ausnahme, dass wirklich direkt übergebene
  365.   Parameter vorrangig behandelt werden. Es darf nur jeweils ein Parameter pro
  366.   Zeile angegeben werden.
  367.   Beispiel:
  368.  
  369.   Parameters
  370.     Echo
  371.     Wrap
  372.     Dlcdel="<"
  373.     Quit
  374.   End Parameters
  375.  
  376.   Die Filepath-Section :
  377.   ----------------------
  378.   Hier werden Dateipfade zu den vom Tagger ladbaren oder benötigten Dateien
  379.   angegeben. Die Dateipfade müssen jeweils hinter den Bezeichnern stehen.
  380.  
  381.     LogFile:
  382.     --------
  383.     In der hier angegebenen Datei wird protokolliert, wann und von wem der
  384.     Tagger benutzt wurde, ob und was downgeloaded wurde und ob Fehler auf-
  385.     getreten sind.
  386.  
  387.     Arealist:
  388.     ---------
  389.     Die Arealist dient dem Tagger als Verzeichnis aller Fileareas und liefert
  390.     auch die Zugriffsberechtigungen. Hier muss der Pfad angegeben werden.
  391.  
  392.     Lastuser:
  393.     ---------
  394.     Aus der Lastuserdatei holt sich der Tagger die Userabhängigen Daten, wie:
  395.     Priv-level Bps-Rate LastLogin keys Bildschirmgröße Dl-Heute.
  396.     Für MultiPort-Systeme kann mit "%%" die Stelle in dem Dateinamen angegeben
  397.     werden, an der die mit "NODE=nn" übergebene NodeNr eingefüllt werden soll.
  398.  
  399.     Maxprm:
  400.     -------
  401.     Aus der Maximusdatei max.prm wird derzeit das Downloadlimit abhängig von
  402.     dem priv-level des Users geladen.
  403.  
  404.     Filebase:
  405.     ---------
  406.     Wird ein hier ein Pfad angegeben, so legt der Tagger beim erstmaligen Start
  407.     in dieser Datei seine Daten über die Fileareas und deren Inhalt in einem
  408.     internen Format ab. Besonders bei vielen Fileareas kann der Tagger danach
  409.     mit Hilfe dieser Datei(en) wesentlich schneller starten. Allerdings muss
  410.     dem Tagger von Aussen bedeutet werden, wann diese Datei aktualisiert werden
  411.     soll. Praktischerweise sollte dies erfolgen, NACHDEM auch der FBP von
  412.     Maximus z.b. aufgrund eines Uploads aufgerufen wurde. Das Update der
  413.     Filebase wird durch den Aufruf von TAGGER.EXE mit dem Parameter RESCAN
  414.     durchgeführt. Der Tagger aktualisiert dann seine Filebase und beendet sich
  415.     sofort wieder. Der Pfad für die Filebase darf (FAT) oder sollte (HPFS)
  416.     keine Dateierweiterung enthalten, da der Tagger die Dateierweiterungen
  417.     .DAT bzw. .DMP an die Datei anhaengt.
  418.  
  419.     Downloadlist:
  420.     -------------
  421.     Nachdem im Tagger "Download" angewaehlt wurde, wird eine Liste der mar-
  422.     kierten Dateien mit Dateiname,Groesse,Datum und Beschreibung erstellt.
  423.     Ihr Name wird dann an die in der Protocols Section angegebene Cmd-Datei
  424.     uebergeben. Wenn "Downloadlist" nicht angegeben wird, dann werden die
  425.     Dateinamen (inklusive Pfad) direkt in der Kommandozeile an die Cmd-Datei
  426.     uebergeben. Das "%%" kennzeichnet, wie bei dem "LastUser" Parameter die
  427.     Position an der die NodeNr eingefuegt werden soll.
  428.     
  429.     Languagefile:
  430.     -------------
  431.     An dieser Stelle kann der Name einer "Sprachen-"Datei angeben. In dieser
  432.     Datei koennen saemtliche Texte und Menus des Programmes definiert werden.
  433.     Die Dateien english.lng und deutsch.lng sind als bereits fertige Sprach-
  434.     Dateien beigelegt.
  435.     
  436.     In der Language-Datei stehen pro Zeile ein Bezeichner, der den Text einer
  437.     bestimmten Funktion im Programm zuordnet, und eine Zeichenkette in 
  438.     Anfuehrungsstrichen. Diese Zeichenkette orientiert sich direkt am C-Syntax
  439.     fuer Zeichenketten.
  440.     Bevor Du allerdings die Sprach-Dateien aenderst, solltest Du Dir bewusst 
  441.     sein, dass diese Aenderungen unter Umstaenden zu einem Programmabbruch
  442.     fueheren koennen. Speziell dann, wenn die Zeichenkette zu lang wird oder
  443.     wenn eine Ausgabeformatierung falsch angegeben wird. Daher solltest Du
  444.     selbsterstellte Sprach-Dateien sorgfaeltig testen bevor Du sie freigibst.
  445.     
  446.     In einigen der Zeichenketten markiert das Zeichen "~" eine Hervorhebung
  447.     des folgenden Zeichens. Das funktioniert aber nur in diesen Zeichenketten.
  448.     
  449.     Einige der Bezeichner hoeren mit dem Wort "menu" auf. Die zugehoerigen
  450.     Zeichenketten enthalten die Buchstaben, die eingegeben werden muessen
  451.     um eine Funktion auszufuehren. Jede Position in der Zeichenkette steht 
  452.     logischerweise fuer eine Funktion.
  453.     Beispiel:
  454.       Englisch:
  455.        askquitmsg         " Quit (~Yes/~No) ? "
  456.        quitmenu           "YN"
  457.       Franzoesisch:
  458.        askquitmsg         " Sortir (~Oui/~Non) ?"
  459.        quitmenu           "ON"
  460.       Deutsch:
  461.        askquitmsg         " Ende (~Ja/~Nein) ? "
  462.        quitmenu           "JN"
  463.    
  464.     Helpfile:
  465.     ---------
  466.     Hier kann ein Name fuer die Hilfe-Datei angegeben werden. Diese ASCII-
  467.     Datei wird angezeigt, wenn der Benutzer "H"  drueckt (oder was in der
  468.     Sprach-Datei definiert wurde). Wenn dieser Parameter nicht angegeben
  469.     wurde, dann wird die datei "tagger.hlp" angezeigt.
  470.  
  471.   Beispiel fuer eine Filepath Section:
  472.  
  473.   Filepaths
  474.     logfile       c:\tagger\tagger.log
  475.     arealist      c:\box\max\filearea.ctl
  476.     lastuser      c:\box\max\lastus%%.bbs
  477.     maxprm        c:\box\max\max.prm
  478.     filebase      c:\tagger\filebase
  479.     downloadlist  c:\tagger\dlfile%%.lst
  480.     languagefile  deutsch.lng
  481.     helpfile      tagger.hlf
  482.   End Filepaths
  483.   
  484.   Die Colors-Section:
  485.   -------------------
  486.   In dieser Section kannst Du den Tagger in Deinen Lieblingsfarben gestalten.
  487.   Hinter jedem Kennzeichner musst du einfach den Avatar Farbcode in dezimaler
  488.   Schreibweise angeben. Eine passende Farbtabelle findest Du z.B. in den 
  489.   Maximus Dokus.
  490.   
  491.   Die unteren 4 Bits (0-3) geben dabei die Fordergrundfarbe an und die Bits
  492.   4-6 geben die Hintergrundfarbe an. Bit 7, das Blink-Bit wird nicht unter-
  493.   stuetzt.
  494.  
  495.   Die Miscellaneous-Section :
  496.   ---------------------------
  497.   In der Miscellaneous Section stehen alle Sachen die in keine andere Section
  498.   so richtig reinpassen wollten. 8-)
  499.  
  500.     DateFormat :
  501.     ------------
  502.     Das Datumsformat kommt bei der Eingabe des NewFile-Datums bzw. bei der An-
  503.     zeige des Dateidatums zum tragen. DD steht dabei für den Tag, MM für den
  504.     Monat und YY für das Jahr. Diese Platzhalter sollten praktischerweise durch
  505.     (maximal) ein Trennzeichen separiert werden. Vierstellige Jahreszahlen,
  506.     sowie Monate im Klartext sind nicht möglich.
  507.  
  508.     Richtig: YY-MM-DD    DD.MM.YY   MM/DD/YY
  509.  
  510.     Falsch!: DD.MM.YYYY   DD---MM---YY  DMMDYY   DMY undsoweiterundsofort
  511.  
  512.     Timeout :
  513.     ---------
  514.     Timeout setzt die Zeit in Sekunden fest nach der das Timeout-Aufweck Fenster
  515.     erscheint. Dieses Fenster führt dann über 60 Sekunden einen Countdown aus
  516.     und wenn der User dann immer noch keine Taste gedrückt hat, dann wird der
  517.     Tagger sang und klanglos beendet. Diese Funktion wurde eingeführt um einer-
  518.     seits die Box von eingeschlafenen Usern zu befreien und andererseits zu
  519.     greifen, falls der Carrier-Detect mal nicht funktionieren sollte. Ist diese
  520.     Funtion unerwünscht, dann sollte hier die Zeit einfach auf ein paar 1000
  521.     Sekunden gesetzt werden. (Default ist jedenfalls 120 Sekunden)
  522.  
  523.     MaxTagged :
  524.     -----------
  525.     Hier wird die Anzahl der Dateien angegeben die Maxmimal in einer Sitzung
  526.     mit dem Tagger angewählt werden kann. Maximus kann maximal 30 Stück in einem
  527.     Rutsch verarbeiten. D.h. wer mehr will muss sich die Download.cmd Datei
  528.     vornehmen und sie dahingehend verändern, daß das [menu_cmd download] alle
  529.     30 Dateien neu in das meccafile gepackt wird. Default sind hier 30 Dateien.
  530.  
  531.   Beispiel :
  532.  
  533.   Miscellaneous
  534.     Dateformat DD.MM.YY
  535.     Timeout    240
  536.     MaxTagger  30
  537.   End Miscellaneous
  538.  
  539.   Die Speedadapt-Section :
  540.   ------------------------
  541.   Hier kann der Tagger für verschiedene Bps-Raten auf verschiedene Wiedergabe-
  542.   qualitäten eingestellt werden um so die Benutzung auch noch für 2400er er-
  543.   träglich zu machen. Die Zeilen sind dabei in mit aufsteigenden Bps-Raten
  544.   anzugeben. Als erstes wird in einer Zeile die Bps-Rate angegeben,
  545.   für die (und langsamer) die Zeile gilt, und dahinter werden dann die ent-
  546.   sprechenden Einschränkungen aufgelistet. Als da wären:
  547.  
  548.     NoScroll :
  549.     ----------
  550.     Der Tagger scrollt nicht mehr. Statt dessen wird eine gesamte Seite vor
  551.     bzw. zurück wenn die erste oder letzte Zeile auf dem Schirm überschritten
  552.     wurde.
  553.  
  554.     ShortBar :
  555.     ----------
  556.     Nicht mehr die ganze Zeile in der sich der Pointer befindet wird farbig
  557.     hinterlegt, sondern es werden nur noch die farbigen ">" und "<" angezeigt.
  558.  
  559.     NoSelectColor :
  560.     ---------------
  561.     Markierte Zeilen werden nicht mehr farbig hinterlegt und sind folglich
  562.     nur noch an den [] zu erkennen.
  563.  
  564.     NoColor :
  565.     ---------
  566.     Überhaupt keine Farbe mehr (Schade auch). Shortbar und NoSelectColor
  567.     sind dann natürlich hinfällig.
  568.  
  569.   Beispiel:
  570.  
  571.   Speedadapt
  572.     1200  NoScroll Nocolor
  573.     2400  NoScroll ShortBar NoSelectColor
  574.     4800  NoScroll ShortBar
  575.     12000 NoScroll
  576.   End Speedadapt
  577.  
  578.   Die Protocols-Section :
  579.   -----------------------
  580.   In der Protocols-Section kann ein Downloadmenu mit verschiedenen Protokollen
  581.   definiert werden. Wird kein Protokoll definiert, dann wird einfach
  582.   DOWNLOAD.CMD aufgerufen (die Parameter siehe Unten). Das Menu erscheint
  583.   dann, wenn im Tagger 'D' für Download gewählt wird. Pro Zeile wird
  584.   ein Protokoll definiert.
  585.  
  586.   Quit/NoQuit : Steht als erstes in der Zeile. Bei Quit wird der Tagger nach
  587.                 dem Ausführen der angegebenen Cmd-Datei verlassen. Dies ist
  588.                 praktisch, wenn in der Cmd-Datei eine Mecca-Datei erstellt
  589.                 wird, die nach der Rückkehr von Maximus ausgeführt werden
  590.                 kann. NoQuit bietet sich eher für externe Protokolle an.
  591.                 
  592.   Dann der Buchstabe, der für die Menuauswahl getippt werden muß und dann
  593.   ein Beschreibungstext in dem alle " " durch "_" ersetzt werden müssen.
  594.   Dann folgt der Name der Cmd-Datei, die ausgeführt werden soll, und abschließ-
  595.   end kann noch ein Parameter, der als erstes an die Cmd-Datei übergeben wird
  596.   angegeben werden (z.b. um die Protokolle zu unterscheiden). Maximal können
  597.   15 derartige Zeilen angegeben werden.
  598.  
  599.   Beispiel:
  600.  
  601.   Protocols
  602.     Quit X XModem     DOWNMULT.CMD X
  603.     Quit 1 XModem-1K  DOWNMULT.CMD 1
  604.   End Protocols
  605.  
  606.   7.3 Durchführung des Downloads :
  607.   --------------------------------
  608.   Für die Durchführung des Downloads wird eine CMD-Datei aufgerufen. Diese
  609.   wird entweder in der Protocol-Section definiert oder, wenn keine Protokolle
  610.   definiert sind wird DOWNLOAD.CMD aufgerufen. Die mitgelieferte Datei
  611.   DOWNMULT.CMD erstellt uebrigens direkt ein BBS-File, das nach Beendigung
  612.   des taggers in tagger.mec ausgeführt (angezeigt) wird und über das Download-
  613.   Token (geht ab 2.01wb) den Download in Maximus veranlasst. Bei dem Aufruf
  614.   von Externen Protokollen ist zu beachten, dass der Tagger nicht die Download-
  615.   statistik des Users updatet. Dies muss dann z.B. in der CMD-Datei geschehen.
  616.   In welcher Reihenfolge die Parameter an die jeweilige CMD-Datei übergeben
  617.   werden, soll dieses Beispiel zeigen :
  618.  
  619.   Protocols
  620.     Quit Z Z-Modem ZMODEM.CMD Z
  621.   End Protocols
  622.  
  623.   Der Benutzer wähle "Z" im Download-Menu aus.
  624.   Dann wir ZMODEM.CMD mit den folgenden Parametern gestartet.
  625.   Das Z ist der Optionale (letzte) Parameter aus der Protokoll-definition.
  626.   Die 5 sei hier das Com-Handle von Maximus (wichtig fuer externe Protokolle).
  627.   Die 01 sei hier die mit NODE=nn an den Tagger übergebene NodeNr eines
  628.   Multinode-Systems (ohne NODE=nn faellt dieser Parameter weg)
  629.   Dann folgen die ausgewählten Dateinamen mit vollständigem Pfad.
  630.  
  631.   ZMODEM.CMD Z 5 01 c:\tagger\dlfile01.lst
  632.  
  633.   Tip:
  634.   Welche Parameter nun wirklich genau an die Cmd-Datei uebergeben wurden 
  635.   kannst Du am einfachsten feststellen, wenn Du nach dem Aufruf mal in die
  636.   Logdatei des Taggers siehst.
  637.   
  638.   Wird kein "Downloadlist" Pfad angegeben (in der Filepath Section) dann
  639.   werden die markierten Dateien als Parameter in Anfuehrungsstrichen ("")
  640.   an die Cmd-Datei uebergeben.
  641.  
  642.   Noch eine Anmerkung zum Download-counter :
  643.   Ein evtl. vorhandener Downloadcounter muss in der FILES.BBS auf den
  644.   Dateinamen folgen um ausgewertet werden zu können. Er muss weiterhin
  645.   links und rechts durch je ein Zeichen eingegrenzt sein. Ob er dabei links,
  646.   mittig, rechts oder mit führenden nullen formatiert ist, ist egal.
  647.   Das Zeichen, mit dem der Downloadzähler links beginnt kann mit DLCDEL=""
  648.   angegeben werden.
  649.  
  650.   z.b. mit DLCDEL="[" (default) :
  651.  
  652.   TEST.ARJ   [  7] Dies soll ein Test sein                                            
  653.                                                                                       
  654. ==============================================================================
  655. 8.Bedienung :
  656. -------------
  657. Die Bedienung und die Funktionen des Programms werden schon einigemassen aus-
  658. führlich in der Datei TAGGER.HLF erklärt. Die Cursorsteuerung ist hierbei
  659. vorzugsweise durch die Tasten des Ziffernblocks vorzunehmen, da es für PgUp und
  660. PgDn keine ANSI-Codes gibt. Im lokalen Modus bzw. beim Einmischen des Sysops
  661. (pfui) in eine Sitzung eines Benutzers sind dagegen PgUp und PgDn auch
  662. benutzbar. Der Sysop-Chat kann übrigens nur lokal mit der Taste "C" gestartet
  663. werden(wenn mehr als 20 zeilen angezeigt werden). Beendet wird selbiger mit
  664. 2xESC vom Sysop oder vom geplagten User.
  665. Für das oben erwähnte "Einmischen" wird empfohlen den Parameter ECHO
  666. anzugeben, weil man sonst nix sieht. Allerdings stiehlt ECHO auch ein
  667. bischen Rechenzeit, weil die Ausgabe verdoppelt wird (Maximus-Schirm und
  668. Com-Port).
  669.  
  670. ==============================================================================
  671. 9.Weitere Nutzungshinweise :
  672. ----------------------------
  673. Der Autor heisst:
  674.          Michael Mrosowski
  675.          Mühlenweg 1
  676.          2000 Wedel 
  677. Fido   : 2:240/5022.1 
  678.  
  679. Ich wiederhole nochmal, daß für die Nutzung des Programmes KEINE Leistungen
  680. an mich zu entrichten sind. Ich bin auch niemandem in keiner Weise unfreundlich
  681. gesinnt, wenn er nicht spendet (s.u.).
  682. Wer das Programm gut findet und will, dass es weiter existiert, kann natürlich
  683. die weitere Entwicklung des Programmes durch Spenden unterstützen. Das 
  684. motiviert natuerlich ungemein :-).
  685.  
  686. Daher für Spendenwillige hier die Kontonummer :
  687.  
  688. Michael Mrosowski
  689. Kto.: 6256 66-205
  690. BLZ : 200 100 20
  691. bei : Postgiroamt HH
  692. Betreff : OffLine-Spende (wichtig, damit ichs auseinanderhalten kann)
  693. Betrag  : nach Belieben
  694.  
  695. Wer Geld überweist, wird offiziell zum Sponsor des Programmes ernannt und es
  696. wird ihm bei den folgenden Versionen in der "Hall of Fame" am Ende dieser Doku
  697. gedankt.
  698.  
  699. Die neueste Version des Programmes wird immer in der folgenden Mailbox als
  700. OFFTAGxx.ARJ (xx=Versionsnummer) bereitliegen und ist auch unter dem MAGIC
  701. OFFTAG requestbar. 
  702.  
  703. Offline BBS Wedel (Sysop Jens Meske)
  704. Fido    : 2:240/5022 und 2:240/5023
  705. Telefon : 04103/17984 und 04103/17985 (beide v32bis und Zyx)
  706.  
  707. Die jetzige Version heisst : OFFTAG10.ZIP
  708.  
  709. Jede Form von Fragen, Anregungen und Kritik ist als Netmail willkommen. Und
  710. speziell auch neue CMD-Files für die Einbindung von anderen Downloadmethoden
  711. und Sprach- oder Hilfe-Dateien die Ihr als wichtig oder witzig empfindet sind
  712. immer willkommen. 
  713. Ansonsten hab ich bisher noch Zeit gehabt auf jede Netmail zu antworten
  714. (hoffe ich jedenfalls).
  715.  
  716. Viel Spass damit !
  717.  
  718. Michael Mrosowski
  719.  
  720. *******************************************************************************
  721. 10. Hall of Fame :
  722. ------------------
  723. Täterätää : Besondere Ehre gebührt folgenden Spendern :
  724.  
  725. Leonhard Scheiber
  726.  
  727. Sascha Close
  728.  
  729. Thorsten Grimme
  730.  
  731. (Ich hoffe ich hab keinen vergessen)
  732. *******************************************************************************
  733.  
  734.