Micrologica Communication Center PSI Tools Christian Kracke 08

Micrologica Communication Center ® PSI Tools Christian Kracke, 08. 10. 2001, Version 1. 4 1

Inhalt (1/2) n PSI - Information - Manager (Windows) – Anzeige des aktuellen Zustands des PSI – Beenden eines bestimmten PSI-Prozesses – Anzeige der Public-ID aktiver Prozesse (nur 16 Bit) – Dump aller laufenden PSI-Programme (nur 16 Bit) – Dump des PSI IPC-Pools (nur 32 Bit) n PSI - Debug - Window (Windows) – PSI-Prozesse Trace-Meldungen anzeigen – Trace-Klasse ändern – Trace-Optionen n PSI - Spy - Window (Windows) – PSI-Event anzeigen – Spy-Optionen Christian Kracke, 08. 10. 2001, Version 1. 4 2

Inhalt (2/2) n PSI-Console (Net. Ware) – Starten und Beenden – Ändern der globalen LOG-Klasse – Ändern der lokalen LOG-Klasse eines Prozesses – Stoppen eines PSI-Prozesses – Stoppen aller PSI-Prozesse – Ändern der Trace-Optionen n PRB-Information (Net. Ware) n PSI-Info-Manager für UNIX – PSI-Prozesse beenden – Trace-Funktionen Christian Kracke, 08. 10. 2001, Version 1. 4 3

PSI - Information - Manager (1/7) n n Der PSI - Information - Manager ist ein Windows Tool. Es ist für Win 32 (Windows 9 x, ME, NT, 2000) und für Win 16 (Windows 3. x, Wf. W) verfügbar. Programmname ist "psi_info. exe Das Programm liegt standardmäßig im Verzeichnis BIN 32 (32 Bit) bzw. BIN (16 Bit) Christian Kracke, 08. 10. 2001, Version 1. 4 4

PSI - Information - Manager (2/7) n Anzeige des aktuellen Zustands des PSI: – Anzeige der notwendigen Prozesse und deren Status: – “not active”: Prozeß, der nach INI-File. Angabe laufen muß, aber noch nicht gestartet ist. – “active”: Prozeß gestartet, aber noch nicht laufend. – “running”: Prozeß laufend. – “stopped”: Prozeß beendet sich – Achtung: Solange Prozesse noch nicht gestartet sind (Zustand “not active”), wechselt kein Prozeß in den Status “running” ! Christian Kracke, 08. 10. 2001, Version 1. 4 5

PSI - Information - Manager (3/7) n Das Menü “PSI - Manager” (32 Bit): – Starten des PSI (zur Zeit nicht verfügbar) – Beenden aller PSI -Prozesse (incl. Agenten- und Gruppenmonitore, Anrufpläne, PRB) – Beenden eines bestimmten PSI - Prozesses – Dump des PSI IPC-Pools – Refresh des PSI IPC-Pools Christian Kracke, 08. 10. 2001, Version 1. 4 6

PSI - Information - Manager (4/7) n Das Menü “PSI - Manager” (16 Bit): – Starten des PSI (zur Zeit nicht verfügbar) – Beenden aller PSI -Prozesse (incl. Agenten- und Gruppenmonitore, Anrufpläne, PRB) – Beenden eines bestimmten PSI - Prozesses – Dump aller aktiven PSI - Programme im PSI - Debug - Window – Anzeige der Public - IDs der Prozesse Christian Kracke, 08. 10. 2001, Version 1. 4 7

PSI - Information - Manager (5/7) n Beispiel eines PSI IPC-Pools Dumps (nur 32 Bit): Christian Kracke, 08. 10. 2001, Version 1. 4 8

PSI - Information - Manager (6/7) n Beenden eines bestimmten PSI Prozesses – über Menüpunkt “End Process” – Eingabe der Process - ID (Tastatur oder Dropdown - Liste) n Anzeige der Public - ID aktiver Prozesse (nur 16 Bit) Christian Kracke, 08. 10. 2001, Version 1. 4 9

