

            ******   ******    ******       ******  ******
             ****     ****      ****         ****    ****
              **       **        **           **      **
              ****     **        **           **      **
              ** ***   **        **           **      **
              **   *** **        **           **      **
              **     ****        **            **    **
              **       **        **       **    **  **
             ****     ****      ****    ****     ****
            ******   ******    *************      **


                                 THE

                           Nodelist-Viewer

                        Version 1.3 (26.04.93)

                            - Shareware -




Systemanforderungen

mindestens OS 2.0, viel RAM
ab OS 2.1:
  Untersttzung der locale.library
  ASL-Screenmode Requester



Vorwort

Der   Nodelistviewer   (im   Weiteren  NLV)  bietet  eine  komfortable
Mglichkeit,  sich  das "Telefon- und Adressbuch" des FIDO Netzes (und
hnlicher)  anzusehen.  Aber  nicht  nur  ansehen,  sondern auch Teile
daraus  ausdrucken  oder  nach  bestimmen  Adressen,  Namen oder Orten
suchen  zu  lassen.  Dafr gibt es zwar schon viele kleine Tools, aber
eben  kein mir bekannten zusammenhngendes Programm, das auerdem noch
eine   bersichtliche   Benutzeroberflche  (GUI)  bietet.  Fast  alle
Funktionen  des  NLV  sind  gleichzeitig  anwendbar,  so kann man also
Adressen  (Nodes)  suchen  lassen und mit diesen dann weiter arbeiten,
also  diese ausdrucken oder darin weiter suchen lassen. Natrlich sind
solche  Funktionen  meist  aufwndig  zu bedienen, doch beim NLV wurde
versucht,  diese Funktionen mglichst leicht benutzbar zu machen - was
hoffentlich auch gelungen ist.


Installation

Die  Installation  des  NLV  ist  relativ  einfach, sofern bereits ein
Fido-Mail  System  installiert ist (Nodelisten und MAIL: Verzeichnis).
Alles  andere macht unter OS2.0 das "Install_2.0"-Programm, ab 2.1 und
hrer  der  Commodore  Installer  ber die Programme im "Install_2.1+"
Verzeichnis  (fr  die  vom NLV untersttzten Sprachen liegen dort die
jeweiligen Dateien, sollte eine Sprache noch nicht untersttzt werden,
kann,  sofern eine bersetzung vorliegt, diese zuknftigen NLV-Paketen
beigefgt werden).


Starten des Programms

Der NLV kann ist 2 Betriebsmodi gestartet werden:

1. im "normalen" Modus als NLV, der gleich beschrieben wird,
2. im Generator-Modus.

Der  Generator-Modus  kann nur vom CLI aus aufgerufen werden, dazu mu
der  Parameter  "-c" beim Programmstart angegeben werden. Dahinter mu
einer  oder  mehrere Namen von Nodelisten (komplette Filenamen!) durch
Leerstellen getrennt folgen.
(Beispiel: "Nodelistviewer -c nodelist.260")

ber den genauen Sinn dieses Modus nur soviel: Fr jede Nodeliste wird
ein   Index-File  erzeugt,  um  die  Arbeit  zu  beschleunigen.  Diese
Index-File  mu  bei  jeder  neuen  Nodeliste berarbeitet werden, ein
zeitintersiver Vorgang, der zwar auch im "normalen" Modus stattfindet,
wenn  kein  aktuelles Index-File existiert, jedoch so automatisch beim
Einbinden eines neuen Nodediffs durchgefhrt werden kann.


Die Benutzeroberflche

Nach  dem  "normalen"  Starten  des  NLV ffnet sich ein neuen Screen.
Bevor    es   jedoch   richtig   losgehen   kann,   mu   ber   einen
ASL-Filerequester   eine  Nodeliste  ausgewhlt  werden.  Beim  ersten
Starten  wird im Verzeichnis NODELIST: gesucht, in dem bei den meisten
AMIGA-Fido-Systemen  die  Nodelisten  liegen.  Dieses Verzeichnis kann
jedoch spter ber die Voreinstellungen (siehe unten) gendert werden.

Der  NLV kann immer nur eine Nodeliste verwalten, hat man also mehrere
(z.B. FidoNET, AmigaNET, etc.), kann immer nur eine bearbeitet werden.
Eine andere mu wieder ber einen File-Requester ausgewhlt werden.

Hat  man  sich  fr eine Nodeliste entschieden, wird diese erst einmal
geladen.  Sollte noch kein Index-File (vgl. Generator-Modus) fr diese
Liste  existieren  wird  sie  jetzt  erzeugt.  Hier stt man wohl zum
ersten  mal  auf  das  Warte-Fenster  des  NLV.  Als  Zeichen, da das
Programm  arbeitet und nicht angestrzt ist (dies sollte sowieso nicht
mehr  der  Fall  sein),  blinkt ein Rechteck in diesem Fenster und die
Sekunden  werden  gezhlt  (dies  ist  reine  Nostalgie, da ich wissen
wollte, wie lange die einzelnen Aktionen dauern).

