1 Christian Kracke, 08.10.2001, Version 1.4 Micrologica Communication Center ® PSI Tools Christian Kracke

1Christian Kracke, 08.10.2001, Version 1.4

Micrologica Communication Center ®

PSI

Tools

Christian Kracke


Inhalt (1/2)

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)

PSI - Debug - Window (Windows)

– PSI-Prozesse Trace-Meldungen anzeigen

– Trace-Klassen

– Trace-Klasse ändern

– Trace-Optionen

PSI - Spy - Window (Windows)

– PSI-Event anzeigen

– Spy-Optionen


Inhalt (2/2)

PSI-Console (NetWare)

– 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

PRB-Information (NetWare)

PSI-Info-Manager für UNIX– PSI-Prozesse beenden

– Trace-Funktionen


PSI - Information - Manager (1/7)

Der PSI - Information - Manager ist ein Windows Tool.

Es ist für Win32 (Windows 9x, ME, NT, 2000) und für Win16 (Windows 3.x, WfW) verfügbar.

Programmname ist "psi_info.exe

Das Programm liegt standardmäßig im Verzeichnis BIN32 (32 Bit) bzw. BIN (16 Bit)



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” !



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



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 imPSI - Debug - Window

– Anzeige der Public - IDs der Prozesse



Beispiel eines PSI IPC-Pools Dumps (nur 32 Bit):



Beenden eines bestimmten PSI - Prozesses

– über Menüpunkt “End Process”

– Eingabe der Process - ID (Tastatur oder Dropdown - Liste)

Anzeige der Public - ID aktiver Prozesse (nur 16 Bit)



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 (VisualBasic - Interface), falls aktiv

• alle PSI - Prozesse

– (siehe auch Abschnitt “PSI - Debug - Window”)


PSI - Debug - Window: Funktionen

Trace - Ausgaben der PSI - Prozesse in ein Trace - Fenster schreiben

Inhalt des Trace - Fensters bearbeiten

Ändern der globalen Trace - Klasse

Ändern der lokalen Trace - Klasse eines einzelnen PSI - Prozesses

Datum / Zeit - Stempel zu jeder Ausgabe aktivieren/deaktivieren

Trace - Daten gleichzeitig in eine Datei schreiben

Trace - Option für begrenzte Trace - Datei


PSI - Debug - Window: PSI - Prozesse tracen

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 BIN32 (für 32 Bit PSI) bzw.BIN (für 16 Bit PSI)


PSI - Debug - Window: Trace - Fenster bearbeiten (1/3)

Speichern des Fensterinhalts in einer Datei

Aktuelle Einstellungen speichern (Achtung: lokale Trace - Klassen werden nicht gespeichert!)

System-Priority des PSI – Debug - Windows



Kopieren des markierten Fensterinhalts in der Zwischenablage

Löschen des gesamten Fensterinhalts

Selektieren des gesamten Fensterinhalts


Ausgabe der Trace - Meldungen einstellen:

– Ausgabe ins Debug-Fenster

– Keine Ausgabe

– Ausgabe in Debug-Fenster und Datei

– Ausgabe nur in Datei

Trace - Fenster ständig in den Vordergrund holen



PSI - Debug - Window: Trace - Klassen

PSI - Prozesse können mit einer eigenen lokalen Trace - Klasse arbeiten oder die globale Trace - Klasse benutzen:

– NML (0): Nur Meldungen der Trace - Klasse NML werden ausgegeben.

– FAIL (1): Nur Meldungen der Trace - Klassen FAIL und NML werden ausgegeben.

– EVT (2): Alle Meldungen der Trace - Klasse TRC werden nicht beachtet.

– TRC (3): Alle Trace-Meldungen werden ausgegeben.

– No Output 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.


PSI - Debug - Window: Trace - Klassen

Ä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.


PSI - Debug - Window: Trace - Klasse ändern

Ä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)


PSI - Debug - Window:Trace - Optionen (1/2)

„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").


PSI - Debug - Window: Trace - Optionen (2/2)

"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.)

"Time Stamp On":– Datums-/Uhrzeitausgabe bei jeder Trace - Ausgabe vor der Trace - Meldung.


PSI - Spy - Window: Funktionen

PSI - Events von PSI - Prozessen in ein Trace - Fenster schreiben

Inhalt des Trace - Fensters bearbeiten

Einstellen des zu überwachenden Prozesses

Einstellen der zu überwachenden Event - Kommandos

