Base de connaissances > Automation Engine et systèmes cibles > z/OS > Exit SMF

Exit SMF

Le sous-système SMF recueille et journalise les informations sur le système et ses Jobs.

L'Agent z/OS ainsi que ses moniteurs d'Evènements utilisent les enregistrements SMF dans les domaines suivants :

Evènements de système de fichiers automatiques

Prise en charge des Generation Data Groups

Reconnaissance et analyse de la fin du Job

Parmi les prérequis pour son utilisation, notons que les exits système appropriés doivent être autorisés et que le module SMF doit journaliser certaines entrées. L'Agent et les moniteurs d'Evènements contiennent, dans leur fichier INI, plusieurs paramètres concernant SMF. Dans les descriptions des fonctionnalités citées plus haut, vous trouverez de plus amples informations sur la configuration exacte.

Généralités

Le moniteur d'Evènements surveille les Evènements de console et de système de fichiers et les transmet à l'Automation Engine. Les objets Evènement vous permettent d'y réagir. Le suivi des Evènements n'est effectué que tant que le moniteur d'Evènements est actif. Les Evènements sont recueillis via un exit SMF sur la base des enregistrements SMF. Cet exit est capable de faire office de tampon pour les Evènements, même lorsque le moniteur d'Evènements n'est pas disponible. Après un nouveau démarrage du moniteur d'Evènements, l'exit SMF lui transmet les Evènements recueillis. Cela permet de ne perdre aucun enregistrement SMF, si tant est que le tampon ne soit pas plein. Il est possible de régler la taille du tampon.

Le System Management Facility (SMF) est également utilisé pour d'autres domaines, par exemple la reconnaissance des fins de Job et les GDG.

L'illustration suivante vous montre les interactions entre l'Agent, le moniteur d'Evènements et l'exit SMF.

L'exit SMF enregistre les Evènements dans un Common Area Data Space (CADS). Le taux de remplissage du CADS est indiqué en couleur sur la console z/OS :

25 %, 50 % et 75 % en blanc
80 %, 85 %, 90 %, 95 % et 100 % en rouge

Attention : l'exit SMF n'enregistre aucun autre Evènement lorsque le CADS est entièrement plein. L'entrée d'Evènement la plus ancienne n'est donc pas remplacée. Dès que le CADS a de nouveau de l'espace et que l'exit SMF est capable de transmettre des Evènements au moniteur d'Evènements, des Evènements sont à nouveau enregistrés dans le CADS.

La valeur par défaut pour le CADS est de 10 Mo, ce qui suffit à l'enregistrement d'environ 65 000 Evènements.

Attention : aucun Evènement se produisant durant un démarrage, un arrêt ou une phase IPL n'est recueilli. Les Evènements peuvent être traités dès que le moniteur d'Evènements est démarré.

Configuration

Exécutez les étapes suivantes pour mettre en marche l'exit SMF :

Vérifiez dans votre système z/OS que le sous-système SMF journalise les enregistrements SMF du type 14, 15, 30 et 64 et que les exits IEFU83 ainsi que IEFU84 sont actifs.
L'exit SMF peut s'exécuter comme sous-Tâche de l'Agent ou du moniteur d'Evènements. En fonction de cela, il faut adapter le fichier INI de l'Agent ou celui du moniteur d'Evènements comme suit :

Entrez une désignation pour l'exit SMF dans la section (CONSOLE) pour le paramètre ModuleName=.

Définissez la taille du CADS avec le paramètre SMF_Buffersize=, qui se trouve également dans la section (CONSOLE). La valeur par défaut est de 10 Mo.

Démarrez le moniteur d'Evènements.

Démarrage du moniteur d'Evènements

Utilisez la commande suivante pour démarrer le moniteur d'Evènements ainsi que l'exit SMF :

START nom du moniteur d'Evènements

Fermeture du moniteur d'Evènements

Utilisez les commandes suivantes pour terminer le moniteur d'Evènements et/ou l'exit SMF manuellement :

Commande	Description
MODIFY nom du moniteur d'Evènements,END	Termine le moniteur d'Evènements et l'exit SMF reste actif.
STOP nom du moniteur d'Evènements MODIFY nom du moniteur d'Evènements,SHUTDOWN	Termine le moniteur d'Evènements ainsi que l'exit SMF.
MODIFY nom de l'Agent,SHUTDOWN	Termine tous les moniteurs d'Evènements ainsi que les exits SMF qui sont connectés à l'Agent, puis termine l'Agent lui-même.