PSI - Information - Manager (7/7) n Dump aller laufenden PSI - Programme (nur 16 Bit): – Menüpunkt “PSI File-Info” – Schreibt Dump aller aktiven PSI - Module mit Erstellungsdatum, Pfadangabe und Größe der Datei in das PSI - Debug - Window: • aktuelle PSI - DLL • PSI - Debug - Window • PSI - Information - Manager • Status des PSI - Exception - Control - Programms • PSI - VBX (Visual. Basic - Interface), falls aktiv • alle PSI - Prozesse – (siehe auch Abschnitt “PSI - Debug - Window”) Christian Kracke, 08. 10. 2001, Version 1. 4 10

PSI - Debug - Window: Funktionen n Trace - Ausgaben der PSI - Prozesse in ein Trace - Fenster schreiben n Inhalt des Trace - Fensters bearbeiten n Ändern der globalen Trace - Klasse n Ändern der lokalen Trace - Klasse eines einzelnen PSI - Prozesses n Datum / Zeit - Stempel zu jeder Ausgabe aktivieren/deaktivieren n Trace - Daten gleichzeitig in eine Datei schreiben n Trace - Option für begrenzte Trace - Datei Christian Kracke, 08. 10. 2001, Version 1. 4 11

PSI - Debug - Window: PSI - Prozesse tracen n n Das PSI - Debug - Window dient zum Erstellen von Traces der PSI - Prozesse Das Programm - Modul heißt "psidebug. exe" und liegt standardmäßig im Verzeichnis BIN 32 (für 32 Bit PSI) bzw. BIN (für 16 Bit PSI) Christian Kracke, 08. 10. 2001, Version 1. 4 12

PSI - Debug - Window: Trace - Fenster bearbeiten (1/3) n n n Speichern des Fensterinhalts in einer Datei Aktuelle Einstellungen speichern (Achtung: lokale Trace - Klassen werden nicht gespeichert!) System-Priority des PSI – Debug - Windows Christian Kracke, 08. 10. 2001, Version 1. 4 13

PSI - Debug - Window: Trace - Fenster bearbeiten (2/3) n n n Kopieren des markierten Fensterinhalts in der Zwischenablage Löschen des gesamten Fensterinhalts Selektieren des gesamten Fensterinhalts Christian Kracke, 08. 10. 2001, Version 1. 4 14

PSI - Debug - Window: Trace - Fenster bearbeiten (3/3) n Ausgabe der Trace Meldungen einstellen: – Ausgabe ins Debug-Fenster – Keine Ausgabe – Ausgabe in Debug-Fenster und Datei – Ausgabe nur in Datei n Trace - Fenster ständig in den Vordergrund holen Christian Kracke, 08. 10. 2001, Version 1. 4 15

PSI - Debug - Window: Trace - Klassen n PSI - Prozesse können mit einer eigenen lokalen Trace - Klasse arbeiten oder die globale Trace - Klasse benutzen: – – – n NML (0): FAIL (1): EVT (2): TRC (3): No Output Nur Meldungen der Trace - Klasse NML werden ausgegeben. Nur Meldungen der Trace - Klassen FAIL und NML werden ausgegeben. Alle Meldungen der Trace - Klasse TRC werden nicht beachtet. Alle Trace-Meldungen werden ausgegeben. Diese Auswahl unterbindet alle Traceausgaben von PSI-Prozessen. Ändern der globalen Trace - Klasse: – Alle PSI - Prozesse, die keine lokale Trace - Klasse eingestellt haben, arbeiten mit der globalen Trace Klasse. – Bei Auswahl einer neuen globalen Trace - Klasse wird die aktuelle globale Trace - Klasse angezeigt. Christian Kracke, 08. 10. 2001, Version 1. 4 16

PSI - Debug - Window: Trace - Klassen n Ändern der lokalen Trace – Klasse bei allen aktiven PSI - Prozessen: – Alle zur Zeit aktiven PSI – Prozesse erhalten die ausgewählte Trace – Klasse als lokale Trace - Klasse. – Dadurch arbeitet keiner der zur Zeit aktiven PSI – Prozesse mehr mit der globalen Trace - Klasse. Christian Kracke, 08. 10. 2001, Version 1. 4 17