Anschlieend erscheint eine Liste der Zonen der eingelesenen Liste auf
dem Arbeitsschirm. Dieser ist ein zwei Teile geteilt, links die Liste,
rechts die Steuerleiste.

Der NLV kennt vier Betriebsmodi:

Zonen-Liste,
Regionen-Liste,
Nodes-Liste,
Ergebnisliste.

Die  Ergebnisliste  tritt  erst beim Suchen auf und wird dort erklrt,
hat  aber  grundstzlich die selben Bearbeitungsmglichkeiten, wie die
anderen drei Listen.

Warum  diese  drei  Listen? Die komplette Fido-Liste ist etwa 2 MBytes
gro,  zusammen  mit  dem  NLV und einigen Verwaltungsdaten wrde dies
alles  im  RAM  ber  4  MBytes bentigen! Durch diese Aufteilung wird
wesentlich weniger bentigt.

Um  nun  alle  Regionen  einer  Zone  bzw.  alle  Nodes  einer  Region
darzustellen  mu  die  betreffende  Zone/Region  einfach  durch einen
Doppelklick  angewhlt werden. Die neue Liste wird dann geladen (wobei
wieder unser Warte-Fenster erscheint).

Durch  einen  einfachen  Klick  auf  eine  Zone/Region/Node wird diese
angewhlt, d.h. alle Aktionen beziehen sich auf diese.

Um  nun  eine  Ebene  zurck zu gelangen (also von der Nodes-Liste zur
Regionen-Liste,  etc.)  gengt  ein (Doppel)-Klick auf das Gadget ber
der  Liste ("<"). Beim ersten Programmstart ist ein Doppelklick ntig,
dies  kann  jedoch  ber  die  Voreinstellungen (siehe unten) gendert
werden.   Direkt  zu  einer  bestimmten  Liste  (Regionen  /  Zonen  /
Nodelisten-Requester)  gelangt  man ber die Schalter "Region whlen",
"Zone  whlen", "Nodeliste whlen", je nach Voreinstellung durch einen
Doppelklick oder Einfachklick.

Mit  dem Schalter unter diesen dreien ("suchen") wird das Such-Fenster
(Beschreibung weiter unten) und mit dem nchsten ("Einstellungen") das
(Vor)Einstellungensfenster  (siehe  unten)  geffnet.  Die  nchsten 2
Schalter beziehen sich auf den angewhlten Node der Liste:

"weiteres"  ffnet  ein  Fenster,  in dem nhere Informationen gezeigt
werden  (Funktionsbeschreiben  siehe  unten). "Datei anfordern" ffnet
ebenfalls  ein  neues  Fenster,  ber  das  Files von diesem Node beim
nchsten Anruf angefordert (frequestet) werden knnen (siehe unten).

"externe  Programme" ffnet wieder einmal ein Fenster, ber das andere
Programme  Daten  vom  NLV  erhalten knnen. Nheres zu diesem Fenster
folgt  spter,  Informationen  fr Programmierer im Abschnitt "Externe
Programme schreiben".

"Anrufen" wiederum bezieht sich auf den aktiven Node. Dieser wird dann
angerufen. Das dazu ntige Programm kann im Einstellungsfenster (siehe
unten) ausgewhlt werden.

"ber" ffnet ein Informationsfenster ber den NLV, "Ende" verlt der
Programm.

Alle  diese  Funktionen  lassen  sich  ebenfalls  ber Pull-Down Mens
aufrufen. Darber hinaus stehen noch weitere Funktionen zur Verfgung:

Es kann ein CLI-Fenster geffnet und die Workbench geschlossen werden.
Mit  "Verbergen"  kann  der  NLV-Bildschirm  geschlossen werden und es
erscheint  ein  Icon  auf  der  Workbench,  ber  das  der  NLV wieder
aktiviert wird. Auerdem kann man direkt mit der Funktion "GEHE ZU" zu
einer  Region springen. Es ffnet sich ein Eingabefenster, wie bei den
Warte-Fenstern  sind  alle  anderen Funktionen blockiert. Da teilweise
die   Regionsnummern  doppelt  vergeben  sind,  kann  auch  eine  Zone
angegeben  werden  (Dies  ist zwar selten, aber kommt vor. In so einem
Fall wird immer die erste gefundene Region gezeigt!). Soll nur in eine
Regionenliste  gesprungen werden, kann die Angabe der Region durch das
Gadget  hinter den Eingabefeldern abgeschaltet werden. Ebenso kann die
Angabe der Zone abgeschaltet werden.

Schlielich  kann  noch  Sendfile_Deluxe  gestartet werden (oder jedes
andere  Programm,  das  im Einstellungs-Fenster (s.u.) angegeben ist).
Mit Sendfile_Deluxe kann man den Nodes, die man anruft Files schicken.
Nheres steht in dessen Doku. WICHTIG! Ab NLV 1.3 wird Version 0.7 von
Sendfile_Deluxe  bentigt,  da  es  wie jedes andere externes Programm
angesprochen wird.