Ausgabe der Event - Daten zu jedem Event aktivieren/deaktivieren

Datum / Zeit - Stempel zu jeder Ausgabe aktivieren/deaktivieren

Trace - Daten gleichzeitig in eine Datei schreiben


PSI - Spy - Window: PSI - Prozeß - Events tracen

Das PSI - Spy - Window dient zum Tracen von PSI - Prozeß - Events Das Programm - Modul heißt "psispy.exe" und liegt standardmäßig

im Verzeichnis BIN32 (für 32 Bit PSI) bzw.BIN (für 16 Bit PSI)


PSI - Spy - Window: Spy - Fenster bearbeiten (1/3)

Speichern des Fensterinhalts in einer Datei

Beenden des PSI - Spy



Kopieren des markierten Fensterinhalts in der Zwischenablage

Löschen des gesamten Fensterinhalts

Selektieren des gesamten Fensterinhalts


Ausgabe der Event - Daten einstellen:

– Ausgabe ins Spy-Fenster

– Keine Ausgabe (auch der Datei-Trace ist ausgeschaltet)

Trace - Fenster ständig in den Vordergrund holen



PSI - Spy - Window: Trace – Optionen (1/4)

Einstellen des Trace - Modus:

– Alle PSI – Events von allen PSI – Prozessen werden aufgezeichnet.

– Die Aufzeichnung von PSI-Events wird deaktiviert.



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.



"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")



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.


PSI - Console: Starten und Beenden

PSI - Console läuft auf dem Server unter NetWare

Starten: "load psicon" auf der System-Console

Beenden:

– "unload psicon" auf der System-Console

– oder ESC-Taste im Hauptmenü


PSI - Console: Funktionen

Ä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)


PSI - Console: Ändern der globalen LOG - Klasse

Auswahl der neuen Klasse Anzeige der aktuellen Klasse in der Statuszeile


PSI - Console: Ändern der lokalen LOG-Klasse eines Prozesses

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)


PSI - Console: Stoppen eines PSI - Prozesses

Auswahl der Prozeß-ID Ja/Nein - Abfrage bestätigen


PSI - Console: Stoppen aller PSI - Prozesse

Ja/Nein - Abfrage bestätigen Achtung: Hierdurch werden nicht alle Library-NLMs entladen wie

beim Aufruf von "mccstop.ncf"!


PSI - Console: Ändern der Trace - Optionen

Stoppen/Starten der Trace - Funktionalität

Starten und Stoppen des Schreibens der Trace - Daten in eine Datei

Trace - Datei löschen


PSI - Console: Ändern der Trace - Optionen

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.

Pfad und Name der Trace-Datei


PRB - Information (1/3)

Das Process - Request - Broker - Informations - Tool ist ein NetWare - Commandline - Programm.

Systemaufruf von "load prbinfo -h" auf der System - Console zeigt eine Liste der Parameter an:

– List Public Processes : -p0x<domain> <-tpath>

– List all Sessions : -s0x<domain> <-tpath>

– Write Dump of Broker : -d0x<domain> -n<history counter> <-tpath>

Angabe des Domain - Level– Der Domain - Parameter wird als BIT - Feld interpretiert.

• 0x01 = Domain - Level 1



• 0x03 = Domain - Level 1 und 2

• 0x07 = 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



Durch den Datei - Trace - Parameter wird die Datei prbinfo.trc im angegeben Pfad angelegt

Informationen zu einem Public - Prozeß:– Public - Prozeß - ID

– Session - Nummer, über die er Angemeldet ist

– Bereichs - Kennung des lokalen PSI - Bereichs

– Netzwerk - Protokoll

Informationen zu einer Session:– 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.



Beispiele:– load prbinfo -p0x01 -tmcc:/netware/: zeigt alle Public-Prozesse des Domain - Level 1 an.

– load prbinfo -s0x03 -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.


PSI - Info - Manager (UNIX)

Das Programm 'xpsiinfo' ist eine Motif - Anwendung

Anzeige aller aktiven PSI - Prozesse

Anzeige der globalen Trace - Klasse


PSI - Info - Manager (UNIX) Beenden aller PSI - Prozesse Ändern der lokalen Trace - Klasse

eines bestimmten PSI - Prozesses

Beenden einzelner PSI - Prozesse Ändern der globalen Trace -

Klasse

Documents

1 Christian Kracke, 08.10.2001, Version 1.4 Micrologica Communication Center ® PSI Tools Christian Kracke