#$K+ VTGrabWatch - Prüfprogramm für VTGRAB.COM
Dieses Programm dient zur Funktionsüberprüfung des Datenaustausches mit dem Programm VTGRAB.COM, dem "Sammler" für Videotext, über die Datei VREQxxx.VTD. Diese Binärdatei mit festgelegtem und dokumentiertem Aufbau wird vom laufenden VTGRAB.COM für die Anforderung bestimmter Seiten und zur Statusmeldung abgefragt und auf dem laufenden gehalten. Mit dieser Datei ist eine problemlose Kommunikation auch über Rechnergrenzen hinweg möglich, sofern das Dateisystem zugreifbar ist. (Siehe Dokumentation zu VTGRAB.)
In einer künftigen Version von VT.EXE und VTW.EXE, den Videotext-Anzeigeprogrammen für DOS und Windows, soll der Zugriff auf diese Datei praktische Verwendung finden.

Inbetriebnahme
Beschreibung
Dialogelemente
Kommandozeile
Fehlermeldungen und bekannte Bugs
Windows-Hilfe VTGWATCH.HLP Version 1.0 (01/97)

#$+K Inbetriebnahme
Voraussetzungen:
Dieses Programm benötigt mindestens Windows 3.0 im Standard-Modus sowie ein gerade laufendes VTGRAB.COM. (Übrigens tut dieses Programm bereits 2 Jahre seinen Dienst, ohne daß Patches oder Bugfixes erforderlich waren! Das beweist: Wo wenig Code ist, da sind auch weniger Fehler.)
Der Zugriff auf die Binärdatei VREQxxx.VTD (xxx ist dabei die Portadresse als Hexzahl) muß möglich sein. Als Kommandozeilenargument muß der komplette Pfad und Dateiname dieser Datei angegeben werden!
Zur optimalen Darstellung sind mindestens 640x480 Pixel mit kleiner Schrift erforderlich. Angeraten sind 800x600 Pixel und kleine Schrift. Ansonsten könnte das Hauptfenster nicht komplett auf den Bildschirm passen.

Installation:
Nachdem das Archiv ausgepackt wurde, wird ein Icon im Programm-Manager bzw. auf den Desktop oder in die Autostartgruppe gelegt sowie danach das Programm konfiguriert. Als Kommandozeilenargument gibt man Pfad und Dateiname der VREQxxx.VTD an. (Ansonsten verwendet dieses Programm "\\TOASTER_105\D_TOA\VT\VREQ100.VTD", der Pfad des Autors)
Alternativ kann die Datei über das Programm-Menü ausgewählt werden, aber wer will das schon jedesmal tun?