Das nchste Men "Marke" dient zum (Ent-)Markieren von Nodes, entweder
des  aktiven  oder  aller; sowie des Speichern der markierten Nodes in
einer  "Nodes-Datei" (deren Name kann im Einstellungs-Fenster bestimmt
werden kann (vgl. auch Suchen)) und des Drucken der markierten Nodes.

Darber  hinaus  kann auch mit der Maus markiert werden. Dazu mu beim
Anwhlen  einer  Zeile  die SHIFT-Taste gedrckt werden. Wird die Maus
bei  gedrckter  SHIFT  und linker Maustaste bewegt, kann ein grerer
Block  markiert  werden,  dabei  zhlen  die  am  hhsten und tiefsten
liegenden  berhrten  Zeilen  als  Ober- bzw. Untergrenze. Es wird die
Markierung  gesetzt  oder  gelscht, jeweils der umgekehrte Status der
zuerst  gewhlten  Zeile.  Als  besonderes Freature ist dies ebenfalls
einfach mit der mittleren Maustaste mglich (sofern vorhanden).

Zustzlich sind noch folgende Tastenfunktionen vorhanden:

  CURSOR
  HOCH/RUNTER:
               ndert aktiven Node
  LINKS:
               wie "<" eine Stufe zurck (Doppelklick beachten)

       RETURN:
               wie Doppelklick auf einen Node (Zone/Region/Node-Info)

    LEERTASTE:
               (ent)markieren

Dies sind die Funktionen des Hauptfensters.


Suchen

Dies  ist  wohl  eine der wichtigsten Funktionen des NLV, entsprechend
komplex  gefllt  ist  das zugehrige Fenster. Die Suchen-Funktion ist
eine  der  mchtigsten  Funktionen  im NLV, obwohl sie sehr einfach zu
bedienen  ist.  Ihre  besondere  Funktionsvielfalt  liegt vor allem im
Betriebsmodus   Ergebnisliste  (auch  Extraliste  genannt)  und  durch
untersttzen von markierten Nodes.

Aber erst einmal zum Fenster und den Schaltern:

