Personnalisation d' z/OS Debugger: liste de contrôle

Remarque : vous pouvez également utiliser l'assistant de configuration hôte d' IBM pour le développement Z afin de générer une liste de contrôle personnalisée pour le débogueur d' z/OS®. Host Configuration Assistant for Z Development est un assistant interactif conçu pour simplifier la planification et la configuration des produits de développement Z. Outre z/OS Debugger, vous pouvez également trouver des informations de configuration pour d'autres composants hôte tels que z/OS Explorer et z/OS Source Code Analysis. Seules les éditions de produit les plus récentes sont prises en charge.
La présente rubrique aide à identifier les tâches de personnalisation à effectuer. Commencez par passer en revue la rubrique Planifier votre session de débogage dans le guide de l'utilisateur du débogueur IBM z/OS avec vos programmeurs d'application et l'administrateur du système de bibliothèque. Vous pourrez ainsi identifier les tâches de personnalisation à effectuer en déterminant :
  • La version des compilateurs utilisés
  • Si vous déboguez les programmes Db2®, Db2 , CICS®et IMS
  • Si vous utilisez le mode plein écran, le mode plein écran à l'aide de Terminal Interface Manager, le mode de traitement par lots ou le mode de débogage à distance
  • Comment vos programmes appelleront z/OS Debugger
  • Que vous utilisiez les utilitaires du débogueur IBM® z/OS, les composants communs ADFz ou les outils Application Delivery Foundation for z/OS
  • Indique si vous devez modifier certains comportements du débogueur

Après avoir rassemblé ces informations, consultez les listes de contrôle ci-dessous. En lisant chaque élément d'une liste de contrôle, utilisez les informations que vous avez rassemblées pour déterminer si vous devez effectuer la tâche de personnalisation concernée. Si la tâche n'est pas applicable à votre site, vous pouvez l'ignorer.

Vous devez effectuer toutes les tâches de personnalisation obligatoires suivantes :
Si vous utilisez IBM z/OS Debugger Utilities, vous devez effectuer les tâches de personnalisation décrites dans les rubriques suivantes :Si vous utilisez l'un des utilitaires suivants dans IBM z/OS Debugger Utilities, vous devez effectuer une tâche de personnalisation supplémentaire :
Si vous déboguez des procédures stockées Db2 , un programme CICS ou des programmes IMS , vous devez effectuer les tâches de personnalisation requises suivantes:
Dans Debug Tool version 13.1, les modules EQALANGP et EQALANGX avaient été déplacés de la bibliothèque EQAW.SEQAMOD de Debug Tool vers la bibliothèque IPV.SIPVMODA de Common Component, dans laquelle ils seront respectivement les alias d'IPVLANGP et d'IPVLANGX. Cette opération permet de supprimer la duplication entre les deux outils. Si vous disposez de processus de constitution de bibliothèque ou d'autres outils référençant l'une de ces routines et que IPV.SIPVMODA ne figure pas dans la liste de liens, vous devez mettre à jour vos processus de sorte qu'ils pointent vers le nouvel emplacement de ces routines. Pour plus d'informations sur EQALANGX, consultez les sections « Préparation d'un programme d' LangXCOBOL » et « Préparation d'un programme d'assemblage » du guide de personnalisation du débogueur IBM z/OS.
Remarque: Debug Tool for z/OS est désormais nommé z/OS Debugger et Problem Determination Tools for z/OS Common Component est désormais nommé IBM Application Delivery Foundation for z/OS Common Components.

Au fur et à mesure que vous passez en revue le reste de la liste de contrôle, si vous devez effectuer une opération nécessitant la spécification d'une commande EQAOPTS, vous pouvez imprimer une copie de la liste de contrôle et l'utiliser pour enregistrer les commandes que vous devez spécifier et les valeurs des options. Lorsque vous avez terminé de passer en revue la liste de contrôle, vous pouvez spécifier toutes les commandes EQAOPTS en une seule fois, comme décrit dans la rubrique Création d'un module chargeable EQAOPTS.

Pour les situations suivantes, voir CODEPAGE:
  • Les programmeurs d'application déboguent en mode de débogage à distance et le code source ou le compilateur utilise une page de codes autre que 037. Si votre source C/C++ contient des crochets ou d'autres caractères spéciaux, vous devrez peut-être spécifier une commande EQAOPTS CODEPAGE pour remplacer la page de codes par défaut z/OS Debugger (037). Vérifiez la page de codes définie lorsque vous avez compilé votre source. Le compilateur C/C++ utilise la page de codes par défaut 1047 si vous n'en définissez pas une explicitement. Si la page de codes utilisée est 1047 ou une page de codes autre que 037, vous devez spécifier une commande EQAOPTS CODEPAGE définissant cette page de codes.
  • Les programmeurs d'application déboguent en mode plein écran et se trouvent dans l'une des situations suivantes :
    • Ils utilisent la commande STORAGE pour mettre à jour les variables COBOL NATIONAL.
  • Les programmeurs d'application utilisent le paramètre XML(CODEPAGE(ccsid)) sur une commande LIST CONTAINER ou LIST STORAGE pour spécifier une page de codes secondaire.
