Événements CONS

Si vous êtes développeur et concepteur d'objet, vous pouvez définir des événements CONS (Console) pour surveiller le contenu des messages, queues de messages, etc. renvoyés par la console (système cible). Par exemple, ils contrôlent à une fréquence régulière, à certaines dates ou heures, si une chaîne de caractère spécifique est présente dans les messages. Si les conditions que vous définissez à la page Script d'événement sont remplies, l'événement CONS déclenche les actions que vous définissez dans sa page Script d'événement. Ces actions sont généralement des exécutions d'autres objets. Le statut des événements CONS reste En sommeil tant que les conditions de fréquence et de temps ne sont pas remplies, et change pour Vérifier lorsqu'elles le sont.

Pour récupérer les données relatives à l'objet Événement, vous pouvez utiliser les fonctions Langage de script Automation Engine suivantes :

Cette rubrique contient les sujets suivants :

Agents surveillés

Les objets événement console surveillent la sortie et les messages renvoyés par les agents suivants :

BS2000

Sortie de console

Configuration requise : Avoir installé l'utilitaire UCXEB2xU pour la console ; il s'exécute parallèlement à l'agent BS2000.
z/OS

Sortie de console Multiple Console Support - MCS.
OS/400

File d'attente des messages
Événements SAP
XI

Canaux de communication (modifications de statuts)
L'observateur d'événements Windows

Les instructions et les fonctions des scripts spécifiées à la page Script d'événement sont exécutées si les conditions telles que l'ID d'événement ou le filtre du message sont réunies.

Les spécifications de filtre du message doivent toujours commencer par un caractère générique.

Définir des événements CONSOLE

Vous pouvez définir les propriétés de l'événement console sur deux pages :

Événement console, voir les instructions ci-dessous.
Page Script d'événement

C'est le coeur des objets événement. Spécifiez les instructions à traiter dès que les conditions définies sont remplies.

Section Événement console

Les listes déroulantes Agent et Type d'agent sont communes à tous les agents.

Dans Agent procédez selon l'une des méthodes suivantes :
- Sélectionnez une entrée dans la liste.
- Cliquez sur l'icône de dossier pour ouvrir la boîte de dialogue Sélectionner l'agent et rechercher celui dont vous avez besoin.
- Saisissez le nom de l'agent ou une variable récupérant son nom et sélectionnez le type d'agent approprié.
  
  Utilisez cette option si l'agent n'est pas affecté au client actuel, mais au Client 0 et qu'il n'est donc pas répertorié ici.
Pour les deux premières options, le type d'agent est automatiquement sélectionné et ne peut pas être édité.

