ServiceManager

-c

Durchzuführender Befehl.
Dieser Parameter muss immer angegeben werden.

GET_PROCESS_LIST

Liste aller Dienste, die zur ServiceManager-Umgebung auf einem Computer gehören, mit verfügbaren Informationen anfordern.

START_PROCESS

Dienst starten.

STOP_PROCESS

Dienst beenden.

-h

Rechner
Dieser Parameter muss immer angegeben werden.

Rechnername

Name des Rechners, auf dem der ServiceManager bedient werden soll.

Es können auch ferne Rechner angegeben werden. Dieser Rechner muss vom aufrufenden Rechner aus erreichbar sein. Der Benutzer muss für den Zugriff auf die Dienste des fernen Rechners berechtigt sein.

Portnummer

Unter UNIX muss zusätzlich auch die Portnummer des ServiceManagers angegeben werden.

-n

ServiceManager-Umgebung.
Dieser Parameter muss immer angegeben werden.

Phrase

Name der ServiceManager-Umgebung, welche die verschiedenen AE-Dienste auf einem Rechner zusammenfasst. Im Dialogprogramm des ServiceManagers wird diese als Phrase bezeichnet.

-s

Dienst.
Parameter muss mit Ausnahme von GET_PROCESS_LIST immer angegeben werden.

Name des Dienstes

Angabe der Bezeichnung des Dienstes.

Dieser ist an folgenden Stellen ersichtlich:

• im ServiceManager-Dialogprogramm in der Spalte "Service"
• in der Definitionsdatei Phrase.SMD
• in der Ausgabe des Aufrufs GET_PROCESS_LIST

Da der Name des Dienstes auch Leerzeichen enthalten kann, sollte er immer in doppelten Hochkommata stehen.

-m

Ende-Modus.
Parameter ist optional für STOP_PROCESS.

Stopmodus

Art, wie der Dienst beendet werden soll.

Erlaubte Werte: "C" (Standardwert), "S", "A"
"C" = Close. Der Dienst wird normal beendet.
"S" = Shutdown. Der Dienst beendet sich unabhängig von laufenden Tätigkeiten unverzüglich.
"A" = Abnormally. Der Dienst wird durch einen Systemaufruf (Kill) sofort vom ServiceManager beendet. Dieser Befehl sollte nur verwendet werden, wenn die Versuche des Dienstes sich selbst zu beenden, nicht erfolgreich waren.

-p

Passwort.
Parameter ist optional für START_PROCESS und STOP_PROCESS. Informationen über die Verschlüsselung von Passwörtern, siehe Passwörter verschlüsseln.

Kennwort

Passwort für die Berechtigung zum Starten und Stoppen eines Dienstes.

Startmodus von Server-Arbeitsprozessen (WPs)

Die möglichen Werte des Parameters -sm sind abhängig von Definition der Dienste in der SMD-Konfigurationsdatei des ServiceManagers.
Damit dem WP beim Start ein bestimmter Startmodus übergeben werden kann, sind in der SMD-Datei bei jedem DEFINE eines WP-Dienstes die Einstellungen START1=, START2=, START3= ... zu setzen. Die mitgelieferte SMD-Datei UC4.SMD enthält einige Beispieldefinitionen.

Beispiel: Definition eines WP-Dienstes in SMD-Datei (inklusive Variablen):

VAR SRV_STARTPATH;*OWN\..\..\Server\bin
VAR WP_STARTCMD;*SRV_STARTPATH\UCsrvwp.exe *SRV_STARTPATH\ucsrv.ini -svc%port%
VAR WP_STARTCMD_COLD;*WP_STARTCMD -parm"StartMode=Cold"
VAR WP_STARTCMD_STOP;*WP_STARTCMD -parm"SystemStop=Yes"
VAR WP_STARTCMD_COLDSTOP;*WP_STARTCMD -parm"StartMode=Cold;SystemStop=Yes"

DEFINE UC4 WP2;*WP_STARTCMD;*SRV_STARTPATH;START1=(Coldstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Coldstart with Systemstop,*WP_STARTCMD_COLDSTOP)

Damit gibt es für diesen WP-Dienst folgende mögliche Werte für den Parameter -sm

"Coldstart" = Kaltstart-Modus
"Systemstop" = Normaler Start. System wird zusätzlich gestoppt.
"Coldstart with Systemstop" = Kaltstart inklusive System-Stopp.

Service

Bezeichnung des Dienstes.

Status

Status des Dienstes.
"R" = Running. Dienst ist aktiv.
"S" = Stopped. Dienst beendet.

ProcID

Prozessnummer eines Dienstes
Die Information wird nur bei aktiven Diensten (State = R) ausgegeben.

Starttime

Startzeitpunkt des Dienstes.
Format: "JJJJ-MM-TT HH:MM"
Die Information wird nur bei aktiven Diensten (State = R) ausgegeben.

Laufzeit

Laufzeit des Dienstes.
Format: "DD/HH:MM"
Die Information wird nur bei aktiven Diensten (State = R) ausgegeben.

CPU Time

Vom Dienst verbrauchte CPU-Zeit.
Format: "DD/HH:MM:SS:HS"
HS stehen für Hundertstelsekunden.
Die Information wird nur bei aktiven Diensten (State = R) ausgegeben.

0

Die Anweisung wurde ohne Fehler ausgeführt.

1

Die Anweisung wurde fehlerhaft eingegeben.

2

Auf dem angegebenen Rechner wurde kein aktiver ServiceManager gefunden.

Mögliche Ursache:
Name des Rechners wurde nicht angegeben oder es ist kein ServiceManager auf diesem Rechner aktiv.

3

Der ServiceManager reagierte unerwartet auf die Anweisung.

Mögliche Ursache:
Die Version des ServiceManagers ist nicht aktuell.

4

Bei der Verbindung zum ServiceManager sind Fehler aufgetreten.

5

Die angegebene ServiceManager-Umgebung ist auf dem Rechner nicht vorhanden.

Mögliche Ursache:
ServiceManager mit der angegebenen ServiceManager-Umgebung nicht installiert oder gestartet.