Effectuez les tâches de personnalisation indiquées dans la liste suivante uniquement si votre site a besoin des fonctions décrites :
  • Ces commandes EQAOPTS activent certaines fonctions z/OS Debugger :
    • ALTDISP
      Vous souhaitez que z/OS Debugger affiche le signe arobase (@) dans la zone de préfixe d'une ligne pour indiquer que la ligne contient un point d'arrêt, au lieu d'utiliser une ligne de couleur.
    • PARCOURIR
      Vous souhaitez restreindre l'accès à Débogueur z/OS ou contrôler quels utilisateurs1 doivent déboguer en mode consultation.
    • DLAYDBG
      Vous souhaitez autoriser les utilisateurs à utiliser le mode de débogage retardé.
    • EQAQPP
      Votre site doit déboguer les programmes Q + +.
    • IGNOREODOLIMIT
      Vous souhaitez indiquer au débogueur z/OS d'afficher les éléments du tableau COBOL même lorsqu'une valeur ODO est hors plage.
    • LOGDSNALLOC
      Vous souhaitez que z/OS Debugger crée automatiquement un fichier LOG pour chaque utilisateur.
    • MDBG
      Votre site utilise z/OS XL C/C++, version 1.10, ou ultérieure, et vous souhaitez que z/OS Debugger extraie les informations source et de débogage des fichiers .mdbg .
    • SAVESETDSNALLOC, SAVEBPDSNALLOC
      Vous souhaitez que z/OS Debugger crée automatiquement l'un des fichiers suivants:
      • Un fichier de sauvegarde et restauration de paramètres
      • Un fichier de sauvegarde et restauration de points d'arrêt, de valeurs de moniteur et de spécifications LOADDEBUGDATA (LDD)
    • STARTSTOPMSG
      Vous souhaitez que z/OS Debugger émette un message lorsque chaque session de débogage est lancée ou arrêtée.
    • SUBSYS
      Si votre site utilise un système de bibliothèque qui utilise le paramètre d'allocation SUBSYS et que les programmeurs de votre application déboguent des programmes C, C++ ou Enterprise PL/I examinez cette commande pour déterminer si vous devez modifier le paramètre SUBSYS.
    • SVCSCREEN
      Vous devez déboguer les programmes non- Language Environment s qui démarrent sous Language Environment, les programmes Language Environment qui utilisent les services LINK, LOAD ou DELETE d' MVS, les programmes LangX COBOL, ou si votre site dispose de produits hôtes susceptibles d'utiliser le filtrage SVC lorsque le débogueur d' z/OS s est lancé.
  • Si votre site utilise l'une des fonctions suivantes dans un environnement japonais ou coréen, voir Activation de langues supplémentaires pour certains composants z/OS Debugger via EQACUIDF:
    • IBM z/OS Debugger Utilities ISPF panneaux
    • Couverture de codez/OS Debugger
    • EQANMDBG (support non CICS non compatible Language Environment)