Selon l'agent sélectionné pour la surveillance, le reste des champs de cette section diffère :
Dans le tableau Événements, définissez les conditions que la sortie de console surveillée doit remplir pour que les actions de la page Script d'événement se déclenchent. Pour plus d'informations, voir les conditions d'événement ci-dessous. Les caractères génériques suivants sont autorisés.
- * (n'importe quel nombre de caractères)
- ? (un caractère spécifique)

Spécifiez les conditions :

BS2000
Dans le tableau Événements, saisissez la chaîne de caractères que l'événement doit rechercher.
OS/390
- Nom du système
  
  Filtrez le nom du système défini par l'utilisateur, qui permet de différencier les diverses instances du système d'exploitation.
  
  Longueur maximale : 8 caractères.
- Définissez un filtre pour le nom du système d'exploitation, comme défini par IBM. Actuellement, c'est toujours MVS.
  
  Longueur maximale : 8 caractères.
- Nom du job
  
  Jobs à surveiller.
  
  Longueur maximale : 32 caractères.
- Filtre des messages
  
  Chaîne de caractères à rechercher.
Pour surveiller la sortie de console (Multiple Console Support - MCS) dans z/OS, installez le moniteur d'événements UCXEMxx et démarrez-le avec une entrée correspondante dans le fichier INI de l'agent z/OS.
OS/400
Sous OS/400, vous pouvez surveiller les files d'attente des messages. Définissez la queue dans le fichier INI de l'agent OS/400.
Valeurs de Sévérité autorisées : 0 à 999
SAP
L'événement de console pour SAP différencie diverses sources de données :
- Historique des événements ABAP
  - ID d'événement
    
    Filtre du nom de l'événement ABAP SAP
  - Paramètre de l'événement
    
    Filtre du paramètre de l'événement ABAP SAP.
  - Serveur des événements
    
    Filtre du nom de serveur batch de l'événement ABAP SAP.
- Canaux de communication XI
  - Objet Login contenant les informations d'identification de l'objet XI.
    
    Utilisez différents objets Login pour les systèmes SAP et XI lorsque les deux sont installés sur le même agent, sinon l'entrée de login ne serait pas unique.
    
    L'objet Login remplace les données spécifiées dans l'objet Connexion (CONN).
  - Dans Canal, Partenaire et Service, spécifiez le filtre d'événement. Le caractère générique "*" est autorisé.
  - Etat
    
    Valeurs possibles : ERROR, OK, INACTIVE, UNKNOWN et UNREGISTERED.
  - État d'activation
    
    Valeurs possibles : STARTED et STOPPED.
  La liste des filtres décrit le statut nominal d'un ou plusieurs canaux de communication. Un événement est déclenché pour chaque canal de communication qui
  - ne correspond pas au statut nominal lors du démarrage de l'objet Événement.
  - bascule sur un statut différent (nominal ou autre).
  Aucun événement n'est déclenché si le canal de communication correspond à l'état nominal lors du démarrage de l'objet événement.
  
  Vous pouvez utiliser la fonction de script GET_EVENT_INFO de la page Script d'événement pour fournir des informations supplémentaires sur le canal de communication XI. Voir GET_CONSOLE, GET_EVENT_INFO.
- Historique des événements Java
  - Type d'événement
    
    Filtre pour le type d'événement du planificateur Java SAP.
    
    Le contenu de cette liste provient de la variable UC_SAP_XJBP_EVENTTYPES, disponible dans le client 0. L'objet variable est fourni avec tous les types d'événements possibles et ne doit pas être modifié.
  - Paramètre de l'événement
    
    Filtre des paramètres de l'événement du planificateur Java SAP.
    
    Les caractères génériques "*" (n'importe quel nombre de caractères) et "?" (exactement un caractère) sont autorisés.
  - Paramètre aditionnel de l'événement
    
    Filtre des paramètres supplémentaires de l'événement du planificateur Java SAP.
    
    Les caractères génériques "*" et "?" sont autorisés. "?" signifie exactement un caractère, "*" signifie n'importe quelle chaîne de caractères.
Windows
Sous Windows, vous pouvez surveiller l'observateur d'événements Windows. Pour réagir à des messages donnés, vous devez tout d'abord analyser l'observateur d'événements. Les détails de l'événement fournissent les entrées requises. Vous pouvez les ouvrir en double-cliquant dessus.

Dans Microsoft Windows, les textes des messages se composent de parties fixes et variables. L'événement ne fournit que les parties variables du message. Si vous utilisez un filtre de message, l'événement ne réagit que si la recherche porte sur les parties variables du message. Voir GET_WIN_EVENT pour plus d'informations sur la manière de demander le message texte.
- Type
  
  Journal à surveiller.
- Source
  
  Source de l'événement Windows.
- Catégorie
  
  Définie par la catégorie ayant journalisé l'événement. Elle associe les événements ayant la même valeur de catégorie.
  
  Caractères autorisés : Numérique.
  
  Saisissez 0 si vous ne souhaitez pas filtrer par catégorie.
- ID d'événement
  
  Saisissez 0 si vous ne souhaitez pas filtrer par ID d'événement.
- Type
- Utilisateur
  
  Utilisateur auquel l'événement Windows est affecté.
- Filtre des messages
  
  Chaîne de caractères à rechercher.

Section Paramètres de temps

Dans Fréquence, spécifiez la fréquence d'activation de l'objet d'événement :

Répété

S'active périodiquement, selon ce que vous aurez configuré ci-dessous.
Jusqu'à la première correspondance

S'active jusqu'à ce que les conditions spécifiées s'appliquent.

Section Contraintes de calendrier

Ces conditions sont systématiquement vérifiées. Un événement ne se déclenche que dans l'un des cas suivants :

Au moins l'une des conditions est remplie.
Aucune condition n'a été définie ici.

Le fuseau horaire affecté à l'événement est également pris en compte. Cela signifie qu'il n'est pas pertinent d'activer un événement et de spécifier une date logique.

Voir Tableaux dans les pages.

Étapes suivantes

La Page Script d'événement vous permet de définir les actions déclenchées par l'événement.
Exécutez l'objet Événement pour l'activer.

L'exécution d'un objet Événement déclenche l'exécution d'autres objets, qui déclenchent à leur tour l'exécution d'autres tâches. Les tâches résultant de ces exécutions s'affichent dans la perspective Surveillance des processus sur diverses listes d'exécutions liées à l'objet Événement. Ce sont des tâches enfants de la tâche Événement et elles sont signalées par un type d'indicateur spécial : !EVNT. Cet indicateur vous permet de vérifier les exécutions ayant été déclenchées par un certain événement. Pour plus d'informations, voir Surveiller les événements et Données d'exécution.

Vous pouvez exécuter des objets Événement de l'une des manières suivantes :
- En incluant des objets Événement dans des Objets Schedule (JSCH) pour les exécuter automatiquement à des heures et / ou intervalles de temps prédéfinis.
- En insérant des objets Événement dans des workflows (voir Concevoir des workflows (JOBP)).
- En exécutant, relançant ou arrêtant manuellement les objets Événement. Pour plus d'informations, voir Exécuter des événements.
Pour connaître le nombre de fois où le système a contrôlé l'événement, accédez à la section Contrôler compte dans les détails de l'objet. Pour plus d'informations, voir Afficher le détail des objets et des tâches.
Surveillez l'événement.

Juste après avoir exécuté l'objet, vous pouvez commencer à surveiller l'événement. Faites un clic droit sur l'objet, puis sélectionnez Surveiller, Afficher dans Surveillance des processus et ouvrez la liste préfiltrée des tâches pour afficher la tâche. La perspective Surveillance des processus vous permet de suivre la progression de la tâche et d'accéder aux rapports et informations statistiques.

Vous pouvez arrêter des événements actifs de l'une des manières suivantes :
- interrompre l'événement
  Statut : Interrompu/interrompu manuellement
- Quitter l'événement
  Statut : Ended_OK
- Suspendre l'événement
  L'événement reste actif, mais désactivé ponctuellement
Pour plus d'informations, voir Travailler avec des tâches, et en particulier Arrêter et interrompre.

Voir aussi :