Pour pouvoir déboguer l'application, vous devez exécuter un petit nombre d'opérations sur la machine System
z.
Pourquoi et quand exécuter cette tâche
Ces étapes sont les suivantes :
Procédure
- Contactez votre administrateur système pour vérifier que Debug Tool pour z/OS dispose de suffisamment
de mémoire pour exécuter et déboguer votre application. Vous pouvez modifier la taille
de la région (par exemple, REGION=0M) pour assurer que la mémoire est
suffisante. Vérifiez également que la classe de travail exécutée par votre application peut
s'exécuter dans cette taille de région et que le temps de réponse que prendra
la session de débogage est autorisé.
- Si vous effectuez le débogage d'une transaction CICS, un administrateur CICS doit définir la taille de la mémoire, l'activation de la transaction
et l'accès de fichier. Si Debug Tool est installé et disponible pour votre région
CICS, ces étapes sont
déjà résolues. Contactez votre administrateur CICS pour toute modification. Pour plus de détails, voir le chapitre Adding support for debugging under CICS dans le manuel Customization Guide
de Debug Tool pour z/OS.
- Assurez-vous que vous disposez des droits d'accès et de lecture nécessaires pour l'exécutable IBM® Debug Tool
pour z/OS
(SEQAMOD).
- Assurez-vous que vous disposez des droits d'accès à la source de l'unité compilée
que vous déboguez. La source à laquelle vous devez accéder dépend du langage de programmation,
des options du compilateur et de sa version. La section Preparing
your program for debugging dans le guide d'utilisation de Debug Tool pour z/OS décrit, par langage de
programmation, les fichiers auxquels vous devez accéder.
- Assurez-vous que vous disposez de l'adresse IP et du nom d'hôte, y compris le numéro de port
de l'ordinateur qui exécutera l'interface utilisateur du débogueur. Vous devez disposer de ces
informations lorsque vous écrivez les options d'exécution TEST qui permettront de lancer la
session de débogage. Pour obtenir l'adresse IP de la machine client depuis l'interface utilisateur du débogueur, accédez à la vue Débogage et cliquez sur la flèche Bas à droite de l'icône de démon et sélectionnez Obtenir l'adresse IP du poste de travail dans le menu. La boîte de dialogue Obtenir l'adresse IP du poste de travail s'ouvre en indiquant l'adresse IP en cours de la machine client. Vous pouvez sélectionner l'adresse IP dans cette boîte de dialogue et la copier et la coller dans un JCL.
Remarque : Si le poste de travail est doté de plusieurs cartes LAN ou qu'il existe un routeur ou un réseau VPN (Virtual Private Network) entre le poste de travail et le serveur, cette boîte de dialogue contient plusieurs adresses IP. Il peut être nécessaire de tester chaque adresse IP pour identifier l'adresse qu'utilise le serveur.
- Vérifiez que l'adresse IP que vous utilisez dans le paramètre TCPIP& de l'option d'exécution TEST correspond à l'adresse IP de la machine qui exécute le débogueur de langage compilé. Vérifiez également que le numéro de port dans le paramètre TCPIP& de l'option d'exécution TEST correspond au numéro de port (ou à la plage de numéros de port défini dans la zone Port du démon de la page des préférences du démon de débogage) utilisé dans l'interface utilisateur du débogueur.
Par défaut, le démon du débogueur écoute le port 8001. Pour définir l'adresse IP et le numéro de port de débogage de System
z, utilisez le paramètre TCPIP& dans la position de paramètre preferences_file de l'option d'exécution TEST (sous la forme TCPIP&tcpip_workstation_id%port_id:).
Vous pouvez définir le port ou la plage de ports du démon de l'interface utilisateur dans la boîte de dialogue
Modifier le port du démon ou dans les préférences du débogueur.
- Veillez à suivre les instructions appropriées décrites dans la section Starting Debug Tool du guide d'utilisation Debug Tool for z/OS. Cette section
contient les instructions pour démarrer les programmes qui s'exécutent dans différents environnements.
- Si vous effectuez le débogage de code d'assembleur, vous devez utiliser la commande LOADDEBUGDATA (LDD)
pour chaque unité de compilation à déboguer (utilisez la commande pour charger EQALANGX).
- Si vous exécutez le débogueur de langage compilé sur Windows Server 2008, veillez à ajouter une "nouvelle règle" ou à activer les connexions entrantes pour que le port (8001 généralement) puisse communiquer via le pare-feu.