Moniteur d'événements z/OS

system=

Nom du système AE.

Cette entrée doit être identique à l'entrée dans le Fichier INI du Automation Engine

name=

Nom du moniteur d'événements
Ce nom doit être univoque.

Langue dans laquelle le logging est exécuté. Indication de la langue primaire et secondaire.

Valeurs autorisées : "E", "D" et "F"

Défaut : "E,D" (langue primaire anglais, langue secondaire allemand)

S'il n'existe pas de message dans la langue primaire, un message est recherché dans la langue secondaire.

Nom du fichier log.

Les caractères numériques servent de caractère de remplacement pour une numérotation croissante. Au démarrage de l'agent, les fichiers log sont renommés, ainsi le fichier log le plus récent porte toujours le numéro "00".

Mettez ce paramètre en commentaires ; ainsi le fichier log sera enregistré dans le JES. A ce propos, faites attention au paramètre logpurgeclass=.

Si le log est écrit dans un jeu de données, les paramètres suivants peuvent encore être ajoutés (après le nom du jeu de données, séparés par des points-virgules) :

"recfm" = (les 27 formats d'enregistrement de z/OS ainsi que * et A sont tous valides)
"lrecl" = (0, chaque nombre positif jusqu'à 32760 et X pour chaque Reclen)
"blksize" = (0, chaque nombre positif jusqu'à 32760)
"space" = ([CYL,TRK],(prim,sec,directory))

logpurgeclass=

Classe MVS Sysout pour les fichiers log.

Valeurs autorisées : A-Z et 0-9
Valeur par défaut : "A"

Avec ce paramètre, les fichiers log peuvent être renvoyés vers la classe MVS Sysout spécifiée.

Attention : la classe Sysout ne peut être prise en compte que si vous mettez le paramètre logging= en commentaires avec ";".

Le paramètre logcount= joue également un rôle important dans le renvoi du fichier log. Autant de fichiers log sont créés que le nombre défini dans ce paramètre. Si ce nombre est dépassé, alors le plus ancien fichier log est transféré à la classe Sysout.

Exemple :

Le paramètre logcount= est défini sur 3. Lors de la création du quatrième fichier de rapport, le premier fichier est transféré à la classe Sysout.

helplib=

Nom du fichier des messages.

Disponibilité des messages et chaînes de caractères en langues étrangères

Valeurs autorisées : "ALL" (valeur par défaut), "NONE", "CONTROLS"

"ALL" = l'ensemble du fichier des messages est stocké dans la mémoire de travail.
"NONE" = le fichier des messages est toujours lu sur le disque dur.
"CONTROLS" = toutes les chaînes en langues étrangères nécessaires à l'affichage d'un programme de dialogue sont stockées dans la mémoire de travail (ne concerne pas les Agents).

EventCheckIntervall=

Vérification d'événement périodique en secondes

Valeur par défaut : 3600

Nous vous recommandons de ne pas sélectionner une valeur trop réduite afin d'éviter de surcharger inutilement le Serveur.

(TRACE)

Les caractères numériques servent de caractère de remplacement pour une numérotation croissante. Lors du démarrage d'une trace, les fichiers de trace sont renommés de telle manière que le fichier de trace actuel ait toujours le numéro "00".

Si le log est écrit dans un jeu de données, les paramètres suivants peuvent encore être ajoutés (après le nom du jeu de données, séparés par des points-virgules) :

"recfm" = (les 27 formats d'enregistrement de z/OS ainsi que * et A sont tous valides)
"lrecl" = (0, chaque nombre positif jusqu'à 32760 et X pour chaque Reclen)
"blksize" = (0, chaque nombre positif jusqu'à 32760)
"space" = ([CYL,TRK],(prim,sec,directory))  

Nombre des fichiers de trace sauvegardés.

Indicateurs de trace de l'agent pour la communication TCP/IP

Valeurs autorisées : "0" (valeur par défaut) à "9"

Les indicateurs de trace ne doivent être définis qu'après accord définitif du support.

trcmode=

Méthode selon laquelle les fichiers de trace sont générés.

Valeurs autorisées : "0" à "3"
Valeur par défaut : "1"

"0" : le fichier de trace est écrit normalement.
"1" : après chaque ligne de trace, tous les tampons de fichier sont écrits sur le disque.
"2" : après chaque ligne de trace, close/open est utilisé sur le fichier de trace. N'utilisez pas cette option en combinaison avec des événements de système de fichiers car cela génère un événement par ligne, ce qui peut entraîner la création de boucles récursives infinies.
"3" : les sorties de trace sont également écrites dans le fichier log.

(TCP/IP)

ex=

Adresse de l'agent auquel le moniteur d'événements doit se connecter.

Formats autorisés :
nom DNS:numéro de port
adresse TCP/IP:numéro de port

connect=

Intervalle de temps en secondes au cours duquel le moniteur d'événements essaie périodiquement de se reconnecter.

Valeur par défaut : 120 secondes

Pour permettre une nouvelle connexion rapide et immédiate, il existe l'instruction de console "MODIFY ..., EX=<addr>,:<port>. Dans ce cas, une tentative de reconnexion à l'agent spécifié est immédiatement effectuée. Une nouvelle connexion est établie, même si le moniteur d'événements est déjà connecté à un autre agent. Dans ce cas, une nouvelle connexion est établie. Si celle-ci est réussie, l'ancienne connexion peut être fermée.

ex2=

Autre adresse d'agent à laquelle le moniteur d'événements doit se connecter si l'agent primaire (paramètre ex=) n'est pas joignable.

exn=

Adresse d'agentcomplémentaire à laquelle le moniteur d'événements doit se connecter si l'agent primaire n'est pas joignable.

Taille en octets du cache TCP/IP pour les messages à envoyer.

Valeur par défaut : 262144 octets

Taille en octets du cache TCP/IP pour les messages à recevoir.

Valeur par défaut : 262144 octets

Paramétrage des signaux de vie pour le maintien de la connexion entre l'agent et le moniteur d'événements.

Valeurs autorisées : "n"et "y" (valeur par défaut)

"y" : les signaux de vie sont envoyés
"n" : les signaux de vie ne sont pas envoyés.

Pour les événements de console :

console=

Evaluation de la console

Valeurs autorisées : "0" (valeur par défaut), "1"

"0" = la console n'est pas utilisée
"1" = la console est évaluée

buffersize=

Taille du cache des événements de console

Valeur par défaut : 1 MB

Pour les événements basés sur SMF (par exemple : fin du job, événements du système de fichiers, etc.) :

smfwrite=

Analyse des enregistrements SMF

Valeurs autorisées : "0" (valeur par défaut), "1"

"0" = les enregistrements SMF restent inutilisés
"1" = les enregistrements SMF sont analysés

Ce paramètre doit être activé pour la surveillance de la fermeture des fichiers et en particulier pour les Generation Data Groups.

ModulName=

Désignation pour l'exit SMF.

Valeur par défaut : "UC4EXIT"

Le nom sélectionné doit être unique si plusieurs moniteurs d'événements sont utilisés par LPAR !

CADSEyeCatcher=

Nom d'Eyecatcher servant de paramètre pour appeler l'utilitaireCADSDEL.

8 caractères maximum

Valeur par défaut : Nom du LPAR

smfStepFilter=

Analyse les enregistrements SMF dans des événements de système de fichiers automatisés.

Valeurs autorisées : "0" (valeur par défaut) et "1"

"0" : le moniteur d'événements n'analyse que les enregistrements SMF des fins de jobs. Dans ce cas, on fait la distinction entre fin normale et fin anormale.
"1" : le moniteur d'événements analyse aussi les enregistrements SMF pour les fins de STEP. Le code retour le plus élevé est repris. L'inconvénient de ce paramètre est la plus grande consommation de performance.

SMFJob=

Message annonçant la fin du Job ou la fin du STEP

Valeurs autorisées : "0" (valeur par défaut) et "1"

"0" : la fin du job est surveillée exclusivement par le messager de job.
"1" - L'identification de la fin du Job a lieu avec les enregistrements SMF.

Attention : le module SMF doit journaliser l'enregistrement SMF 30 et votre système doit autoriser l'exit IEFU84.

SMF_Buffersize=

Taille du Common Area Data Space (CADS) en Mo dans lequel l'exit SMF enregistre les événements.

Valeurs autorisées : "1" - "2048"
Valeur par défaut : 10

10 Mo suffisent pour enregistrer environ 65 000 événements.

ABENDNUM=

Nombre d'interruptions autorisées des exits SMF.

Valeur par défaut : 2

L'agent désactive l'exit SMF s'il s'interrompt plus souvent que le nombre défini ici. Un message s'affiche également simultanément sur la console.

Filtre de message :  *CSVDYNEX DELETE(EN=*,ROUTINE=*)*

Ce message est aussi envoyé si l'agent s'est arrêté, car dans ce cas l'exit SMF a aussi été désactivé.

Autres messages et vos Filtres concernant l'exit SMF :

Interruption normale de l'exit SMF : *UC4 IEFU83 EXIT ABENDED*
Message du système en cas de plantage de l'exit SMF : *CSV430I MODULE * FOR EXIT * HAS BEEN MADE INACTIVE*