Accellence Technologies GmbH Garbsener Landstr. 10 D-30419 Hannover Hinweise zum Accellence TCP Tester (AccTcpTester.exe) ===================================================== Der TCP Tester von accellence bietet umfangreiche Möglichkeiten, um TCP/IP-Verbindungen zu prüfen. Start: ZIP-Archiv entpacken und AccTcpTester.exe starten. Mit "Listen" wird Empfangsbereitschaft für eintreffende TCP/IP-Verbindungen hergestellt, mit "Connect" wird eine TCP/IP-Verbindung zur Gegenstelle aufgebaut. Somit kann geprüft werden, ob eine TCP/IP-Verbindung von A nach B auf einem bestimmten Port möglich ist. Die Eingabezeile für die IP-Adresse ist eine Combo-Box, in der die IPv4-Adressen aller auf diesem PC verfügbaren Netzwerkadapter zur Auswahl angeboten werden. "Listen" bezieht sich auf (bindet die Sockets an) die hier ausgewählte Netzwerkadresse. In das Texteingabefeld für die zu sendenden Kommandos (links neben "Send") kann man auch TABs als Trennzeichen eingeben. Mit {Shift}+{TAB} kann man wieder zu den anderen Eingabefeldern springen. Der AccTcpTester merkt sich alle eingegebenen Kommandos und bietet diese in einer Combo-Box zur Auswahl an. Diese Liste kann man mit den Schaltflächen links neben dem Texteingabefeld auch speichern und wieder laden. Damit kann man z.B. alle Kommandos, die für AMS_RCP benötigt werden, mit einem Klick aktivieren, ggf. bearbeiten und dann mit "Send" absenden. Die Kommandolisten haben die Dateiendung *.acctcpcmds und können auch z.B. mit Notepad bearbeitet werden. Mit folgenden Kommandozeilenparametern startet die Anwendung gleich mit den gewünschten Voreinstellungen: ip IP-Adresse port TCP-Port protocol z.B. "Echo", "LISA", "MasterMind", "HTTP", "AMS_RCP", ... commands Lädt die Kommandoliste mit dem angegebenen Namen encoding z.B. "UTF-8", "29001", ... zum Speichern in Dateien tcp_encoding z.B. "UTF-8", "29001", ... für die Datenübertragung escaping falls true, werden Escape-Squenzen gemäß C-Syntax interpretiert und angezeigt, um auch Steuerzeichen zu ermöglichen hexdump falls true, werden gesendete und empfangene Daten als hexadezimale Zeichenkette angezeigt data_to_send Daten, die beim Aufbau jeder neuen Verbindung gesendet werden sollen mode z.B. "listen", "autolisten", "multilisten", "connect", "scan" - Im mode "connect" wird die mit ip und port konfigurierte Verbindung nach dem Start automatisch aufgebaut. - Im mode "autolisten" (Checkbox "Auto") wird nach dem Beenden einer Verbindung automatisch wieder der Listen-Mode reaktiviert. - Im mode "multilisten" (Checkbox "Multi") können mehrere Verbindungen parallel angenommen werden. Dabei wird für neu angenommene Verbindungen jeweils das Protokoll und die Codetabelle verwendet, die im Hauptfenster gewählt wurde. Für eigene Protokollimplementierungen können für folgende Ereignisse (Events) Scripts hinterlegt werden: !connection_accepted Eine eingehende Verbindung wurde nach TCP-Listen angenommen --> nun können Daten gesendet werden !connection_connected Eine ausgehende Verbindung wurde von der Gegenseite angenommen --> nun können Daten gesendet werden !connection_established Verbindung wurde aufgebaut; wird sowohl nach !connection_accepted als auch nach !connection_connected aufgerufen !data_received Es sind Daten empfangen worden, die nun ausgewertet werden können !timer_every_second Wird jede Sekunde aufgerufen, solange die Verbindung besteht !connection_closed Die TCP/IP-Verbindung wurde beendet Beschreibung der Scriptsprache --> www.ebues.de/doc/AccParser.pdf Variablen für Protokoll-Implementierungen (Zugriffsmöglichkeiten: R=Read, W=Write): machine_name R Name des PCs, auf dem AccTcpTester läuft protocol RW Auswahl des aktiven Protokolls anhand seines Namens in der Auswahlliste tcp_encoding RW z.B. "UTF-8", "29001", ... time_utc R Stellenwerttreue UTC-Zeit im Format YYYYMMDDhhmmssmil textbox_send RW Text, der im Eingabefeld für das Senden steht tcp_send_data RW Sendet den angebenenen Text mit dem gewählen Encoding an die Gegenstelle tcp_send_hex RW Sendet hexadezimal angegebene Daten im Binärformat new_status RW Ein Statustext, der im Logbuch des AccTcpTesters angezeigt wird tcp_disconnect W Beendet die Verbindung, falls true window_close W Schließt das Anwendungsfenster, das zu dieser Verbindung gehört filename RW Gibt den Dateinamen für nachfolgende Dateioperationen vor file_write RW Schreibt den Text mit dem gewählten Encoding in die Datei file_append RW Hängt den Text mit dem gewählten Encoding an die Datei an Folgende Variablen sind nur im Script !data_received und den daraus aufgerufenen Unterprogrammen verfügbar: tcp_received_data R enthält die empfangenen Daten als Text mit dem gewählten Encoding tcp_received_hex R enthält die empfangenen Daten binär als Hexstring Wählen Sie das gewünschte Protokoll aus der Combo-Box, oder geben Sie dort einen neuen Protokollnamen ein, um ein neues Protokoll anzulegen. Mit dem Button rechts neben der Combobox können Sie die Scripte für dieses Protokoll hinterlegen. Mit dem Button rechts daneben kann der aktuelle Zustand aller Variablen im AccTcpTester angezeigt und fortlaufend überwacht werden. Download der aktuellen Version unter www.ebues.de/tools oder www.ipracc.com/tools 19.05.2022 Hardo Naumann --- eof ---