Oben  kann der Suchtext eingeben werden, alle DOS-Wildcards (#?, etc.)
werden untersttzt.

Im  mittleren Teil des Fensters kann bestimmt werden, nach was gesucht
wird  ("Suchen  nach"),  also  ob  nach der Node-Nummer (Adresse), dem
Namen  des  Sysops,  dem Systemnamen oder anderem gesucht werden soll.
ALLE  Suchkriterien  werden  wie  Text behandelt, d.h. sucht man einen
bestimmten Node, mu dessen Adresse Fido-Typisch eingegeben werden.

Beispiele:
alle Nodes der Region 24 in Zone 2: "2:24#?"
alle Nodes der Region 24, Zone 2 mit einer 5 am Anfang: "2:24#?/5#?"
alle Nodes mit einer 2 am Anfang: "#?/2#?"

Um  die  Suche  zu  beschleunigen  bzw.  auch zu vereinfachen kann man
ebenfalls  im mittleren Teil des Fensters bestimmen, wo gesucht werden
soll ("Suchen in"):

- in der gezeigeten Region ("dieser Region"), es mu also eine
  Nodes-Liste zu sehen sein,

- in der gezeigten Zone ("dieser Zone"), es mu die Regionen- oder
  Nodes-Liste gezeigt sein,

- in der ganzen Liste ("ganze Liste") sucht in der ganzen Nodeliste,

- in der Ergebnisliste ("Ergebnisliste") ist gleichzeitig die schnellste
  Suche, weil nur im RAM gesucht wird. 

- in markierten Nodes ("markierten") ist ebenfalls schnell - dafr
  auch nur bei Ergebnislisten und Nodes-Listen mglich. Es werden nur
  die markierten Nodes untersucht.

Unterhalb  dieser  Wahlbereiche  kann nun bestimmt werden, was mit den
gefundenen  Nodes  geschehen  soll.  Sie  knnen  in  eine  neue Liste
aufgenommen  ("in extra Liste")(dies ist diese ominse Ergebnisliste),
in  einem Fenster gezeigt ("in extra Fenster") oder aber direkt in der
entsprechenden   Zone   und   Region   gezeigt   werden   sollen  ("in
Region-Liste").   Schlielich  knnen  gefundene  Nodes  noch  einfach
markiert  werden. Dies ist aber nur bei einer Suche in der Nodes- oder
Ergebnis-Liste  mglich.  Mit  der  Ergebnisliste  bzw. den markierten
Nodes  kann  nun  weiter  gearbeitet  werden, d.h. es kann dort weiter
gesucht werden.

Auerdem  knnen  die  gefundenen Nodes ausgedruck ("drucken") oder in
einer  Datei  gespeichert ("in Datei") werden. Der Name der Datei kann
in den Voreinstellungen gendert werden.

Mit  dem  Schalter "Suchen" wird die Suche gestartet, "Suchen ab hier"
startet  die  Suche  unterhalb der gewhlten Node. Es erscheint wieder
das Warte-Fenster, jedoch kann diesmal abgebrochen werden.

Hier noch einige Tips und Beispiele, um das Suchen zu optimieren.

Suchen nach allen HUBs in Zone 2, Region 24, Host 245:

 Also suchen wir erst ALLE Nodes mit dem Adress-Muster "2:245/#?" ber
 suchen in dieser Region, wobei wir in Region 24 sind. Das ganze
 lassen wir uns in der Ergebnisliste zeigen. Dann suchen wir in der
 Ergebnisliste mit dem Status-Muster "hub". Fertig!

Suchen nach allen Regionen weltweit:

 Such-Muster "region", suchen nach STATUS, suchen in GANZER LISTE.
 Fertig!

Kopieren von markierten Nodes in die Ergebnisliste:

 Such-Muster ALLES "#?", suchen nach ADRESSE (ist aber egal!), suchen
 in MARKIERTEN, zeigen IN EXTRA LISTE - Fertig.


Achtung  bei  Sysop-Namen!  In der Fido-Nodeliste sind Namen durch den
Unterstrich  ("_")  verbunden.  Deshalb mu dieser auch beim Suchen im
Suchtext angegeben werden.

Als  Anhaltspunkt,  das Suchen in der ganzen Fido-Nodeliste dauert auf
meinem  A4000/40  mindestens  70  Sekunden  bei einem relativ seltenen
Suchmuster (also nur jeder ca. 200. Node).

Hier  nochmal  eine  Zusammenstellung,  bei  welchen Einstellungen ein
Suchen nicht mglich ist (SUCHEN-Schalter gesperrt):

-       Ergebnisliste + Suchen in Region/Zone/ganze Liste
- keine Ergebnisliste + Suchen in Ergebnisliste
- keine Nodes-Liste   + Suchen in Region
- zeigen durch Marke  + Suchen in Zone/ganze Liste


Einstellungen

Das  Einstellungsfenster  ist  das  Fenster mit den meisten Schaltern.
Aber  keine  Sorge,  alle  Funktionen haben ihren Sinn und selbst eine
Fehlbedienung fhrt nicht zum Chaos oder Absturz!

Links oben knnen ALLGEMEINE Einstellungen gettig werden.

Dies  sind  das  "merken  der Fensterpltze". Ist diese Funktion aktiv
werden  bei beenden des NLV die Positionen der Fenster gespeichert und
beim  nchsten  Programmstart  werden  die  Fenster  wieder  an diesen
Stellen geffnet.

"Doppelklick-Schalter"  haben  wir schon kennen gelernt. Dies sind die
Schalter  "<",  "Nodeliste whlen", "Zone whlen", "Region whlen" des
Hauptfensters, da diese alle zu zum Teil lngeren Ladeaktionen fhren.

"Schalter  verstecken" lt die Gadgets des Hauptfensters verschwinden
und die Liste wird auf dem gesamten Schirm gezeigt.

"Anruf  asynchon"  startet das Anrufprogramm als unabhngiges Programm
von NLV, ansonsten wird gewartet, bis dieses Programm beendet ist.

Bei   aktiven   "Fett   drucken"  werden  die  Informationstexte  beim
Ausdrucken   eines  Nodes  fett  gedruckt  (die  sind  z.B.  "Status",
"Region", "Name").

Darunten  knnen  die  FARBEN des NLV-Screen bestimmt werden. "Zurck"
setzt  die  Farben  auf  den  Wert  bei ffnen des Einstellungsfenster
zurck, "WB Farben" bernimmt die Farbtabelle des Workbench-Schirms.

Rechts  oben  knnen  PFADE  & DOS -Werte bestimmt werden. Es kann das
Verzeichnis   der  Nodelisten  gewhlt  werden,  das  Such-Muster  das
ASL-Filerequesters   (Als   praktisch   hat   sich  "#?(LIST|NET).???"
erwiesen.   Es   pat   auf   die   meisten   Liste.),  der  Pfad  zum
Outbound-Verzeichnis,  der  Pfad  und  das  Programm zum Anrufen eines
Nodes,  dessen  Startparameter,  den Pfad und Namen eines File-Senders
(z.B.  Sendfile-Deluxe)  und  der  Name  der  Nodes-Datei, in die beim
Suchen die gefundenen Nodes geschrieben werden.

Die Startparameter knnen folgende Steuercodes enthalten, die beim
Starten des Anruf-Programms ersetzt werden:

%n - Nummer des aktiven Nodes
%p - Passwort des aktiven Nodes
%s - Name des NLV-PublicScreen
%t - Telefonnummer des aktiven Nodes

Das Passwort kann weggelassen werden, da diese Programme meist sowieso
einen  Zugriff  auf  die  Nodeliste und Passwortliste haben. Ansonsten
sollte  der  Steuercode  in Anfhrungszeichen stehen ("%p"). Damit ein
Programm  seine  Fenster  auf  einem Public-Screen ffnen kann, mu es
dessen  Name  wissen, der mit dem %s-Code bergeben werden kann. Da es
mglich  ist,  den  NLV  mehrmals  zu  starten, kann auch der Name des
Public-Screens verschieden sein, da diese durchnummeriert werden.

Rechts  unten  kann  schlielich die OBERFLCHE eingestellt werden. Ab
OS2.1  enthlt  die  asl.library einen Screen-Mode-Requester, der ber
den Schalter "Schirm Modes" geffnet wird. Ist keine OS2.1+ vorhanden,
ist  dieser  Schalter gesperrt. Darunter kann der Font des Nodes-Liste
eingestellt werden.

Der   Schalter  "Speichern"  sichert  die  Einstellungen  fr  sptere
Programmstarts,  "Benutzen"  stellt  die  neuen Einstellungen ein, sie
werden  aber  nicht  dauerhaft  gesichert,  "Abbrechen"  schliet  das
Einstellungen-Fenster ohne die nderungen durchzufhren.

Diese 3 Schalter sind auch ber Pull-Down-Mens zu erreichen, auerdem
noch eine weitere Funktion, um die alten Einstellungen zu laden ("alte
Einstellungen laden").


Weiteres

Das  Weiteres-Fenster  zeigt  ausfhrliche Informationen zum gewhlten
Node.  Weiterhin kann fr jeden Node eine eigene Bemerkung gespeichert
werden  und,  wenn  die  traplist.library vorhanden ist, ein Passwort.
Zustzlich   kann   auch  zu  den  Points  eines  Nodes  ein  Passwort
gespeichert  werden,  die Eingabe der Point-Nummer ist ber das kleine
Eingabefeld  hinter  dem  Passwort-Feld  mglich.  Um  eine  genderte
Bermerkung  oder  ein gendertes Passwort auch dauerhaft zu ndert mu
der  Schalter  "Sichern"  angewhlt werden. "Drucken" druckt die Daten
des gewhlten Nodes aus.


Datei anfordern

Im oberen Teil des Fensters steht eine Liste der bereits angeforderten
Files  des  gewhlten  Nodes,  im Text-Feld darunten knnen neue Namen
eingeben werden, "OK" schliet das Fenster und speichert die Liste zum
requesten,  "ABBRUCH"  schliet  das  Fenster  ebensfalls,  nderungen
werden  aber  nicht  gespeichert.  Um  einen  Filenamen zu ndern, mu
dieses  angewhlt  sein und kann dann im Eingabefeld darunter gendert
werden,  ist  es  ganz leer wird das File ganz aus der Liste gelscht.
Ein neues File kann eingegeben werden, wenn kein File angewhlt ist.


Externe Programme

Oben  sieht  man eine Liste der Programme, die Daten vom NLV empfangen
knnen.  Diese  Liste  stellet allerdings immer eine Momentaufnahme da
und   kann   aus  AMIGA-Internen  Grnden  (schon  alleine  wegen  dem
Multitasking) nie vllig aktuell sein. Naja, sie ist es im allgemeinen
immer solange, bis ein anderes Programm vom Anwender bedient wurde.

Um  die  Liste  wieder  auf  den  neusten  Stand  zu bringen dient der
Schalter "aktualisieren", welche wunderbarer Zufall. Mit den unteren 3
Schaltern kann nun an das angewhlte Programm gesendet werden bzw. das
Fenster einfach ohne Aktion geschlossen werden ("schlieen").

"Aktive" sendet die Adresse des gewhlten Nodes zum gewhlten Programm
(hier  kann  man  also  whlen  ;-).  "Markierte" schickt dagegen alle
markierten  Nodes  zum gewhlten Programm, was allerdings etwas dauern
kann.  WARNUNG:  Damit die Liste wirklich aktuell ist wird WHREND der
bertragung  der  Adressen  das Multitasking abgeschaltet. Sollte also
der  Mauszeiger  ruckeln  oder  das  gewhlte  Programm  nicht  sofort
reagieren,  keine  Panik.  Nheres  ber  interne  Ablufe und wie man
Programme  fr diese Schnittstelle schreibt im Teil "Externe Programme
schreiben".


Rechtliches, Copyright

Das Programme wurde erstellt mit KICK-Pascal 2.0 von MAXON-Computer.

Alle  Informationen  und  Namen in dieser Beschreibung und im Programm
wurden  ohne  Rcksicht  auf einen eventuellen Patentschutz verwendet.
Ebenso wurden Warenzeichen ohne Gewhrleistung einer freien Verwendung
benutzt.

Fr  Schden,  die  durch  das  Programm verursacht wurden, wird keine
Haftung bernommen!

Das Programm unterliegt dem Copyright (c) 09/1993 by J.Schmitz [SOFT].

        Eine Verbreitung der frei kopierbaren unregistrierten
     Shareware-Fassung auf PD-Disketten oder per DF ist erlaubt.

         Wer  NLV auf eine PD Serien Diskette kopieren will,
  mu dem Autor eine Kopie dieser Diskette zuschicken, sonst nichts.


Wie man sich registrieren lt
(How to register)

Dieses  Programm ist Shareware. Die unregistrierte Version darf einige
Wochen  kostenlos  getestet werden. Jede Verwendung darber hinaus ist
nur mit einer beim Autor registrieren Fassung erlaubt.

Die  Registrierung  kostet  DM  30,--  (andere  Whrungen werden nicht
akzeptiert!).  Ein  fertiges Registrier-Formular kann mit dem Programm
"Register"  erzeugt werden. Ich bitte, dies auch zu verwenden und alle
Felder richtig auszufllen.

Den  Ausdruck  dann  per Post an mich schicken. Meine Adresse und alle
erforderliche  Daten  (Konto,  etc.)  steht darauf. Auerdem ist meine
Adresse nochmal am Ende dieser Beschreibung.

Wer  seinen  Key  per  Fido  File-Attach  mchte,  mu unbedingt seine
Fido-Adresse  angeben!!  Wer  seinen Key per Diskette wnscht, mu mit
einer   etwas   lngeren   Wartezeit  rechnen  (nicht  nur  wegen  der
Versanddauer); auerdem kostet dies DM 2,-- extra!


Internes

Der  NLV wurde auf Inspiration von Matthias Wege entwickelt und konnte
seine  Funktionalitt  so  direkt  bei ihm unter Beweis stellen. Viele
Probleme   bereitete  vor  allem  die  umbegrenzte  enorme  Gre  der
Nodelisten.  Das  Problem  konnte durch die Aufteilung in verschiedene
Listen-Modi gelst werden, so da eine optimale GUI gewhrleistet war.

Von Interesse ist vielleicht das Verhalten des NLV bei Speichermangel.
Der  NLV  versucht  dann  zu retten, was zu retten ist. In den meisten
Fllen  wird  die  laufende  Funktion  abgebrochen und dies ber einen
Requester  mitgeteilt.  Reicht der Speicher auch dafr nicht mehr aus,
wird  das  Programm  beendet  und der gesamte benutzte Speicher wieder
freigegeben.


Externe Programme schreiben

Diese   Schnittstelle  bietet  eine,  so  finde  ich,  leistungsstarke
Mglichkeit,  Programme  benutzerfreundlicher  zu  machen.  SO mu man
nicht  mehr  umstndlich Nummern eingeben, sondern kann sie direkt vom
NLV bertragen lassen.

Damit  nun  aber  andere  Programme diese Schnittstelle nutzen knnen,
hier ein paar interne Hinweise.

Zum  Empfang  einer  Adresse ist nichts weiter ntig, als ein normaler
Exec-Message-Port.  OK,  so  ganz  normal sollte er nicht sein. Er mu
ffentlich  sein, also einen Namen besitzen. Und genau dieser Name ist
das  Zeichen  fr den NLV, da dieser Port fr ihn ist. Jeder Name mu
das Prefix "NLV." haben und darf nicht lnger als 45 Zeichen sein.

Beispiel:
Das   Programm   heit   "Sendfile_Deluxe".   Der   Port   heit  dann
"NLV.Sendfile_Deluxe"  oder hnlich. Wer auf Nummer sicher gehen will,
kann seine Ports auch numerieren ("NLV.Sendfile_Deluxe.1").

Wie sieht nun eine solche Message aus. Ganz einfach:


C-Fassung:

struct NodeMessage {
  struct Message  nm_Message  /* system-message-header */
  UWORD           nm_Version  /* Version der Message, z. Z. == 1 */
  UWORD           nm_Zone     /* Fido-Zone */
  UWORD           nm_Netz     /* Fido-Netz */
  UWORD           nm_Node     /* Fido-Node */
  UWORD           nm_Point    /* Fido-Point - immer NULL */
  LONG            nm_Flags   
}

Pascal/Modula-Fassung:

NodeMessage=Record
 nm_Message : Message; (* system-message-header *)
 nm_Version : Word; (* Version der Message, z. Z. = 1 *)
 nm_Zone    : Word; (* Fido-Zone *)
 nm_Netz    : Word; (* Fido-Netz *)
 nm_Node    : Word; (* Fido-Node *)
 nm_Point   : Word; (* Fido-Point - immer NULL *)
 nm_Flags   : Long;
end;

nm_Flags:
 only1      = 0 : es folgt erstmal keine weitere Message
 followMore = 1 : es folgen weitere Message, diese Adresse sollte
                  deshalb gespeichert werden

Die  Version betrgt zur Zeit 1. Sptere Versionen knnten Ergnzungen
besitzen (Sysop-Name, Systemname, etc.), jedoch wird der Anfang gleich
bleiben.  Die  Felder  nm_Zone,  nm_Netz  und  nm_Node  enthalten  die
Adresse,  nm_Point  ist  immer  null.  Jedoch  sollte nicht fest davon
ausgegangen werden!

nm_Flags  ist  fr manche Programme sehr wichtig, fr andere berhaupt
nicht;   das  hngt  von  der  Art  ab,  wie  die  ankommende  Adresse
verarbeitet  wird.  "only1"  besagt, da voraussichtlich keine weitere
Adresse  gesendet  wird  (AKTIVE  Node  senden).  "followMore" widerum
heit,  da weitere Adresse folgen knnen (MARKIERTE Nodes senden). Es
kann  auch  hier nur eine gesendet werden, falls nur ein Node markiert
war.

Wie   bei   Exec  blich,  mu  auch  diese  Mail  beantwortet  werden
(ReplyMsg()), alle Felder drfen nur ausgelesen werden!


Sendfile-Deluxe

Sendfile-Deluxe  ist ein File-Sender von mir, der speziell fr den NLV
erweitert  wurde,  um Nodedaten von dort zu bernehmen. Es ist bei der
RHLB  zu  frequesten.  Zu  Hinweisen ber den aktuellen Filenamen oder
Besonderheiten  einfach  eine  Fido-NetMail  an  mich  (Adresse  siehe
unten), mit dem Subject/Betreff "Sendfile/NLV".


Adressen

Fr weitere Anregungen und Fragen zum NLV hier meine Adressen:

Brief-Post         
                            Jrgen Schmitz
                            Bergstrae 82

                         D-56859 Bullay/Mosel

FidoNET
                    Juergen Schmitz, 2:245/5630.3

AmigaNET
                    Juergen Schmitz, 39:176/401.2
                            neue Adresse!

SkyNET
                     Juergen Schmitz, 166:401/6.0


Letzte Worte, Dank

Wie immer liegt dieser Beschreibung ein .sprint-File bei. Damit ist es
mglich  mit  SuperPrint  (3.0+)  diese Beschreibung bersichtlich mit
Inhaltsverzeichnis   auszudrucken.   SuperPrint   ist  bers  AmigaNet
verfgbar.  Neuste  Versionen  davon, wie auch vom NLV, sind in meiner
Stammbox  Rheinland-Box  (2:245/5630)  immer  zu  erhalten. Fragt mich
einfach  mal  per  (Net)Mail  um  zu  erfahren,  wie  man  die  neuste
(eventuell  auch beta) Version frequesten kann. Beta-Tester sind immer
willkommen.

Ein  Dank  an alle, die den NLV registrieren lassen. Sie frdern damit
weitere Programme und den Ausbau des NLV.

Ebenfalls  ein  Dank  an M. Wege, fr seine Test-Geduld, die gerade in
lteren  Versionen beim langen Laden des Listen ntig war, denn selbst
auf einem 1200er konnte dies dauern.

Und  ein  Dank  an  meinen  A500,  der mal nicht abstrzte, als er die
Enforcer-Hits meines A4000 zeigen sollte.


Versionliste

Version 0.998:

 - erste ffentlich erhltliche Fassung

Version 0.999:

 - Index-Fileformat gendert
 - Bemerkung kann gesichert werden - bei registrierter Fassung
 - Node 2:245/5630, Point 2:245/5630.2 & 3 haben interne Bemerkungen:)

Version 0.9992:

 - neue Funktion GEHE ZU
 - Pull-Down-Mens der Hauptfensters gendert

Version 0.9995:

 - im Delay-Window werden jetzt wirklich Sekunden gezhlt
   (gell, Matthias)
 - Zonen/Regionen/Nodes einlesen nochmal beschleunigt
   (interner Buffer kleiner, dadurch beim Zonen&Regionen lesen
   schneller - event. bald ber Prefs einstellbar)
 - jetzt auch Bemerkungen fr Points speicherbar (nicht druckbar!)
 - Tastensteuerung im Goto-Fenster

Version 0.9996:

 - Fehler bei Passwort-Sicherung entfernt
   (Probleme mit trapdoor.library, Grund unbekannt)
 - auch fr Points Passwort speicherbar 
 - diverse kleine nderungen

Version 0.9997:

 - wurde der Bildschirm neu geffnet konnte der
   Nodelisten-Requester nicht mehr geffnet werden

Version 0.9998:

 - neues Locale Handling, neue Locale-Files!
 - locale PD-Mens jetzt mit localen Short-Cuts

Version 1.0:

 - vorerst fertige Fassung mit Beschreibung
 - kleinere Umordnung der Gadgets im Hauptfenster, da fr die
   Beschreibung besser
 - Gadgets im Einstellungs-Fenster leicht gendert
 - Farbverwaltung auf OS-3.0 (256-Farbstufen) gendert, alte
   Palette unbrauchbar (wird nicht aktualisiert, da zuvor keine
   ffentliche Fassungen), Locales angepat

Version 1.1:

 - Markieren von Nodes
 - Tastensteuerung erweitert
 - Interne Beschleunigung des Nodelisten-Einlesen
 - diverse Fehler entfernt

Version 1.2: (Testversion, nur bei RHLB verfgbar)

 - Markierung der Nodes gendert
 - komplett eigenes ListView Gadget realisiert
 - kleinere Fehler der neuen Markierungs-Funktion entfernt, komplett
   berarbeitet wegen neuer Markierungsart
 - Nodes-Textzeile wieder auf alte Lnge gebracht, Markierung jetzt
   durch Umfrbung im ListView erkennbar
 - Cursor-Steuerung verbessert
 - Markieren jetzt mit der Maus mglich durch berstreifen
 - ASL-Screenmode-Requester jetzt mit Grenfeldern (war wegen
   A2024-Monitor ntig)
 - Falsche Fonts im Warte-Fenster
 - Suchen in markierten Nodes
 - markieren von gefundenen Nodes
 - Locale-Files entsprechend erweitert
 - Anruf-Parameter %T ergnzt
 - kleinere Fehler entfernt (GenericGadgets-Funktionen waren in
   lterer Version fehlerhaft eingebunden worden)

Version 1.2a:

 - Iconify-Funktion
 - ListView berarbeitet (OS3.0 - MakeVisible hnlich)
 - Screen-Grennderungen werden jetzt erkannt
 - "Begrungsfenster" bei registrierter Version
 - Nodelisten-Wahl kann jetzt wirklich abgebrochen werden ;-)
 - ASL-Requester Speicher wurde bei Abbruch nicht freigegeben
 - Screen Hhe kann nicht mehr kleiner als 200 werden
 - Cataloge ergnzt und das Men-Shortcuts-Format stark berarbeitet
 - Suchen/Markieren Fehler entfernt
 - vor der Version vom 13.12. wurden bei MARKIEREN/MARKIERTE DRUCKEN
   alle Node gedruckt - uops ;-)
 - ab Version 1.2a vom 18.12. werden die Einstellungen als IFF-File
   gespeichert, das alte Format wird bis voraussichtlich Version 1.3
   gelesen (beim Starten wird automatisch das neue Format geschrieben)
 - Cursor-Links fr 1 Stufe zurck (Doppelklick ebenfalls ntig)
 - Cursor-Wahl verbessert (so glaube ich jedenfalls): war kein Node
   angewhlt wird IMMER der oberste/unterste der SICHTBAREN Nodes bei
   der Anwahl gewhlt

