Surveiller un mainframe IBM z avec Dynatrace : trois décisions avant l’installation

Surveiller un mainframe IBM z avec Dynatrace : zDC, modules CICS et IMS, versions z/OS prises en charge, coût en MSU et filtres de transactions à régler.
Surveiller un mainframe IBM z avec Dynatrace : trois décisions avant l'installation

Un paiement part du navigateur, traverse trois microservices, puis disparaît dans une transaction CICS que personne ne voit. Pour garder ce paiement sous contrôle, il faut décider comment surveiller un mainframe IBM z avant d’installer quoi que ce soit : quelles partitions, quelles régions, quelles transactions, et à quel coût. Cet article part de ces décisions d’exploitation.

Les faits viennent de la documentation officielle de Dynatrace sur z/OS et du billet de l’éditeur sur le mainframe IBM z17, lus le 12 novembre 2026. Je n’ai pas accès à un mainframe : je n’ai rien installé, et ce qui n’est pas vérifié est signalé comme tel.

Pour la suite des appels côté distribué, voir les Distributed traces et PurePath. Le module mainframe prolonge ces traces, il ne les remplace pas.

Le problème : la trace s’arrête à la porte du mainframe IBM z

Une trace distribuée suit une requête de service en service. Or, côté mainframe, la requête entre dans une région CICS ou IMS, déclenche des appels Db2 ou MQ, puis ressort. Sans instrumentation dédiée, ce segment reste une boîte noire. Résultat : le temps de réponse monte, et personne ne sait si la faute vient du front, d’une API ou du cœur transactionnel.

Le billet de l’éditeur présente la surveillance mainframe comme un suivi de bout en bout, du front web jusqu’au cœur de l’IBM z17, avec une vue unifiée du hybride. Il cite aussi les processeurs Telum II et l’accélérateur Spyre de la machine. Ce billet reste un texte de présentation : il ne donne ni version, ni prérequis, ni chiffre. Pour l’exploitation, la documentation fait foi.

Comment les données quittent le mainframe

La documentation décrit une chaîne en quatre maillons. Elle explique pourquoi l’installation se fait par partition (LPAR) et non par application.

  • Des modules de code pour CICS, IMS et z/OS Java écrivent leurs mesures dans un objet de mémoire partagée (SMO) de la LPAR.
  • Le sous-système zDC (Dynatrace z/OS Data Collection) gère cet objet.
  • zLocal, qui tourne dans z/OS UNIX System Services au sein du zDC, lit le SMO et le transmet à zRemote.
  • zRemote envoie les données compressées et chiffrées à Dynatrace via son ActiveGate local.

Ce découpage a une conséquence pratique : le travail de traitement se fait hors des sous-systèmes instrumentés. La documentation indique que CICS s’instrumente par des hooks et IMS par la lecture de ses journaux binaires, sans instrumentation de bytecode. Elle indique un surcoût de temps CPU généralement de 1 à 2 %, mesuré sur les espaces d’adressage surveillés. C’est un chiffre de l’éditeur : mesurez-le chez vous.

Pour comprendre le rôle de l’ActiveGate dans cette chaîne, lisez le comparatif ActiveGate environnement ou cluster.

Décision 1 : vérifier que votre mainframe est couvert

Avant tout, comparez votre version aux listes de la page « Mainframe technology support ». À la date de lecture, elle indique :

  • z/OS 2.3, 2.4, 2.5, 3.1 et 3.2 ;
  • CICS Transaction Server de 5.1 à 6.3 ;
  • IMS 13, 14 et 15 (le suivi des transactions Fast Path et BMP n’existe que pour IMS 15) ;
  • Db2 11, 12 et 13 ;
  • pour le Java : IBM JVM 8 et IBM Semeru 11, 17, 21 et 25.

La page ne mentionne pas le matériel z17 en tant que tel. Elle ne parle pas non plus de SaaS ni de Managed. Je ne peux donc pas affirmer ce qui vaut pour l’un ou l’autre ; demandez-le à votre contact Dynatrace avant de planifier.

Décision 2 : le coût se compte en MSU

Les modules CICS, IMS et z/OS Java sont facturés en millions d’unités de service (MSU). Le modèle Platform Subscription l’appelle « Mainframe Monitoring » ; l’ancien modèle de licence parle de « Mainframe Monitoring on IBM z/OS », fondé sur les host units. Un point d’exploitation compte : depuis OneAgent 1.315, le suivi est suspendu si la métrique host.zos.msu_hours n’arrive pas pendant 12 heures d’affilée. Une coupure réseau prolongée vers zRemote a donc un effet sur la trace, pas seulement sur la facturation.

Installer sans surprise : l’ordre qui compte

Voici les étapes de la documentation, dans l’ordre où je les poserais sur un planning de changement.

  1. Télécharger les datasets z/OS et noter le qualificatif de haut niveau (<hlq>).
  2. Créer l’utilisateur RACF du zDC, avec un segment USS (répertoire recommandé : /u/dt).
  3. Exécuter le job COPYAGNT de SZDTSAMP, puis copier le binaire dtzagent.
  4. Autoriser APF la bibliothèque <hlq>.SZDTAUTH.
  5. Copier la procédure ZDCMEPC (nom par défaut du sous-système : MEPC) et renseigner DTAGTCMD() avec l’adresse de zRemote.
  6. Vérifier l’exit SMF : U86 à partir d’OneAgent 1.300, exigé pour les métriques de licence et pour z/OS 2.3 ou plus.
  7. Lancer la procédure ZDCIVP pour tester la connexion.