Lors de l'interruption du moniteur d'Evènements, l'exit SMF reste toujours actif.

Démarrage à chaud

Lorsque le moniteur d'Evènements est terminé manuellement avec "END", ou qu'il s'interrompt, l'exit SMF reste actif. Après le redémarrage du moniteur d'Evènements, celui-ci peut à nouveau se connecter à l'exit SMF et traiter les Evènements qui se sont accumulés entre-temps.

Attention : les modifications des paramètres ModulName= et SMF_Buffersize= du fichier INI n'ont aucun effet. Leurs valeurs ne seront lues qu'au prochain démarrage de l'exit SMF.

Situations d'exception

En temps normal, pour terminer l'exit SMF, vous devez utiliser la commande "SHUTDOWN" pour terminer le moniteur d'Evènements. Le CADS est ainsi supprimé automatiquement. Vous pouvez également terminer manuellement l'exit SMF :

SET PROG,EXIT,DELETE,EXITNAME=nom de l'exit SMF,MODULNAME=nom du module AE

Attention : ne pas supprimer le CADS ce faisant !

Utilisez l'utilitaire CADSDEL pour supprimer le contenu du CADS :

Ouvrez le fichier log du moniteur d'Evènements. La ligne de log suivante contient les paramètres STOKEN et TCBTOKEN requis pour terminer l'exit SMF :

-UC4 STOKEN=8000160200001328;TCBTOKEN=00000004000000010000000000FD2300

De plus, il faut spécifier le nom du système AE ainsi qu'une description d'Eyecatcher. Les deux valeurs sont spécifiées dans le fichier INI du moniteur d'Evènements :

system= contient le nom du système AE
CADSEyeCatcher= contient la description d'Eyecatcher

Exécutez l'utilitaire CADSDEL avec les quatre paramètres cités :

//CADSDEL JOB ####,PROGRAMMER,NOTIFY=&SYSUID,MSGLEVEL=(1,1)
//CADSDEL EXEC PGM=CADSDEL,
// PARM='8000160200001328 00000004000000010000000000FD2300 UC4PROD UC4EYEC'
//STEPLIB DD DISP=SHR,DSN=<UC4.LOADLIB>

Vérifiez avec la commande z/OS D A,*MASTER* si le CADS a été supprimé.

Scénario d'exemple

Deux LPAR sont présentés dans Sysplex :

Dans le premier se trouvent un Agent et un moniteur d'Evènements. Tous les deux fonctionnent en tant que Started Tasks indépendantes. L'exit SMF est une sous-Tâche du moniteur d'Evènements.
Dans le deuxième, un moniteur d'Evènements fonctionne également avec un exit SMF comme sous-Tâche.

LPAR1	LPAR2
Agent : MVS01
Moniteur d'Evènements : EM01 Exit SMF : SMFE01	Moniteur d'Evènements : EM01 Exit SMF : SMFE01

Les configurations suivantes doivent être exécutées dans le LPAR1 :

Installez un Agent dans le LPAR1 en suivant les instructions d'installation. Etant donné que le moniteur d'Evènements doit fonctionner comme Started Task indépendante avec l'exit SMF, il faut mettre en commentaire l'ensemble de la section (CONSOLE) du fichier INI de l'Agent.

;(CONSOLE)
;start=
;buffersize=
;mscope=
;smfwrite=
;ModulName=
;smfStepFilter=
;smfJob=
;SMF_Buffersize=
;ABENDNUM=

Installez le moniteur d'Evènements dans le LPAR1 en tant que Started Task indépendante. Vous en trouverez une description également dans les instructions d'installation. Etant donné que l'exit SMF est une sous-Tâche du moniteur d'Evènements, la section (CONSOLE) du fichier INI du moniteur d'Evènements doit être adaptée :

(CONSOLE)
mscope=*
smfwrite=1
ModulName=SMFE01
smfStepFilter=0
SMFJob=0
SMF_Buffersize=10

Les configurations suivantes doivent être exécutées dans le LPAR2 :

Installez le moniteur d'Evènements dans le LPAR2 en tant que Started Task indépendante. Etant donné que l'exit SMF est également ici une sous-Tâche du moniteur d'Evènements, la section (CONSOLE) du fichier INI du moniteur d'Evènements doit être adaptée :

(CONSOLE)
mscope=*
smfwrite=1
ModulName=SMFE01
smfStepFilter=0
SMFJob=0
SMF_Buffersize=10

Rubriques connexes :

Moniteur d'Evènements