PSI - Debug - Window: Trace - Klasse ändern n Ändern der lokalen Trace - Klasse: – Jeder PSI - Prozeß kann mit einer nur für ihn gültigen Trace - Klasse arbeiten. – Die lokale Trace - Klasse des Prozesses kann gelöscht werden, so daß die globale Trace - Klasse benutzt wird. – Einstellung der Trace - Parameter des Prozesses: • Angabe der Prozeß - ID • Ein/Ausschalten der lokalen Trace - Klasse • Auswahl der neuen Trace - Klasse • Abfrage der aktuellen lokalen Trace - Klasse (nur bei 16 Bit möglich) Christian Kracke, 08. 10. 2001, Version 1. 4 18

PSI - Debug - Window: Trace - Optionen (1/2) n „Set File Parameter": – Trace - Daten in Datei schreiben • Schreiben an das Ende einer Trace -Datei unbegrenzter Größe • Schreiben an das Ende einer Trace -Datei begrenzter Größe. Beim Erreichen der maximalen Dateigröße wird die Datei in "*. bak" umbenannt, und es wird eine neue Trace - Datei angelegt. – Angabe zum Rücksetzen des Inhalts der Trace - Datei. – Angabe des Namen der Trace -Datei mit Pfad. – Angabe der maximalen Größe der Trace Datei in Bytes (nur bei "Trace to Limited File"). Christian Kracke, 08. 10. 2001, Version 1. 4 19

PSI - Debug - Window: Trace - Optionen (2/2) n "Direct - Trace": – Aktiviert: Jede Meldung wird sofort in das Ausgabefenster geschrieben. (Verzögerung der Abläufe; der PC kann nur noch mit Trace - Ausgaben beschäftigt sein und reagiert nicht mehr auf externe Eingaben. ) – Deaktiviert: Alle Trace - Meldungen werden in einem temporären Puffer zwischengespeichert und zwischendurch in das Ausgabefenster geschrieben. (Bei extrem zahlreichen Ausgaben Überlauf des temporären Puffers möglich; Trace - Meldungen können verloren gehen. ) n "Time Stamp On": – Datums-/Uhrzeitausgabe bei jeder Trace - Ausgabe vor der Trace - Meldung. Christian Kracke, 08. 10. 2001, Version 1. 4 20

PSI - Spy - Window: Funktionen n PSI - Events von PSI - Prozessen in ein Trace - Fenster schreiben n Inhalt des Trace - Fensters bearbeiten n Einstellen des zu überwachenden Prozesses n Einstellen der zu überwachenden Event - Kommandos n Ausgabe der Event - Daten zu jedem Event aktivieren/deaktivieren n Datum / Zeit - Stempel zu jeder Ausgabe aktivieren/deaktivieren n Trace - Daten gleichzeitig in eine Datei schreiben Christian Kracke, 08. 10. 2001, Version 1. 4 21

PSI - Spy - Window: PSI - Prozeß - Events tracen n n Das PSI - Spy - Window dient zum Tracen von PSI - Prozeß - Events Das Programm - Modul heißt "psispy. exe" und liegt standardmäßig im Verzeichnis BIN 32 (für 32 Bit PSI) bzw. BIN (für 16 Bit PSI) Christian Kracke, 08. 10. 2001, Version 1. 4 22

PSI - Spy - Window: Spy - Fenster bearbeiten (1/3) n n Speichern des Fensterinhalts in einer Datei Beenden des PSI - Spy Christian Kracke, 08. 10. 2001, Version 1. 4 23

PSI - Spy - Window: Spy - Fenster bearbeiten (2/3) n n n Kopieren des markierten Fensterinhalts in der Zwischenablage Löschen des gesamten Fensterinhalts Selektieren des gesamten Fensterinhalts Christian Kracke, 08. 10. 2001, Version 1. 4 24

PSI - Spy - Window: Spy - Fenster bearbeiten (3/3) n Ausgabe der Event - Daten einstellen: – Ausgabe ins Spy-Fenster – Keine Ausgabe (auch der Datei. Trace ist ausgeschaltet) n Trace - Fenster ständig in den Vordergrund holen Christian Kracke, 08. 10. 2001, Version 1. 4 25

