Manuel d'administration > Configuration > Organisation des fichiers de configuration > z/OS - Moniteur de Job externe

z/OS - Moniteur de Job externe

Structure du fichier INI UC4EJM.INI

Description du fichier INI du moniteur de job externe qui est utilisé en tant que tâche autonome (Started Task).

Des valeurs par défaut ont été attribuées à la plupart des paramètres. Vous pouvez les modifier si nécessaire. Les paramètres que vous devez adapter à l'environnement de votre système sont écrits en lettres rouges.

Section/paramètre Description
(GLOBAL)  

name=

Nom du moniteur de Job externe
Ce nom doit être univoque.

language=

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

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

Valeur par 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.

 

logging=

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 inscrit 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))

logcount= Nombre des fichiers log sauvegardés.

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.

Par 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.

helpcache=

Disponibilité des messages et chaînes 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).

JobFilter=

Nom du fichier de filtrage (jeu de données JobFilter).

JobTable=

Nom du jeu de données JobTable.

Un jeu de données JobTable s'inscrit lorsque le moniteur de Job externe se termine avec l'option END et sert à enregistrer le statut du Job en cours. L'exit SMF se poursuit et vérifie si un Job en cours du jeu de données JobTable a été terminé. Le jeu de données JobTable est supprimé au redémarrage du moniteur de Job externe.

Chaque moniteur de Job externe sur un LPAR nécessite son propre jeu de données JobTable. A l'inverse, tous les EJM d'un Sysplex peuvent utiliser les ensembles de données d'un filtre de job.

logJobProtocol=

Affichage de la journalisation de tous les Jobs du système dans le fichier log du moniteur de Job externe.

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

"0" – La journalisation des Jobs n'est pas enregistréee dans le fichier log.
"1" – La journalisation est enregistrées dans le fichier log.

(TRACE)

 

file=

Chemin et nom du fichier de 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".

event=

Indicateur de trace du moniteur de Job externe

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 ceci peut entraîner la création de boucles récursives infinies.
"3" : les sorties de trace sont également écrites dans le fichier log.

trccount= Nombre des fichiers de trace sauvegardés.

(SMFExit)

 

Modulname=

Nom du module d'exit SMF pour le moniteur de Job externe.

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*

CADSEyeCatcher=

Nom d'Eyecatcher servant de paramètre pour l'exécution de l'utilitaire  CADSDEL.

8 caractères maximum

Valeur par défaut : Nom du LPAR

 

Exemple de fichier INI

(GLOBAL)
name=UC4EJM
;lpar=LPAR1

language=(D,E)
;logging='UC4.EJM.LOG##'
logcount=2
logPurgeClass=9
helplib='UC4.UCX.MSL'
helpcache=ALL
jobfilter='UC4.EJM.JOBFLTR'
jobtable='UC4.EJM.JOBTABLE'

(TRACE)
;file='UC4.EJM.TRC##';space=(CYL,(10,5))
trccount=10
event=0
trcmode=3

(CONSOLE)
modulname=UC4EJM
smf_buffersize=10
;AbendNum=2
CADSEyeCatcher=UC4EJM

 

Rubriques connexes :