Rapports des jobs

Les objets Job écrivent des rapports supplémentaires (rapports externes) détaillant leur exécution. La page de définition spécifique aux jobs, vous spécifiez quand les générer et où les stocker. Certains objets Job (tels que les jobs SAP, OS/390 et SQL entre autres) proposent des options supplémentaires. Cette rubrique les décrit toutes.

Options communes à tous les types de jobs

Où enregistrer le rapport

Vous avez deux options. Vous pouvez en sélectionner un ou les deux :

Enregistrer dans : Base de données signifie que lorsque le job a été exécuté, le journal de traitement disponible sur le système cible (l'agent) est enregistré dans la base de données.

Une fois un job exécuté sur un agent, le rapport correspondant est également enregistré sur l'ordinateur de l'agent. Dès que Automation Engine a écrit ces données dans la base de données, le rapport est automatiquement supprimé de l'ordinateur de l'agent. Si ce dernier ne peut pas être supprimé, suite à une erreur, la suppression n'est pas répétée et un message d'erreur apparaît.

Pour les jobs Unix, SAP, Windows et BS2000 (SYSOUT et SYSLST), les rapports sont transférés vers Automation Engine par transfert de fichier.
Enregistrer dans : Fichier signifie que le journal du traitement est enregistré sous forme de fichier dans le système cible (agent).

Quand générer le rapport

Vous avez deux options :

Générer : Toujours signifie que le journal de traitement du système d'exploitation est toujours écrit.
Générer : Sur erreur uniquement signifie que le journal de traitement n'est écrit qu'en cas d'erreur. Par exemple, si le job est annulé ou interrompu.

Options BS2000

Pour les jobs BS2000, vous pouvez également spécifier l'emplacement de stockage et quand générer le protocole SysLst.

Jobs JMX

Pour les jobs JMX, vous disposez d'une option Ajouter journal de l'agent supplémentaire. Activez-la si vous souhaitez également inclure les messages de l'agent dans la tâche, lors de l'exécution du job.

Jobs OS/390

Pour les jobs OS/390, vous disposez des options supplémentaires suivantes :

Portée du log du job

Valeurs autorisées :
- Configuration par défaut de l'agent
  La portée du journal de job dépend de ce qui a été configuré dans le fichier INI de l'agent (paramètre completeJobout=).
- Enregistrer les exécutions JES et la sortie du job
  Enregistre les exécutions JES et la sortie de job dans le journal du job.
- Enregistrer les exécutions JES uniquement
  JESMSGLG, JESJCL et JESYSMSG sont inclus.
Supprimer le log du job
- Configuration par défaut de l'agent
  La suppression du journal de job dépend de ce qui a été configuré dans le fichier INI de l'agent (paramètre jobPurge=).
- Supprimer après lecture
  Supprime le fichier journal du job après lecture par l'agent.
- Ne pas supprimer
  Le journal du job reste dans le spool JES.
Libérer pour impression
- Configuration par défaut de l'agent
  La libération du journal de job dépend de ce qui a été configuré dans le fichier INI de l'agent (paramètre relMsgClass=).
- Libérer après lecture
  Libère le fichier journal du job après lecture par l'agent.
- Ne pas libérer
  Le journal du job reste dans le spool JES.
Lire les classes des messages

Classes de messages devant être lues et routées. Indiquez une ou plusieurs classes de messages. Exemples : "A", "ABC", "X1".

L'ordre ne joue ici aucun rôle. Les valeurs autorisées sont les suivantes : *DEFAULT et *ALL.
- DEFAULT
  Les classes de message à lire dépendent de ce qui a été configuré dans le fichier INI de l'agent (Paramètre getMsgClass=).
  
  Si vous utilisez ce paramètre, *DEFAULT doit aussi être spécifié dans le champ Renvoyer les classes de messages à.
- ALL
  Lit toutes les classes.
Renvoyer les classes de messages à

Classes de message devant être routées.

Après le transfert dans Automation Engine, le journal du job peut être routé vers les classes de message spécifiées (par exemple pour un système de gestion des sorties).

Spécifiez soit une, soit autant de classes de messages saisies dans le champ Lire les classes des messages. L'ordre joue ici un rôle important !

Par exemple :

Les classes de message suivantes sont lues "ABC" et routées "DEF". La classe "A" devient classe "D", "B" devient "E" et "C" devient "F".

Un autre exemple :

Les classes de message suivantes sont lues : "ABC" et routées : "D". Les classes "A", "B" et "C" sont routées vers la classe "D".

Les classes de messages peuvent être remplacées par les valeurs suivantes :
- DEFAULT
  Les classes de message à router dépendent de ce qui a été configuré dans le fichier INI de l'agent (Paramètre routeMsgClass=).
  
  Ce paramètre doit être spécifié si *DEFAULT est également spécifié dans le champ Lire les classes des messages.
- NO
  Aucun routage n'est effectué.

Jobs OS400

Pour les jobs OS400, vous disposez des options supplémentaires suivantes :

Enregistrer depuis le spool : Log du job (QPJOBLOG)

Seul le contenu du spool de QPJOBLOG est enregistré dans la base de données Automation Engine et/ou disponible comme membre dans le système cible.
Enregistrer depuis le spool : En entier (*ALL)

Tout le contenu du spool du Job est enregistré dans la base de données Automation Engine et/ou disponible comme membre dans le système cible.

Jobs SAP

Pour les jobs SAP, vous disposez des options supplémentaires suivantes :

Enregistrer dans
Ajouter

Il s'agit des rapports optionnels extraits du système SAP. Ces derniers sont disponibles pour le job SAP mais pas pour ses enfants.
- Log de l'agent
- Log de l'application (jobs SAP ABAP seulement)
- Répertoire de spool (jobs SAP ABAP seulement)
- Listes de steps (jobs SAP ABAP seulement)
- Statistiques
Ces rapports peuvent être longs et complexes. Dans une installation standard, le client 0 a reçu des objets Feuille de style prêts à utiliser qui contiennent le code nécessaire pour les formater et leur donner une mise en page conviviale.

Voir Feuille de style (XSL) ainsi que UC_REPORT_STYLESHEETS - Feuilles de style pour rapports XML.

Jobs SQL

Pour les jobs SQL, vous disposez de l'option supplémentaire suivante :

Ajouter log de l'agent : Cochez cette case si vous souhaitez également inclure les messages de l'agent dans la tâche, lors de l'exécution du job.

Jobs Windows

Rapport via script Sélectionnez cette option pour écrire un rapport de job qui remplacera le rapport par défaut.

Voir aussi :