PSI - Spy - Window: Trace – Optionen (1/4) n Einstellen des Trace - Modus: – Alle PSI – Events von allen PSI – Prozessen werden aufgezeichnet. – Die Aufzeichnung von PSI-Events wird deaktiviert. Christian Kracke, 08. 10. 2001, Version 1. 4 26

PSI - Spy - Window: Trace – Optionen (2/4) n Einstellen des Trace - Modus: – Auswahl eines PSI – Processes, dessen PSI - Events aufgezeichnet werden sollen (die Auswahl von ‘All Processes‘ wählt alle Prozesse aus). – Festlegen ob alle oder nur bestimmte PSI – Event – Kommandos aufgezeichnet werden sollen. – Festlegen ob nur gesendete oder nur empfangene PSI - Events oder beides aufgezeichnet werden soll. Christian Kracke, 08. 10. 2001, Version 1. 4 27

PSI - Spy - Window: Trace – Optionen (3/4) n "Put to File": – Event - Trace in Datei schreiben • Ausschalten des Datei - Traces • Schreiben an das Ende einer Trace -Datei unbegrenzter Größe • Schreiben an das Ende einer Trace -Datei begrenzter Größe. Beim Erreichen der maximalen Dateigröße wird die Datei in "*. bak" umbenannt, und es wird eine neue Trace - Datei angelegt. – Angabe zum Rücksetzen des Inhalts der Trace - Datei. – Angabe des Namen der Trace -Datei mit Pfad – Angabe der maximalen Größe der Trace Datei (nur bei "Trace to Limited File") Christian Kracke, 08. 10. 2001, Version 1. 4 28

PSI - Spy - Window: Trace – Optionen (4/4) n Weitere Trace - Optionen: – Direkte (langsame) oder indirekte (schnellere) Trace-Ausgabe. Beim indrekten Modus können Events im Trace verloren gehen. – Die Aufzeichnung von PSI-Events inklusive der ersten 256 User-Bytes aktivieren oder deaktivieren. – Festlegen ob nur gesendete oder nur empfangene PSI - Events oder beides aufgezeichnet werden soll. Christian Kracke, 08. 10. 2001, Version 1. 4 29

PSI - Console: Starten und Beenden n PSI - Console läuft auf dem Server unter Net. Ware n Starten: "load psicon" auf der System-Console n Beenden: – "unload psicon" auf der System-Console – oder ESC-Taste im Hauptmenü Christian Kracke, 08. 10. 2001, Version 1. 4 30

PSI - Console: Funktionen n n Ändern der globalen LOG - Klasse des PSI Ändern der lokalen LOG - Klasse eines PSI - Prozesses Stoppen eines PSI Prozesses Stoppen aller PSI Prozesse Ändern der Trace Optionen (Hauptfenster) Christian Kracke, 08. 10. 2001, Version 1. 4 31

PSI - Console: Ändern der globalen LOG - Klasse n n Auswahl der neuen Klasse Anzeige der aktuellen Klasse in der Statuszeile Christian Kracke, 08. 10. 2001, Version 1. 4 32

PSI - Console: Ändern der lokalen LOG-Klasse eines Prozesses n n n Auswahl des Prozesses aus der Liste der Prozeß-IDs Anzeige der aktuellen LOG - Klasse des Prozesses in der Statuszeile Menü zur Auswahl der neuen lokalen LOG - Klasse oder Rücksetzen auf globale LOG - Klasse (Reset Local) Christian Kracke, 08. 10. 2001, Version 1. 4 33

PSI - Console: Stoppen eines PSI - Prozesses n n Auswahl der Prozeß-ID Ja/Nein - Abfrage bestätigen Christian Kracke, 08. 10. 2001, Version 1. 4 34

PSI - Console: Stoppen aller PSI - Prozesse n n Ja/Nein - Abfrage bestätigen Achtung: Hierdurch werden nicht alle Library-NLMs entladen wie beim Aufruf von "mccstop. ncf"! Christian Kracke, 08. 10. 2001, Version 1. 4 35

