ServiceManager - Kommandozeilenprogramm (CLI)

Das Kommandozeilenprogramm (UCYBSMCL) ermöglicht es Ihnen, Ihre Dienste über die Stapelverarbeitung zu verwalten.

Dieses Thema beinhaltet Folgendes:

Übersicht

Sie können Dienste starten und beenden sowie eine Liste an Diensten eines Computers in einer ServiceManager-Umgebung aufrufen. Diese Option ist nur für Windows und UNIX verfügbar.

Hinweis: Beim CLI-Programm wird zwischen Groß- und Kleinschreibung unterschieden.

Sie können mit dem ServiceManager eine sichere Verbindung (TLS 1.2) herstellen, aber dennoch nicht sichere Verbindungen zu älteren ServiceManagern unterstützen. Für sichere Verbindungen müssen Sie CAPKI auf demselben Computer installiert haben, auf dem Sie den ServiceManager CLI installiert haben. Wenn Sie eine unsichere Verbindung verwenden, führt der CLI den Befehl zum ServiceManager aus, erstellt aber auch eine Warnmeldung.

Syntax

Windows:

UCYBSMCL [.EXE] -c GET_PROCESS_LIST -h computer name -n phrase

UCYBSMCL [.EXE] -c START_PROCESS -h Computername -n phrase -s Name des Dienstes [-p Passwort]

UCYBSMCL [.EXE] -c STOP_PROCESS -h Computername -n phrase -s Name des Dienstes [-m Stopmodus] [-p Passwort]

UCYBSMCL [.EXE] -c SET_DATA -h Computername -n phrase -s Name des Dienstes -d Eigenschaftswert [-p Passwort]

Unix:

ucybsmcl -c GET_PROCESS_LIST -h computer name:port number -n phrase

ucybsmcl -c START_PROCESS -h Computername:Portnummer -n phrase -s Name des Dienstes [-p Passwort]

ucybsmcl -c STOP_PROCESS -h Computername:Portnummer -n phrase -s Name des Dienstes [-m Stopmodus] [-p Passwort]

ucybsmcl -c SET_DATA -h Computername:Portnummer -n phrase -s Name des Dienstes -d Eigenschaftswert [-p Passwort]

Parameterbeschreibungen

-c-Kommando, der verarbeitet werden soll

Dieser Parameter muss immer angegeben werden.

Zuordnung:
- GET_PROCESS_LIST: Fordert eine Liste aller zu einer ServiceManager-Umgebung gehörenden Dienste auf einem Computer zusammen mit den verfügbaren Informationen an
- START_PROCESS: Startet einen Dienst
- STOP_PROCESS: Stoppt einen Dienst
- SET_DATA: Legt die Eigenschaften eines Dienstes fest
-h-Computer

Dieser Parameter muss immer angegeben werden.

Zuordnung:
- Computername: Name des Computers, auf dem der ServiceManager verwendet wird.
  
  Es kann auch ein Remote-Computer verwendet werden. Dieser Computer muss von dem Computer, der ihn aufruft, aus verfügbar sein. Der Benutzer muss berechtigt sein, auf Dienste auf diesem Remote-Computer zuzugreifen.
- Portnummer: Bei UNIX muss zusätzlich die Portnummer des ServiceManagers angegeben werden.
-n ServiceManager-Umgebung

Dieser Parameter muss immer angegeben werden.

Zuordnung:
- Phrase: Name der ServiceManager-Umgebung, die die verschiedenen AE-Dienste auf einem Computer zusammenfasst/schreibt. Im Dialogprogramm des ServiceManagers wird dies als Phrase bezeichnet.
-s Dienst

Dieser Parameter muss immer angegeben werden, mit der einzigen Ausnahme von GET_PROCESS_LIST.

Zuordnung:
- Name des Dienstes: Angabe des Namens eines Dienstes, d.h.:
  - wird in der Spalte Service des Dialogprogramms angezeigt
  - wird in der Definitionsdatei Phrase.SMD aufgelistet
  - ist in der Ausgabe des Befehls GET_PROCESS_LIST verfügbar
  Da ein Dienstname auch Leerzeichen enthalten kann, sollte er immer in Anführungszeichen eingegeben werden.
-d Eigenschaftswert

Dieser Parameter ist nur für SET_DATA erforderlich.

Zuordnung:
- Zeichenkette für Eigenschaften: Die Zeichenkette hängt von der angegebenen Eigenschaft ab.
  
  Erlaubte Eigenschaftszeichenketten:
  - Kommando
  - StartPfad
  - Benutzername
  - Passwort
  - Domäne
  - Autostart
  - Verzögerung
  Beispiele
  
  ucybsmcl -c SET_DATA -h PC000666 -n Automic -s “RAFTP Agent” -d Command “java -jar -Xrs -Xmx256M ucxjcitx.jar”
  
  ucybsmcl -c SET_DATA -h PC000666 -n Automic -s “RAFTP Agent” -d Autostart 1

-m Endmodus

Dieser Parameter ist optional für STOP_PROCESS.

Zuordnung:
- Stoppmodus: Art und Weise, wie ein Dienst beendet werden soll.
  
  Erlaubte Werte: „C“ (Standardwert), „S“, „A“
  "C" = Schließen. Der Dienst wird normal beendet.
  „S“ = Shutdown. Der Dienst wird sofort gestoppt, unabhängig von laufenden Aufgaben.
  „A“ = Anormal. Der Service wird vom ServiceManager durch einen Systemaufruf (Kill) sofort gestoppt. Verwenden Sie diesen Befehl nur, wenn Versuche des Dienstes, sich selbst zu stoppen, nicht erfolgreich waren.
