Gestionnaire de services

-c

Commande à traiter.
Ce paramètre doit toujours être indiqué.

GET_PROCESS_LIST

Demande la liste de tous les services appartenant à l'environnement du gestionnaire de services sur un ordinateur avec les informations disponibles.

START_PROCESS

Lance un service

STOP_PROCESS

Arrête un service

-h

Ordinateur
Ce paramètre doit toujours être indiqué.

Nom de l'ordinateur

Nom de l'ordinateur sur lequel le gestionnaire de services doit être utilisé.

Des ordinateurs distants peuvent également être indiqués. Ces ordinateurs doivent être accessibles à partir de l'ordinateur qui fonctionne. L'utilisateur doit disposer de l'autorisation d'accès aux services de l'ordinateur distant.

Numéro de port

Sous UNIX, le numéro de port du gestionnaire de services doit également être indiqué.

-n

Environnement du gestionnaire de services.
Ce paramètre doit toujours être indiqué.

Phrase

Nom de l'environnement du gestionnaire de services qui regroupe/indique les différents services AE sur un ordinateur. Est également appelé phrase dans le programme de dialogue du gestionnaire de services.

-s

Service.
Le paramètre doit toujours être indiqué à l'exception de GET_PROCESS_LIST.

Nom du service

Caractérisation du nom d'un service

Disponible aux emplacements suivants :

• ceci est affiché dans la colonne "Service" du programme de dialogue
• ceci est indiqué dans le fichier de définition Phrase.SMD
• dans la sortie de la commande GET_PROCESS_LIST

Dans la mesure où le nom du service peut également contenir des espaces, il doit toujours figurer entre des guillemets doubles.

-m

Mode d'arrêt.
Ce paramètre est facultatif pour STOP_PROCESS.

Mode d'arrêt

Indique comment le service doit s'arrêter

Valeurs autorisées : "C" (valeur par défaut), "S", "A"
"C" = Close. Le service s'arrête normalement.
"S" = Shutdown. Le service s'arrête sans délai indépendamment des activités en cours.
"A" = Abnormally. Le gestionnaire de services arrête immédiatement le service par un appel système (Kill). Cette commande ne doit être utilisée que lorsque la recherche du service devant se terminer automatiquement a échoué.

-p

Mot de passe.
Ce paramètre est facultatif pour START_PROCESS et STOP_PROCESS. Pour plus d'informations sur l'encryptage des mots de passe, voir Chiffrement des mots de passe.

Mot de passe

Mot de passe autorisant le démarrage et l'arrêt d'un service.

The mode de démarrage des processus serveurs de travail (WPs)

Les valeurs qui sont autorisées pour le paramètre -sm dépendent de la définition du service dans le fichier de configuration SMD du gestionnaire de services.
Pour garantir qu'un mode de démarrage spécifique puisse être assigné au processus de travail lorsqu'il se lance, vous devez configurer "START1=, START2=, START3= ..." dans le fichier SMD pour chaque "DEFINE" d'un service WP. Le fichier SMD UC4.SMD fourni inclut plusieurs exemples de définitions.

Par exemple, la définition d'un service WP dans un fichier SMD (Variables incluses) :

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)

Pour ce service de processus de travail, les valeurs suivantes peuvent être utilisées pour le paramètre -sm

"Coldstart" = Mode de démarrage à froid
"Systemstop" = Démarrage normal. Le système est interrompu à cet effet.
"Coldstart with Systemstop" = Démarrage à froid incluant un arrêt du système.

Service

Désignation du service.

Statut

Statut du service.
"R" = Running. Le service est actif.
"S" = Stopped. Le service s'arrête.

ProcID

Numéro de processus du service.
Cette information n'est affichée que pour les services actifs (statut = R).

Heure de début

Heure de début du service.
Format : "YYYY-MM-DD HH:MM"
Cette information n'est affichée que pour les services actifs (statut = R).

Exécution

Exécution du service.
Format : "DD/HH:MM"
Cette information n'est affichée que pour les services actifs (statut = R).

Temps CPU

Temps CPU utilisé par le service.
Format : "DD/HH:MM:SS:HS"
HS signifie centième de seconde.
Cette information n'est affichée que pour les services actifs (statut = R).

0

L'instruction a été exécutée sans erreur.

1

L'instruction est erronée.

2

Aucun gestionnaire de services actif n'a été trouvé sur l'ordinateur spécifié.

Cause possible :
le nom de l'ordinateur n'a pas été indiqué ou il n'y a pas de gestionnaire de services actif sur cet ordinateur.

3

Le gestionnaire de services a réagi de façon inattendue à l'instruction.

Cause possible :
la version du gestionnaire de services n'est pas à jour.

4

Des erreurs sont survenues lors de la connexion au gestionnaire de services.

5

L'environnement du gestionnaire de services indiqué n'existe pas sur l'ordinateur.

Cause possible :
le gestionnaire de services n'est pas installé ou n'est pas lancé avec l'environnement spécifié.