PSI - Console: Ändern der Trace - Optionen n Stoppen/Starten der Trace - Funktionalität Starten und Stoppen des Schreibens der Trace - Daten in eine Datei Trace - Datei löschen Christian Kracke, 08. 10. 2001, Version 1. 4 36

PSI - Console: Ändern der Trace - Optionen n Maximale Gröβe der Trace - Datei Beim Erreichen der maximalen Dateigröße wird die Datei in "*. bak" umbenannt, und es wird eine neue Trace - Datei angelegt. n Pfad und Name der Trace-Datei Christian Kracke, 08. 10. 2001, Version 1. 4 37

PRB - Information (1/3) n n Das Process - Request - Broker - Informations - Tool ist ein Net. Ware - Commandline - Programm. Systemaufruf von "load prbinfo -h" auf der System - Console zeigt eine Liste der Parameter an: – List Public Processes – List all Sessions – Write Dump of Broker n : : : -p 0 x<domain> -s 0 x<domain> -d 0 x<domain> <-tpath> -n<history counter> <-tpath> Angabe des Domain - Level – Der Domain - Parameter wird als BIT - Feld interpretiert. • 0 x 01 = Domain - Level 1 • 0 x 02 = Domain - Level 2 • 0 x 04 = Domain - Level 3 • 0 x 03 = Domain - Level 1 und 2 • 0 x 07 = Domain - Level 1, 2 und 3 – Domain - Level 1 steht für den Domain - PRB (Central - PRB) und seine Clients – Domain - Level 2 steht für den Interdomain - PRB und seine Clients – Wird bei den Parametern -p, -s und -d kein Domain - Level angegeben, wird als default der Domain Level 1 gewählt Christian Kracke, 08. 10. 2001, Version 1. 4 38

PRB - Information (2/3) n n Durch den Datei - Trace - Parameter wird die Datei prbinfo. trc im angegeben Pfad angelegt Informationen zu einem Public - Prozeß: – – n Informationen zu einer Session: – – n Public - Prozeß - ID Session - Nummer, über die er Angemeldet ist Bereichs - Kennung des lokalen PSI - Bereichs Netzwerk - Protokoll Kanal - Nummer Session - Nummer Netzwerk - Protokoll Netzwerk - Adresse (z. B. IPX - Net, IPX - Node oder IP - Adresse) Dump von Broker-Domainen in Datei schreiben: – Es werden Statistikdaten der Broker mit Informationen zu allen aktiven und beendeten Channel in der Datei "prb_dump. trc" in dem angegeben Pfad geschrieben. Der Inhalt kann bei Micrologica ausgewertet werden. Christian Kracke, 08. 10. 2001, Version 1. 4 39

PRB - Information (3/3) n Beispiele: – load prbinfo -p 0 x 01 -tmcc: /netware/: zeigt alle Public-Prozesse des Domain - Level 1 an. – load prbinfo -s 0 x 03 -tmcc: /netware/: zeigt alle aktiven Sessions der Domain - Level 1 und 2 an. – load prbinfo -s -p -tmcc: /netware/: zeigt alle aktiven Sessions und Public - Prozesse des Domain - Level 1 an (siehe Abbildung). – In allen drei Fällen bewirkt der Parameter -tmcc: /netware/, daß die Daten in die Datei "mcc: /netware/prbinfo. trc" geschrieben werden. Christian Kracke, 08. 10. 2001, Version 1. 4 40

PSI - Info - Manager (UNIX) n n n Das Programm 'xpsiinfo' ist eine Motif - Anwendung Anzeige aller aktiven PSI Prozesse Anzeige der globalen Trace Klasse Christian Kracke, 08. 10. 2001, Version 1. 4 41

PSI - Info - Manager (UNIX) n n Beenden aller PSI - Prozesse Ändern der lokalen Trace - Klasse eines bestimmten PSI - Prozesses Christian Kracke, 08. 10. 2001, Version 1. 4 n n 42 Beenden einzelner PSI - Prozesse Ändern der globalen Trace Klasse