Ce programme crée un nouvel agent. Un identifiant GTS est généré et retourné à l'appelant.
Paramètres
Paramètre |
Type |
Description |
Id |
NUM_BIN_4 |
O - Identifiant GTS de l'agent.
|
Name |
ALPHA(50) |
I - Nom de l'agent.
|
Description |
ALPHA(250) |
I - Description de l'agent.
|
TargetServer |
ALPHA(250) |
I - Serveur d'exécution demandé (nom GTS ou blanc (*ANY)).
|
StartMode |
ALPHA(1) |
I - Mode de démarrage.
|
RestartCount |
NUM_BIN_2 |
I - Nombre de défaillances autorisées avant arrêt des tentatives de redémarrage.
|
Pgm |
ALPHA(250) |
I - Programme de service.
|
Paramètre1 |
ALPHA(1024) |
I - Paramètre 1 du programme.
|
Paramètre2 |
ALPHA(1024) |
I - Paramètre 2 du programme.
|
CodeRetour |
NUM_BIN_4 |
O - Code retour du programme.
|
Le champ programme contient le nom du programme à exécuter.
Le programme doit respecter la convention d'appel suivante : programme <paramètre1> <paramètre2> <id de job>, identique aux programmes de travaux, ce qui facilite le portage d'un programme de travail en agent.
Ce programme doit s'interfacer avec la base du gestionnaire de travaux pour mettre à jour le rapport (par exemple en utilisant le programme d'interface TR_ADD_REPORT).
Par contre, la gestion de l'état de l'agent (arrêt / signalement d'une anomalie / texte d'état...) s'effectue en utilisant les fonctions de la DLL GsAgentDLL.
Les paramètres 1 et 2 sont des champs ALPHA d'une longueur maximale de 1024 caractères.