Laufenlassen mehrerer VTGWATCH gleichzeitig:
Dies macht Sinn! VTGRAB.COM kann ja auch mehrfach laufen (zugegeben: sehr selten in der Welt der TSR's), und da könnte es mehrere VREQxxx.VTD-Dateien zu überwachen geben.
Damit diese Kopien nicht ganz dasselbe tun, ist eine Unterscheidung ihrer Arbeitsweise erforderlich. Dies geschieht über verschiedene Kommandozeilenparameter oder manuell für jede Instanz durch Auswahl der Datei über's Menü.

Dieses Programm besteht aus:
VTGWATCH.EXE	das Programm (z.Z. Version 1.01)
VTGWATCH.HLP	diese Hilfedatei (z.Z. Version 1.0)

#$+K Beschreibung
Dieses Programm greift auf die Datei VREQxxx.VTD (der genaue Dateiname ist unerheblich) lesend und bei Bedarf schreibend zu. Der Inhalt der Datei wird in dem Haupt-Dialogfenster komplett dargestellt, die Flags Bit für Bit. Die schräge Reihe von Radiobuttons links unten schaltet die Beschreibungstexte zu den 32 Markierungsfeldern um (der Dialog wäre sonst zu groß geworden).

Der Dateizugriff erfolgt entweder von Hand über die Schalter Lesen und Schreiben, oder automatisch bei Aktivierung der entsprechenden Markierungsfelder periodisch mit einstellbarer Zeit bzw. beim Verändern eines Markierungsfeldes.
Beim automatischen Lesen wird das "Dateidatum" (modification time, "Zeitstempel", Uhrzeit letzter Zugriff) getestet und bei festgestellter Veränderung ein Pieps ausgegeben, die Datei neu eingelesen und der Inhalt neu dargestellt. (Oftmals verändert sich nur der Garbage-Collection-Zähler.)

Unabhängig davon wird immer automatisch die Dateigröße der aktuellen Videotext-Datei erfaßt und dargestellt (ohne Piepser; diese Funktion ist neu bei Version 1.01 hinzugekommen).

Die Konfiguration von "Automatisch lesen", "Automatisch schreiben" und dem Zeitintervall kann abgespeichert werden und gelangt in eine Datei namens VT.INI im Verzeichnis der VREQxxx.VTD. Diese Datei ist für die künftige Verwendung von allen h#s-Videotext-Programmen vorgesehen (auch für DOS- und UNIX-Programme).

Mit diesem Programm ist es direkt möglich, eine bestimmte Seite anzufordern, d.h. VTGRAB weist den Videotextdekoder explizit zum Empfang der vorgegebenen Seite an. (Das kostet einen der Empfangskanäle des SAA5246-Chips für den automatischen Empfang.)
Dazu folgende Vorgehensweise:
*	Eine Zeile rechts auswählen (üblicherweise die oberste), deren Feld "Request vom Client, /ACK vom Server" nicht markiert ist
*	Gewünschte Seitennummer in das Editierfeld "Seite (BCD)" eintragen
*	Ist eine bestimmte Unterseite gewünscht, Unterseitennummer (BCD) eintragen und das Feld "Unterseitennummer egal" deaktivieren
*	"Automatisch lesen" und "Automatisch schreiben" einschalten
*	"Request vom Client, /ACK vom Server" einschalten
Damit beginnt die Suche nach dieser Seite. Hat VTGRAB.COM diese gefunden, löscht es das zuletzt gesetzte Bit, welches VTGWATCH durch Polling erfaßt, so darstellt und mit einem Pieps quittiert.

Die Angaben "FBAS-Qualität" unt "Text-Qualität" werden von VTGRAB noch nicht aktualisiert und sind deshalb z.Z. immer Null.

Der Schalter "Prüfen" ist noch außer Funktion. Er soll einmal neu einlesen und nur veränderte Felder markieren.

Die Dialogressourcen (ja, im deutschen mit zwei "s"!) haben das Stilbit "WS_3DLOOK" (=4) gesetzt, welches unter Windows95 und NT 4.0 für einen grauen Hintergrund sorgt; die Fenster passen so besser in die neue Windows-Umgebung hinein. (Der Zeichensatz bleibt allerdings weiterhin groß und fett.)

#$+K Dialogelemente
Das Menü "Einstellungen" beinhaltet 3 Menüpunkte:
*	Datei auswählen
Eine neue VREQxxx.VTD-Datei auswählen (exakter Dateiname nicht zwingend).
*	Aktualisierung
Das Zeitintervall einstellen sowie die Option, VREQxxx.VTD ständig offen zu halten
*	Konfiguration speichern
Zeitintervall und Zustand der Automatikfunktionen (lesen und schreiben) in einer VT.INI speichern

Das Hauptfenster, eine riesiges Dialogfenster, stellt den Inhalt der VREQxxx.VTD "auf einem Blick" dar und versieht die einzelnen Bits mit ggf. umschaltbaren Hilfetexten. Müßig, hier auf jedes einzelne Element einzugehen...

#$+K Kommandozeile
VTGWATCH akzeptiert genau ein Kommandozeilen-Argument: die Angabe des Dateinamens der darzustellenden VREQxxx.VTD mit Pfad. Ansonsten verwendet das Programm "\\TOASTER_105\D_TOA\VT\VREQ100.VTD", die Vorgabe beim Autor.

#$K+ Fehlermeldungen
Runtime Error xxx: Wer Borland Pascal installiert hat, kann sich ja auf die Fehlersuche machen :-)