Extrait rendu de la documentation Dynatrace : membre ZDCSYSIN avec SUBSYSTEM_ID MEPC et DTAGTCMD pointant vers dtzagent avec nobootstrap=false et l'adresse zremote
Source : docs.dynatrace.com

Le zDC doit tourner comme tâche démarrée autorisée, lancée à l’IPL, avec une priorité supérieure à celle des régions CICS et IMS surveillées. Une seule instance par LPAR est prévue. Après toute modification de ZDCSYSIN, redémarrez le zDC.

Brancher CICS région par région

Côté CICS, on déclare la bibliothèque SZDTLOAD dans la concaténation DFHRPL, puis on définit les ressources avec le membre CICRDO et l’utilitaire DFHCSDUP. Le programme ZDTPLT s’ajoute à la table PLTPI et ZDTPLTSD à la table PLTSD. Une région CICS 6.2 demande en plus que le module DFHBPZDT soit disponible au démarrage.

Récapitulatif rendu à partir de la documentation Dynatrace : paramètre INITPARM=(ZDTPLT='MEPC,SEVERE') et ordre des programmes ZDTPLT en PLTPI et ZDTPLTSD en PLTSD
Source : docs.dynatrace.com

Le module se connecte au zDC par défaut au démarrage. Si le zDC n’est pas actif, le journal du job affiche ZDTP004W. Démarrez alors le zDC puis lancez la transaction DTAX avec l’option ENABLE.

Décision 3 : quelles transactions tracer

C’est le réglage qui change le plus le résultat. Dynatrace trace automatiquement les transactions lancées par un service surveillé, par CICS Transaction Gateway, par z/OS Connect EE ou par IBM MQ. Celles qui démarrent sur un terminal ou chez un service non surveillé doivent être listées.

  • Le filtre de démarrage terminal accepte le joker * et exige la fonction « z/OS CICS terminal transaction sensor » (ou son équivalent IMS).
  • Le filtre de démarrage CICS n’accepte le joker qu’en suffixe, jamais seul. N’utilisez pas C* : il capture les transactions internes de CICS.
  • Une transaction listée puis appelée par MQ, SOAP ou HTTP crée une nouvelle trace non reliée.

Les réglages se trouvent dans Settings > Mainframe. La limite de nœuds d’un PurePath distribué y vaut 500 par défaut ; la valeur 0 la supprime, au prix d’un surcoût de traitement. Gardez aussi à l’esprit que les modules ne capturent que le SQL statique, pas le SQL dynamique.

Comment vérifier que ça fonctionne

Contrôlez trois endroits : le SYSPRINT du zDC, le journal de la région CICS et le journal de zRemote.

Récapitulatif rendu à partir de la documentation Dynatrace : messages attendus ZDC000I, ZDC958L, la commande MODIFY DT1 STDO, puis ZDTP008I et ZDTP020I Active Sensors
Source : docs.dynatrace.com

Le message ZDC958L confirme que le zDC a reçu son identifiant d’agent. Dans le journal de zRemote, ZDTP008I donne la version du module et ZDTP020I la liste des capteurs actifs. Attention à la compatibilité : la version du module CICS doit être inférieure ou égale à celle de zRemote.

Pour interroger ensuite vos données, les bases du langage sont dans les commandes DQL filter, summarize et timeseries. Je n’ai pas vérifié quels champs mainframe y sont exposés.

Bonnes pratiques

  • Commencez par une LPAR de test et une région CICS, puis étendez.
  • Listez vos transactions d’entrée métier avant d’ouvrir les filtres : évitez * en production.
  • Surveillez la métrique host.zos.msu_hours : son absence suspend le suivi.
  • Utilisez les host groups pour regrouper plusieurs LPAR.
  • Mesurez le surcoût CPU chez vous avant de généraliser.

Questions fréquentes

Faut-il un mainframe IBM z17 pour utiliser cette surveillance ?

Je ne l’ai pas vérifié. La page de support liste des versions de z/OS, de CICS et d’IMS, pas des modèles de machine. Vérifiez auprès de l’éditeur pour votre matériel.

Le SQL dynamique est-il visible ?

Non. Les modules CICS et IMS ne capturent que le SQL statique, d’après la documentation.

Cela fonctionne-t-il en SaaS et en Managed ?

Les pages lues n’en parlent pas. Je ne peux donc pas trancher ; ne présumez rien et confirmez avant de dimensionner l’ActiveGate.

Conclusion

Surveiller un mainframe IBM z revient à trois choix : la couverture de vos versions, le coût en MSU et la liste des transactions tracées. Le reste est une installation par LPAR, à tester d’abord sur un périmètre réduit. Sources : documentation Dynatrace pour z/OS, support technologique mainframe.

span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC ni à IBM. Les marques citées appartiennent à leurs propriétaires. Les produits évoluent vite : vérifiez les versions et options dans la documentation officielle.

Total
0
Shares
Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Previous Post
Logs volumineux Dynatrace : limites, support natif et bonnes pratiques

Logs volumineux Dynatrace : limites, support natif et bonnes pratiques

Next Post
Alertes GitHub Advanced Security : prioriser avec le contexte runtime

Alertes GitHub Advanced Security : prioriser avec le contexte runtime

Related Posts