Base de connaissances > Informateur de Job de l'Agent

Informateur de Job de l'Agent

Tous les Agents de système d'exploitation possèdent un Agent Job grâce auquel vous pouvez exécuter et surveiller les Jobs. Il est notamment exécuté dans les objets Include HEADER et TRAILER. Ces Includes de Job spéciaux se trouvent dans le Client système 0000.

Extrait de l'objet Include HEADER.MVS :

//JMLDS EXEC PGM=&UC_JOBMD,
// PARM='JNR=&UC_REALNR MNR=&UC_CLIENT PNR=&UC_IP_PORT IPA=&UC_IP_ADR
//             TYP=S TXT="        Job started" 2>&1'

Extrait de l'objet Include TRAILER.MVS :

//JMLDE EXEC PGM=&UC_JOBMD,COND=EVEN,
// PARM='JNR=&UC_REALNR MNR=&UC_CLIENT PNR=&UC_IP_PORT IPA=&UC_IP_ADR
//             TYP=E STP=&UC_REPORT_STEPS RET=&RETCODE 2>&1'

Attention : pour l'Agent Job z/OS, l'instruction PARM ne doit pas contenir plus de 100 caractères !

Paramètres de démarrage généraux

L'Agent Job possède une série de paramètres de démarrage pouvant lui être transmis. Le tableau suivant contient ceux qui s'appliquent à tous les informateurs de Job.

Paramètres

Description

IPA

Adresse IP

JNR

RunID du Job

MNR

Client

PNR

Numéro de port

RET

Code retour

TYP

Type ("S" pour Agent Job de début, "E" pour Agent Job de fin)

Pour l'Agent Job GCOS8, les types suivants s'appliquent également "R" : redémarrage, "A" : fin anormale, "X" : arrêt de l'Agent Job et "J" : rapport de Job du système RSM.

TXT

Texte affiché au début du rapport de Job et dans la fenêtre de détails à côté du texte de statut.

Attention : le paramètre TXT= ne doit pas dépasser 32 caractères. En outre, l'Automation Engine a besoin des 8 premiers caractères. C'est pourquoi vous devez toujours entrer des espaces pour les 8 premiers caractères. Les autres caractères sont à votre disposition pour votre texte.

De plus, plusieurs informateurs de Job possèdent des paramètres de démarrage spéciaux :

Système d'exploitation

Paramètres

Description

GCOS8

RFN

Nom de fichier du rapport de Job

 

SNM

Numéro de séquence du Job

 

SW

Statut de l'Agent Job

 

TIMEOUT

Intervalle en secondes après lequel un dépassement de délai se produit pour la connexion entre l'Agent et l'Agent Job (valeur par défaut : 60).

z/OS

STP

Journalisation des codes retour des steps

"0" - Pas de journalisation (valeur par défaut)
"1" - L'Agent Job enregistre les codes retour.

 

RETRY

Nombre de tentatives de connexion (valeur par défaut : 4)

 

WAIT

Durée entre les tentatives de connexion (valeur par défaut : 30 secondes)

OS/400 OUT

Journalisation des messages de l'Agent Job

"0" - Pas de journalisation (valeur par défaut)
"1" - Le rapport de Job contient également les messages de l'Agent Job.

UNIX et VMS

RETRY

Nombre de tentatives de connexion

Valeur par défaut : Pour UNIX et VMS 3

 

TIMEOUT

Intervalle en secondes après lequel un dépassement de délai se produit pour la connexion entre l'Agent et l'Agent Job (valeur par défaut : 60).

 

WAIT

Durée entre les tentatives de connexion

Valeur par défaut : Pour UNIX et VMS 120 secondes

UNIX et Windows CMD

Commande devant être exécutée sur l'ordinateur de l'Agent.

La commande peut également contenir des mots de passe ayant été cryptés via un objet PromptSet. En outre, la variable PromptSet contenant la valeur de la zone de texte PromptSet cryptée doit être indiquée. Les mots de passe sont automatiquement identifiés et décryptés en conséquence par l'Agent Job.

Les mots de passe ayant été cryptés via UCYBCRYP.EXE ne sont PAS décryptés par l'Agent Job !

La commande exécutée par l'Agent doit être utilisée dans l'onglet "Script" des Jobs. Exemple pour Windows :
&UC_JOBMD CMD="ping localhost"

 

Rubriques connexes :