Ce programme permet de créer un enregistrement dans la table des travaux, et rend en sortie l'identifiant du travail ainsi qu'un statut d'erreur.
Paramètres
NUM_BIN_4 |
Id |
(Sortie) Identifiant du travail. Cette valeur est calculée automatiquement.
|
ALPHA(50) |
Nom |
Nom du travail.
|
ALPHA(50) |
Type |
Type du travail (optionnel). Le type du travail est un identifiant utilisé pour verrouiller (paramètre d'unicité d'exécution) les exécutions simultanées de travaux de même nature.
|
NUM_BIN_2 |
Unicité |
Unicité d'exécution par rapport au type (valeur 0 ou 1).
|
ALPHA(30) |
Profil |
Profil utilisateur ayant soumis le travail. Le profil utilisateur doit être spécifié si les fonctions de gestion des utilisateurs sont utilisées.
|
TIMESTAMP |
DateActivation |
Date d'activation du travail. Il est possible de retarder le démarrage du travail en spécifiant une date d'activation. Cela ne garantit pas que le travail s'exécutera dès cette date (il ne passera pas si un autre travail de priorité supérieure est en attente).
|
ALPHA(250) |
Machine |
Machine sur laquelle le travail doit être exécuté (optionnel). Il est possible de spécifier quelle machine (quel gestionnaire de travaux) exécutera le travail. Selon la configuration, n'importe quel gestionnaire de travaux actif peut exécuter un travail si la machine n'est pas spécifiée.
|
NUM_BIN_4 |
IdFile |
Identifiant de la file d'attente. L'identifiant de file d'attente est un entier libre. Le travail sera exécuté s'il existe au moins un gestionnaire de travaux configuré pour gérer cette file.
|
NUM_BIN_2 |
Priorité |
Priorité du travail, de 1 (haute) à 5 (basse). Les travaux sont exécutés dans l'ordre croissant de leur priorité, dès l'instant où ils peuvent être activés. Un travail de priorité 1 passera toujours avant un travail de priorité 2 si les deux travaux peuvent être activés (c'est-à-dire acceptés par la machine et avec une date d'activation dépassée).
|
ALPHA(1) |
FlagArchive |
Mode d'archivage : Valeurs possibles : ' ' pas d'archivage, 'A' le rapport sera protégé de la suppression, 'D le rapport sera supprimé à la fin de l'exécution du travail. |
NUM_BIN_4 |
MaxExec |
Temps maximum d'exécution avant génération d'une alerte. |
ALPHA(250) |
Programme |
Nom du programme (si le programme respecte la convention d'appel) ou *SYSTEM, *CONSOLE pour les commandes système.
|
ALPHA(1024) |
Paramètre1 |
Paramètre 1 du programme (si le programme respecte la convention d'appel) ou ligne de commande système.
|
ALPHA(1024) |
Paramètre2 |
Paramètre 2 du programme (si le programme respecte la convention d'appel).
|
NUM_BIN_4 |
CodeRetour |
(Sortie) Code retour du programme : 0 si le travail a été créé ; Code SQL de l'erreur sinon.
|
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>.
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) et l'état du travail (terminé avec succès, en erreur, avertissement : programme d'interface TR_SET_JOB_STAT).
Les paramètres 1 et 2 sont des champs ALPHA d'une longueur maximale de 1024 caractères.
Il est possible d'exécuter une commande système générique en spécifiant *SYSTEM ou *CONSOLE comme nom de programme. Dans ce cas, on considère que le paramètre 1 contient la ligne de commandes à exécuter. Le paramètre 2 est ignoré. Le travail est exécuté dans une invite de commande DOS.
Dans le cas *SYSTEM, le gestionnaire de travaux masque l'invite de commande et intercepte la sortie de la commande pour constituer le rapport. Dans le cas *CONSOLE, le programme est affiché dans une fenêtre DOS, ce qui permet la saisie éventuelle de paramètres. Le rapport est alors vide. Dans les deux cas, le travail est considéré comme s'étant terminé avec succès si le code retour de la commande (errorlevel) est 0, en erreur sinon.
