Rational Developer for System z

Création d'une configuration de débogage pour une application CICS

Vous pouvez créer une configuration de débogage à activer comme profil DTCN qui stocke les informations permettant d'appeler le débogueur CICS.

Avant de commencer

La prise en charge des configurations de débogage CICS requiert les logiciels suivants :

Avant de créer une configuration de débogage pour CICS, vous devez avoir défini au moins une connexion CICS.

Certaines zones de l'assistant Configuration de débogage CICS sont spécifiques à la version d'IBM Debug Tool utilisée sur votre site. Utilisez la page de préférences Configuration de débogage CICS pour spécifier la version d'IBM Debug Tool.

Pourquoi et quand exécuter cette tâche

Vous pouvez créer une configuration de débogage CICS à partir des vues suivantes :
  • Projets z/OS
  • Vues CICS Explorer (Programmes ou Transactions)
  • Explorateur de projets Enterprise Service Tools
Rational Developer for System z permet de créer plusieurs configurations de débogage et de les stocker sur votre client. Sur le système distant, un seul profil de débogage peut être actif à la fois. L'activation de l'une des configurations de débogage sur le client active le profil distant et désactive toutes les autres configurations sur le client.

Pour créer une configuration de débogage CICS :

Procédure

  1. Pour démarrer l'assistant de configuration de débogage CICS :
    Option Description
    A partir de cet environnement : Effectuez les étapes suivantes :
    Menu Débogage Cliquez sur l'icône de débogage (icône Débogage), puis sélectionnez Configurations de débogage.
    Vue des projets z/OS Sélectionnez un projet z/OS, puis sélectionnez Débogage CICS > Configurations de débogage dans le menu contextuel.
    Vues CICS Explorer (Programmes ou Transactions) Sélectionnez des programmes ou une transaction, puis sélectionnez Déboguer > Configurations de débogage.
    Explorateur de projets Enterprise Service Tools Sélectionnez un projet Single Service (XSE) Web Services for CICS ou un flux SFM, puis sélectionnez Déboguer > Configurations de débogage.
    L'assistant Configurations de débogage s'ouvre
  2. Dans la liste de gauche, cliquez sur Application CICS distante à l'aide du bouton droit de la souris et sélectionnez Nouveau. L'assistant de configuration de débogage CICS s'ouvre.
  3. Entrez un nom pour la nouvelle configuration de débogage dans la zone Nom.
  4. Renseignez les zones requises et celles facultatives dans l'assistant et cliquez sur Appliquer pour sauvegarder la configuration. Une fois que vous avez cliqué sur Appliquer, la nouvelle configuration est sauvegardée sur le client et le profil de débogage distant est créé ou mis à jour. Le bouton Déboguer reste désactivé car cet assistant ne permet pas d'exécuter la transaction CICS. Cet assistant contient quatre pages à onglets : CICS, Options de débogage, Connexions et Options avancées. Le tableau ci-après décrit les zones de chaque page.
    Tableau 1. Zone de l'assistant Configuration de débogage CICS
    Page Zone Description
    CICS Région CICS cible Sélectionnez le nom de la région CICS. Vous devez avoir défini au moins une connexion CICS pour pouvoir afficher les régions CICS. Cette zone est requise.
      Nom de la transaction Spécifiez la transaction CICS à déboguer. Cette zone ou la zone Nom du programme est requise.
      Nom du programme Spécifiez le ou les programmes à déboguer. Cette zone ou la zone Nom de transaction est requise.
    Remarque : Cette option apparaît si votre site exécute IBM Debug Tool version 9.1 sur le système distant. Utilisez la page de préférences Configuration de débogage CICS pour spécifier la version d'IBM Debug Tool. Pour ouvrir cette page des préférences, cliquez sur le lien Préférences.
      Module de chargement et unité compilée Spécifiez la ou les combinaisons de noms de module de chargement et d'unité compilée à déboguer. Cette zone ou la zone Nom de transaction est requise. Utilisez les boutons Ajouter, Editer et Supprimer pour spécifier la combinaison de noms de module de chargement et d'unité compilée à déboguer.
    Remarque : Cette option apparaît si votre site exécute IBM Debug Tool version 10.1 sur le système distant. Utilisez la page de préférences Configuration de débogage CICS pour spécifier la version d'IBM Debug Tool. Pour ouvrir cette page des préférences, cliquez sur le lien Préférences.
      ID utilisateur Spécifiez l'ID utilisateur associé à la transaction à déboguer.
      Nom du réseau Spécifiez le nom de quatre caractères d'un terminal CICS ou d'un système CICS à utiliser pour exécuter votre session de débogage.
      IP Nom IP ou adresse IP du client associé à une application CICS. Tous les noms IP sont traités comme des noms en majuscule. Vous pouvez spécifier des caractères génériques (* et ?). Debug Tool est appelé pour chaque tâche démarrée pour le client.
      Activation du profil Sélectionnez l'un des boutons d'option pour activer ou désactiver le profil actuel :
    • Activer cette configuration comme profil de débogage sur le système distant
    • Désactiver cette configuration
    Vous pouvez créer plusieurs configurations de débogage CICS sur le client, mais un seul profil associé à votre ID utilisateur peut être actif sur le système distant. Lorsque vous activez une configuration de débogage, toutes les autres sont automatiquement désactivées.
    Options de débogage Option de test Spécifiez TEST ou NOTEST. Cette option indique les conditions dans lesquelles IBM Debug Tool assure le contrôle pendant l'initialisation de l'application.
      Niveau de test Spécifiez ALL, ERROR ou NONE. Cette option indique les conditions à remplir pour qu'IBM Debug Tool prenne le contrôle.
      Fichier de commandes Nom complet et valide du fichier représentant le fichier de commandes principal de cette exécution. N'entourez pas ce nom de guillemets (") ou d'apostrophes (').
      Niveau d'invite Indique si IBM Debug Tool est lancé à l'initialisation de Language Environment.
      Fichier de préférences Nom complet et valide du fichier représentant le fichier de préférences à utiliser. N'entourez pas ce nom de guillemets (") ou d'apostrophes (').
      Options Language Environment Autres options Language Environment valides. Vous pouvez modifier toutes les options Language Environment que le site vous permet de les remplacer, à l'exception de l'option STACK. Pour plus d'informations sur les options Language Environment, voir le document z/OS Language Environment Programming Reference ou adressez-vous au programmeur système CICS.
    Connexion IP du poste de travail Adresse IP ou nom d'hôte du poste de travail qui doit apparaître dans les écrans de débogage. Cette zone est remplie automatiquement en utilisant l'API Java (InetAddress) pour extraire l'adresse TCP/IP du client. Il est possible que l'API ne parvienne pas à indiquer l'adresse IP correcte, notamment si vous utilisez des pare-feu doubles et des configurations NAT. Si l'adresse IP correcte n'est pas enregistrée, vous devez mettre à jour la valeur manuellement.
      Port Indique le numéro de port TCP/IP qui écoute les sessions de débogage sur votre poste de travail. Le port par défaut est 8001. Le numéro de port est extrait à l'aide de l'API du client IBM Debug Tool (c'est-à-dire le port du démon de débogage indiqué dans la page de préférences Démon de débogage).
    Avancé Décalage Zone de communication Décalage des données d'une zone COMMAREA transmis à un programme lors de l'appel. Le décalage peut être exprimé au format alphanumérique (par exemple 12) ou hexadécimal (par exemple X'C').
      Données Zone de communication Masque de données à comparer à une zone COMMAREA transmis à un programme lors de l'appel. Le masque de données peut être exprimé au format alphanumérique (par exemple, ABC) ou hexadécimal (par exemple X'C1C2C3') avec un nombre de chiffres pair.
      Nom du conteneur Le nom d'un conteneur dans le canal en cours a été transmis à un programme lors de son appel. Le nom du conteneur est sensible à la casse.
      Décalage Conteneur Décalage des données du conteneur indiqué transmis à un programme lors de l'appel. Le décalage peut être exprimé au format alphanumérique (par exemple 12) ou hexadécimal (par exemple X'C').
      Données Conteneur Un masque de données devant correspondre à un conteneur du canal en cours a été transmis à un programme lors de son appel. Le masque de données peut être exprimé au format alphanumérique (par exemple, ABC) ou hexadécimal (par exemple X'C1C2C3') avec un nombre de chiffres pair.
      Débogage URM Option qui indique si le débogage des URM doit être inclus dans le cadre de la session de débogage.

Conditions d'utilisation | Commentaires

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)