-p Passwort

Dieser Parameter ist optional für START_PROCESS und STOP_PROCESS. Informationen zur Verschlüsselung von Passwörtern finden Sie unter Passwörter codieren .

Zuordnung:
- Passwort: Passwort für die Start- und Stoppberechtigung des Dienstes.
-sm Startmodus von Server-Workprozessen (WPs)

Welche Werte für den Parameter -sm zulässig sind, hängt von der Dienstdefinition in der SMD-Konfigurationsdatei des ServiceManagers ab.
Um sicherzustellen, dass dem WP beim Start ein bestimmter Startmodus zugewiesen werden kann, müssen Sie START1=, START2=, START3= .... in der SMD-Datei für jeden DEFINE eines WP-Dienstes einstellen. Die mitgelieferte SMD-Datei UC4.SMD enthält einige Beispieldefinitionen.

Zuordnung:
- Startmodus: z. B. die Definition eines WP-Dienstes in einer SMD-Datei (einschließlich 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=(Kaltstart,*WP_STARTCMD_COLD);START2=(Systemstopp,*WP_STARTCMD_STOP);START3=(Kaltstart mit Systemstopp,*WP_STARTCMD_COLDSTOP)
  
  Erlaubte Werte:
  "Coldstart" = Kaltstartmodus
  "Systemstop" = Normaler Start. Zu diesem Zweck wird das System gestoppt.
  "Coldstart with Systemstop" = Kaltstart mit einem Systemstopp.

Wenn Sie das Kommandozeilenprogramm mit falschen oder fehlenden Parametern aufrufen, wird ein kurzer Hilfetext angezeigt, der die korrekten Parameter und Rückgabewerte anzeigt.

Output

Wenn Sie das Kommandozeilenprogramm mit dem Befehl GET_PROCESS_LIST aufrufen, werden die angeforderten Informationen Zeile für Zeile angezeigt. Dies entspricht der Ansicht des ServiceManager-Dialogprogramms.

Ausgabeformat

"Service" "Status" ["ProcID" "Start time" "Runtime" "CPU Time"]

Service: Name des Dienstes.
Status: Status des Dienstes.
- „R“ = Laufend
- „S“ = Gestoppt
ProcID: Prozessnummer des Dienstes.

Es werden nur Informationen zu aktiven Diensten (Status = R) angezeigt.
Startzeit: Startdatum und -zeit des Dienstes.

Format: „YYYY-MM-DD HH:MM“

Es werden nur Informationen zu aktiven Diensten (Status = R) angezeigt.
Laufzeit: Die Laufzeit des Dienstes.

Format: „DD/HH:MM“

Es werden nur Informationen zu aktiven Diensten (Status = R) angezeigt.
CPU-Zeit: CPU-Zeit, die von einem Dienst benötigt wird.

Format: „DD/HH:MM:SS:HS“ (HS=Hundertstelsekunden).

Es werden nur Informationen zu aktiven Diensten (Status = R) angezeigt.

Rückgabewerte

0 Ein Kommando wurde fehlerfrei verarbeitet.
1 Es wurde ein falsches Kommando eingegeben.
2 Es wurde kein aktiver ServiceManager auf dem angegebenen Computer gefunden.

Möglicher Grund: Entweder wurde der Name des Computers nicht eingegeben oder auf diesem Computer ist kein ServiceManager aktiv.
3 Der ServiceManager reagiert unerwartet auf einen Befehl.

Möglicher Grund: Die ServiceManager-Version ist nicht aktuell.
4 Bei der Verbindung zum ServiceManager sind Fehler aufgetreten.
5 Die angegebene ServiceManager-Umgebung ist auf dem entsprechenden Computer nicht vorhanden.

Möglicher Grund: Der ServiceManager für die angegebene ServiceManager-Umgebung ist entweder nicht installiert oder wurde nicht gestartet.

Beispiele

Das erste Beispiel ruft alle Services ab, die zum Computer „WINW2K01“ und zur ServiceManager-Umgebung „UC4P“ gehören.

UCYBSMCL.EXE -c GET_PROCESS_LIST -h WINW2K01 -n UC4P

Output:

"UC4 CP1" "R" "1588" "2004-04-05 21:39" "0/01:11" "0/00:00:22.69"
"UC4 WP1" "R" "3388" "2004-04-05 21:39" "0/01:11" "0/00:00:22.69"
"UC4 WP2" "R" "1576" "2004-04-05 21:39" "0/01:11" "0/00:00:22.69"
"Win32-Agent WIN01" "R" "2708" "2004-04-05 21:40" "0/01:11" "0/00:00:01.31"
"Win32-Agent WIN21" "R" "2392" "2004-04-05 21:40" "0/01:10" "0/00:00:01.30"
"Win32-Agent UC4MAIL" "R" "2932" "2004-04-05 21:40" "0/01:10" "0/00:00:01.31"
"SAP Agent C46" "S"
"PeopleSoft-Agent PS01" "S"

Das zweite Beispiel beendet normalerweise einen UNIX-Agenten.

./ucybsmcl -c STOP_PROCESS -h unixw2k01:8871 -n uc4p -s unix01 -m Close

Siehe auch: