Überwachungsprogramm msprot
Sie können das Programm msprot verwenden, um den Message-Server auf Betriebssystemebene zu überwachen. Das Programm verbindet sich mit dem Message-Server und protokolliert alle Anmeldungen, Abmeldung und Statusänderungen der angemeldeten Applikationsserver-Instanzen.
Das Programm msprot kann auch in eigene Skripte zur Überprüfung des Message-Servers eingebunden werden. Das Programm liefert folgende Rückgabewerte:
|
Wert |
Bedeutung |
|---|---|
|
0 |
Das Programm ist ohne Fehler durchgelaufen |
|
1 |
Fehlende oder ungültige Parameter auf der Kommandozeile |
|
2 |
Der Rechnername, auf dem der Message-Server läuft ( rdisp/mshost), konnte aus dem Profil nicht ermittelt werden oder es wurde ein ungültiges Profil angegeben. |
|
3 |
Der Servicename des Message Servers ( sapms<SID>) konnte aus dem Profil nicht ermittelt werden oder es wurde ein ungültiges Profil angegeben. |
|
4 |
Die Anmeldung am Message-Server ist misslungen: Entweder wurden falsche Verbindungsdaten angegeben oder der Message-Server läuft momentan nicht. |
|
5 |
Eine Anfrage (zum Empfangen von Änderungen in der Serverliste) an den Message-Server ist misslungen: Der Message-Server wurde beendet oder es liegt ein Netzwerkproblem vor. |
|
6 |
Holen der Liste vom Message-Server misslungen. Der Message-Server wurde beendet oder es liegt ein Netzwerkproblem vor. |
|
7 |
Die Verbindung zum Message-Server wurde abgebrochen. Der Message-Server wurde beendet oder es liegt ein Netzwerkproblem vor. |
Weitere Informationen über eventuelle Fehler finden Sie in der Datei dev_msprot.
Sie können das Programm msprot vom Service-Marktplatz holen. Das Programm kann aber auch mit Message-Servern aus älteren Releases benutzt werden.
Geben Sie msprot ohne Parameter ein, so erhalten Sie die Liste der möglichen Optionen:
|
SAP Message Server Protocol Program, Version 1.2 (built: Aug 12 2007 09:24:00) msprot - connect to message server, get the server list and display all changes in the server list refer to CSN note 636938 for further details usage: msprot [ -a | -t | -l | -k <secs> | -n <secs> ] name=<SID> | pf=<profile> | -mshost host -msserv service -a display all (ip/servno) -t display time -k <secs> send keepalive after n seconds -n <secs> timeout in seconds for net calls (default blocking) -r <secs> stop program after n seconds -l list server and exit (ignore -k and -r option) |
Beim Aufruf von msprot geben Sie dem Programm die notwendige Information, um sich mit dem Message-Server zu verbinden. Hierbei haben Sie folgende Möglichkeiten:
-
Angabe der SID (Option name=<SID>); die benötigten Informationen (Rechnername und Service) werden aus den Profiledateien der Applikationnsserver-Instanz geholt
-
Angabe der Profildatei (Option pf=<profile>); die benötigten Informationen werden ebenfalls aus den Profiledateien der Web AS-Instanz geholt
-
Direkte Angabe des Rechnernamens und der Servicenamens oder Portnummer des Message-Servers (Option -mshost host -msserv service).
Wenn Sie keine zusätzliche Option angeben, verbindet sich das Programm msprot an den Message-Server und protokolliert alle Anmeldungen, Abmeldung und Statusänderungen der Web AS-Instanzen. Ein Beispiel finden Sie unten.
Hierbei haben die Spalten folgende Bedeutung:
-
Die Spalte INFO bezeichnet den Typ der darauffolgenden Information.
LIST steht vor den Applikationsservern, die nach dem Start von msprot ausgegeben werden.
ADD bzw. SUB bedeutet, dass ein Applikationsserver neu dazukam bzw. weggenommen wurde, während msprot schon lief.
MOD bezeichnet eine Modusänderung des Applikationsservers, z.B. von STARTING auf RUNNING.
-
Die anderen Spalten entsprechen denen in der Übersicht SAP Applikationsserver (AS ABAP Transaktion SM51): Instanzname, Rechnername, Dispatcherport, Status und die angebotenen Dienste.
|
Parameter |
Bedeutung |
|---|---|
|
-t |
Zeigt die jeweilige Zeit an |
|
-l |
Nach Ausgabe der Serverliste beendet sich das Programm. |
|
-a |
Zusätzliche Ausgabe der Portnummer |
|
-n <secs> |
Maximale Zeitdauer für die Netzwerkaufrufe (Standard ist blockierend) |
|
-k <secs> |
Nach der angegeben Anzahl der Sekunden wird eine Nachricht zum Message-Server gesendet. Damit kann überprüft werden, ob der Message-Server noch lebt. Standardmäßig werden keine solche Nachrichten an den Message-Server gesendet. |
|
-r <secs> |
Das Programm beendet sich nach der angegebenen Anzahl von Sekunden. Standardmäßig beendet sich das Programm nur, wenn es zu einem Fehler kommt. Das ist in der Regel dann, wenn der Message-Server beendet wird. |
|
TRACE=2 |
Mit dieser Option kann der Trace-Level (zur Problemanalyse) für das Programm erhöht werden. In der Datei dev_msprot sind dann ausführliche Informationen zu finden. |
Sie geben msprot name=<SID> ein und erhalten folgende Ausgabe, die immer weiter fortgesetzt wird.
|
INFO CLIENT-NAME HOST SERVICE (NET) STAT SERVICES (SAP) ---------------------------------------------------------------------- LIST binm_BIN_53 ls0347 sapdp53 RUNNING DIA UPD SPO BTC LIST p195_BIN_53 p195 sapdp53 RUNNING DIA ICMAN ADD ls0301_BIN_98 ls0301 sapdp98 STARTING DIA ICMAN MOD ls0301_BIN_98 ls0301 sapdp98 STARTING DIA ICMAN MOD ls0301_BIN_98 ls0301 sapdp98 RUNNING DIA ICMAN SUB ls0301_BIN_98 ls0301 sapdp98 STOP DIA ICMAN |
Zunächst wird die aktuelle Liste der Applikationsserver-Instanzen ausgegeben, dies sind 2 Instanzen. Dann meldet sich der Applikationsserver mit dem Namen ls0301_BIN_98 beim Message Server an und ändert seinen internen Zustand (d.h. sendet seine IP-Adresse zum Message Server und ändert seinen Zustand von STARTING nach RUNNING). Anschließend wird dieser Applikationsserver wieder beendet und er meldet sich beim Message-Server ab.