Version 1.3:

 - Komplett neue Catalog-Files! (alte werden ignoriert!)
 - Externe Programme
 - Sendfile_Deluxe kann nur noch ber Men gestartet werden
 - File anfordern gendert. Es wird nicht mehr so oft gespeichert,
   leere Listen werden jetzt nicht mit 0 Bytes gespeichert, sondern
   gelscht (jetzt sollten automatische ARexx-Request-Scripts richtig
   anrufen knnen) ;-)
 - Default-Prefs leicht gendert - so sind sie einfach besser ;-)
 - leichte Geschwindigkeitssteigerung beim Einlesen
 - Enforcer-Hit bei neuer "Externe Programme" Schnittstelle entfernt
   (warum haben Programme auch einen ffentlichen Messageport, wenn
   sie keinen Namen dafr deffinieren?? ;-)
 - ListView hatte in einigen Beta-Fassungen Probleme bei der
   SHIFT-Deselektierung (entstand durch nderungen am ListView fr
   Barney)
  

Geplantes:

 Irgendwann OS3.0/AGA Farbauswahl
 NodeMessage-Struktur ausbauen
 mal sehen, was die Anwender und ich fr Ideen haben ;-)


---------------------------------------------------------------------
Und brandhei:

BARNEY, ein Filelisten-Request-Utility der Extraklasse.

                               OS2-GUI

             Unbegrenzte Anzahl von Telefonbucheintrgen
                freie Wahl der Filenames der Fileliste

     Durchschnitts-CPS-Rate zur Preisberechnung fr jeden Eintrag
              Dauer der Telefoneinheit fr jeden Eintrag

                DOS-Namen (8-Zeichen-Punkt-3-Zeichen)
                      US-Datum (Monat/Tag/Jahr)

               Volle Tastensteuerung (visual feedback!)
                       Unter OS3.x Memory-Pools

                        Freie Screenmode-Wahl
             Farb-Requester (ab OS3.0 fr 16 Mio Farben)

        Preisberechnung aus Filelnge, CPS und Einheitendauer
                   Locale Texte (sowie Geld-Format)

   Requester-Library-Wahl (ASL, ReqTools, Interne Funktionen, etc.)
     Nobles ListView fr Fileliste (verbesserte Fassung aus NLV)

Request in Zusatzliste gespeichert, um Lnge und Passwort zu bewahren
           Automatisches Lschen berflssiger Zusatzlisten

                           Manuelle Eingabe
            Nachtrgliche Eingabe von Passworten zu Files

                     Anrufen aus Programm heraus
                    traplist.library Untersttzung

    Umfragreiche Suchfunktion (DOS-Pattern) nach Texten allgemein,
                Files, Datum (jnger/lter), Neuheiten

               "Externe Programm"-Schnittstelle zum NLV
                         Filelisten entpacken
                         
             AKA fr mehrere Nodenummern bei selber Liste


Wo gibt's dieses super Teil? Bei der Rheinland-Box (2:245/5630) unter
"BARNEY.LHA".

---

JS/02
