L'agent z/OS supporte la surveillance du système de fichiers et la fermeture des fichiers. L'événement est déclenché lorsque le fichier est fermé conformément aux conditions définies.
Dans un objet événement, vous pouvez filtrer par le nom de fichier ou en spécifiant une série de critères de filtrage. Ces derniers incluent le nom de fichier, le job ayant traité le fichier et son code retour.
La page Traitement d'événement est traitée lorsque l'événement s'est déclenché. La fonction de script GET_EVENT_INFO fournit des informations sur le fichier. Pour plus d'informations, voir : GET_CONSOLE, GET_EVENT_INFO.
Remarque : L'administrateur doit définir le paramètre smfwrite=1 dans le fichier INI de l'agent ou du moniteur d'événements. Vérifiez dans votre système z/OS que le sous-système SMF autorise les exits de système IEFU83 et IEFU84. Les entrées 14, 15, 30 et 64 doivent être journalisées.
Important ! Les événements automatiques du système de fichiers ne sont pas pris en charge sur les membres PDS.
Cette rubrique contient les sujets suivants :
Procédure
- Créez un objet événement de type système de fichiers.
- Ouvrez-le et passez à l'onglet Système de fichiers.
- Sélectionnez un agent z/OS.
- La section Contrôle de périodicité affiche désormais l'élément de menu supplémentaire nommé "Automatiquement". Sélectionnez-le.
Nom de fichier comme filtre
- Saisissez un nom de fichier dans le champ Chemin. Utilisez des caractères génériques si vous souhaitez surveiller plusieurs fichiers ou spécifiez le nom exact pour surveiller un fichier particulier.
- L'option Evénement de démarrage permet de vérifier l'existence du fichier quand l'objet événement est activé. Un événement est déclenché si le fichier existe.
- Saisissez les instructions de script à exécuter quand l'événement est déclenché dans la page Script d'événement. Utilisez la fonction de script GET_EVENT_INFO.
- Enregistrez l'objet événement et démarrez-le quand le fichier doit être surveillé.
Plusieurs critères de filtrage
- Créez un fichier contenant les critères de filtrage sur le LPAR sur lequel s'exécute l'agent. Ce fichier doit respecter un format particulier décrit dans le tableau ci-dessus.
- Spécifiez le nom du fichier de filtrage dans le champ Chemin. Utilisez le format suivant : *fichier(DSNAME)
Exemple : *file(SGD.PROD.MASSFILTER)
Les caractères génériques ne sont pas autorisés dans le DSNAME. - Saisissez les instructions de script à exécuter quand l'événement est déclenché dans la page Script d'événement. Utilisez la fonction de script GET_EVENT_INFO.
Important ! Notez que le "Traitement" n'est pas exécuté si le fichier de filtre contient la spécification d'un objet à démarrer. - Enregistrez l'objet événement et démarrez-le quand le fichier doit être surveillé.
Critère de filtrage
Le moniteur d'événements est capable de prendre en compte plusieurs critères de filtrage lors de la notification de la fermeture d'un fichier. Dans ce cas, l'événement n'est déclenché que si un job particulier a utilisé le fichier ou si un code retour spécial se produit.
Les critères de filtre sont enregistrés dans un fichier distinct qui contient une définition de filtre par ligne. Si plusieurs définitions de filtres s'appliquent à un événement (par exemple parce qu'ils se recoupent), un événement est déclenché par ligne valide.
Remarque : Le fichier de filtrage doit contenir les attributs DCB RECFM=VB, LRECL=512 et BLKSIZE=5120.
|
Critère de filtrage |
Positions |
Description |
|---|---|---|
|
Nom de fichier |
1 à 81 |
Filtre sur le nom de fichier Les noms DS incluant les membres PDS et GDG sont pris en charge. Vous pouvez utiliser des caractères génériques. |
|
Nom du job |
82 à 89 |
Filtre sur le nom du job z/OS qui a fermé le fichier. Les caractères génériques "*" et "?" sont autorisés. |
|
Fin du job |
90 |
Attente de la fin du Job Valeurs autorisées : " ", "X", "N" ou "A" " " : la fermeture du fichier déclenche immédiatement l'événement. Le système n'attend pas la fin du job. Utilisez le critère de filtrage "Code retour du job" pour définir les codes retour attendus. Lors de l'analyse de la fin du job, l'agent se base sur les enregistrements SMF de la fin de job ou sur les enregistrements de la fin des steps. La fin normale ou anormale du job ne peut être distinguée que si les enregistrements SMF de fin sont considérés. L'analyse est plus détaillée si la fin des STEPS est aussi prise en compte. Dans ce cas, le moniteur d'événements récupère la valeur maximum. L'administrateur peut définir si seule la fin du job ou aussi la fin des STEPs doit être prise en compte lors du contrôle du code retour. Les spécifications sont réalisées dans le fichier INI du moniteur d'événements via le paramètre smfStepFilter=. |
|
Code retour du job |
91 à 106 |
Filtrage du code retour du job (codes de conditions, interruptions utilisateur et interruptions système). Les valeurs peuvent être spécifiées comme dans z/OS ou selon la syntaxe spécifique à AE. Si vous voulez indiquer plusieurs codes retour, il faut les séparer avec ";" ou ",". Les domaines sont définis en utilisant "-". |
|
Action |
107 |
Action devant suivre l'événement Valeurs autorisées : "Y" et "N" (valeur par défaut). "Y" : l'objet spécifié dans le domaine suivant est traité à la place de ce que contient la page Script d'événement. |
|
Objet |
108 à 307 |
Nom de l'objet qui doit être exécuté. Vous pouvez enregistrer ici un objet job. Important ! Notez que le contenu de la page Script d'événement n'est PAS traité. A la place, l'objet indiqué ici est activé. |
Par manque de place l'exemple suivant ne montre pas tous les 307 caractères.
DEV.DS1 JOBA A
DEV.DS1 JOBB A S806 Y CALL.ADMIN
UC4.D*.*LIB TEST2 N 0-12;16-18 Y MM.CLOSING
SYS1.PARMLIB
TEST.S62*.T* TEST1 X 11-17;S806
Au démarrage de l'objet événement, l'agent lit le fichier de filtrage et notifie automatiquement les moniteurs d'événements. La modification des critères de filtrage nécessite de redémarrer l'objet événement concerné ou charger à nouveau le fichier de filtrage avec l'instruction MODIFY.
Syntaxe
MODIFY nom de l'agent STC,FEVNT=nom du fichier de filtrage
Exemple
MODIFY UC600T1,FEVNT=UC600T.FILTER1
En option, vous pouvez définir un objet devant être activé comme réaction à l'événement survenu. Dans ce cas, l'agent enregistre toutes les informations du cache que vous pouvez lire dans l'objet événement avec la fonction de script GET_EVENT_INFO, en utilisant des mots-clés. L'objet activé récupère les données via l'instruction de script :READ. Utilisez des mots clés comme noms de variables.
Exemple
:SET &FILENAME# = GET_EVENT_INFO (FILENAME)
:READ &FILENAME#,,
Voir aussi :