Effectuez les tâches de personnalisation indiquées dans la liste suivante uniquement pour modifier le comportement décrit :
  • Ces commandes EQAOPTS modifient le comportement de certaines fonctions z/OS Debugger :
    • CACHENUM
      Vous souhaitez réduire la consommation d'UC de z/OS Debugger dans certains cas.
    • CEEREACTAFTERQDBG
      Vous souhaitez redémarrer z/OS Debugger avec CEETEST après avoir utilisé QUIT DEBUG.
    • COMMANDSDSN
      Vous souhaitez modifier le nom de fichier par défaut du fichier de commandes de l'utilisateur.
    • DEFAULTVIEW
      Vous souhaitez modifier le paramètre par défaut de SET DEFAULT VIEW afin que les instructions générées par la macro assembleur ne s'affichent pas dans la fenêtre Source.
    • DLAYDBGCND
      Vous souhaitez modifier le paramètre de débogage retardé par défaut pour les événements de condition de surveillance.
    • DLAYDBGDSN
      Vous souhaitez modifier le nom par défaut du fichier de profil de débogage retardé.
    • DLAYDBGTRC
      Vous souhaitez modifier le niveau de message de trace de correspondance de modèle de débogage retardé par défaut.
    • DLAYDBGXRF
      Vous souhaitez demander au débogage retardé d'utiliser le fichier de références croisées pour rechercher l'ID utilisateur lors de la construction du nom de fichier de profil de débogage retardé.
    • DTCNDELETEDEADPROF
      Vous souhaitez modifier le paramètre par défaut permettant de contrôler la suppression des profils DTCN morts.
    • DTCNFORCExxxx
      Vous souhaitez modifier le comportement DTCN par défaut pour certains types de ressource.
    • DYNDEBUG
      Vous souhaitez modifier la valeur initiale ou par défaut de SET DYNDEBUG.
    • GPFDSN
      Votre site souhaite contrôler l'apparence ou les paramètres, via les commandes z/OS Debugger , de toutes les sessions de débogage, et créer un fichier de préférences globales. Le fichier de préférences globales est un fichier qui est traité au début de chaque session de débogage et qui contient des commandes z/OS Debugger . Reportez-vous à ces commandes pour savoir comment créer un fichier de préférences globales.
    • PORTS
      HÔTE Vos utilisateurs utilisent le débogueur à distance et vous devez spécifier un port hôte ou une plage de ports pour permettre une connexion via le protocole TCP/IP entre l'hôte et la station de travail.
    • LOGDSN
      Vous souhaitez modifier le nom de fichier par défaut du fichier LOG.
    • MAXTRANUSER
      Vous souhaitez utiliser la fonction d'isolement de transaction IMS décrite dans Ajout de la prise en charge du débogage sous IMS, et vous devez définir le nombre maximal de transactions qu'un seul utilisateur peut déboguer sur une valeur inférieure à 15.
    • MULTIPROCESS
      Vous souhaitez modifier le comportement par défaut d' z/OS Debugger lorsqu'un nouveau processus POSIX est créé par une fonction fork () ou exec ().
    • NAMES
      Votre site doit émettre une commande NAMES pour le module de chargement initial ou l'une de ses unités de compilation.
    • NODISPLAY
      Pour modifier le comportement du débogueur lorsqu'un mode plein écran utilisant Terminal Interface Manager ou un débogueur distant n'est pas disponible.
    • PREFERENCESDSN
      Vous souhaitez modifier le nom de fichier par défaut du fichier de préférences de l'utilisateur.
    • SAVEBPDSN, SAVESETDSN
      Votre site souhaite modifier les noms par défaut, userid.DBGTOOL.SAVESETS et userid.DBGTOOL.SAVEBPS, des fichiers qui stockent les paramètres, les points d'arrêt et les valeurs de surveillance.
    • SESSIONTIMEOUT
      Vous souhaitez spécifier un délai d'inactivité de session pour les utilisateurs qui utilisent Terminal Interface Manager.
    • STARTSTOPMSGDSN
      Vous souhaitez que z/OS Debugger consigne des informations dans un fichier journal lorsque chaque session de débogage nonCICS est lancée ou arrêtée.
    • TCPIPDATADSNVos
      utilisateurs utilisent le débogueur distant et votre hôte TCP/IP ne dispose pas d'une spécification pour GLOBALTCPIPDATA.
    • THREADTERMCOND
      Votre site souhaite que le débogueur d' z/OS s supprime l'invite qui Language Environment s'affiche à chaque fois que des instructions telles que STOP RUN, GOBACK ou EXEC CICS RETURN sont exécutées. Ces instructions sont fréquentes dans un programme d'application, ce qui crée des interruptions non nécessaires pour un utilisateur qui tente de déboguer le programme d'application.
    • TIMACB
      Vous souhaitez modifier le nom ACB par défaut du moniteur d'interface de terminal.
  • Si votre site utilise l'exit utilisateur EQAUEDAT pour diriger z/OS Debugger vers l'emplacement de la source, la liste ou des fichiers de débogage distincts, voir Activation de l'exit utilisateur EQAUEDAT.
  • Si votre site doit modifier les valeurs par défaut pour NATLANG, LOCALE ou LINECOUNT, voir Modification des valeurs par défaut et autorisées dans EQACUIDF.
données au repos
z/OS Debugger ne fournit aucun moyen de chiffrer ses fichiers de configuration ou de données. Pour des environnements plus sûrs, il faut envisager le chiffrement au niveau du système d'exploitation, du disque ou du système de fichiers. Pour une configuration possible de z/OS, voir Utilisation des améliorations du chiffrement de l'ensemble des données de z/OS.
1 Si vous souhaitez appliquer des restrictions de mode consultation, vous devez utiliser le profil de classe de fonction RACF comme décrit dans la rubrique Installation de la fonction RACF en mode consultation. Vous pouvez apprendre comment la commande EQAOPTS BROWSE fonctionne avec les profils RACF en consultant le tableau de la rubrique Contrôle du mode navigation du Guide de l'utilisateur du débogueur IBM z/OS.