Rational Developer for System z, Version 7.6

Débogage d'une transaction CICS locale avec TXSeries

Avant de commencer

Afin de préparer le débogage, suivez les étapes ci-dessous pour connaître l'ID processus de votre serveur d'applications CICS :

  1. Dans l'outil d'administration de TXSeries, cliquez sur Sous-système > Terminal CICS.
  2. A l'invite, sélectionnez le serveur CICS correspondant à votre région CICS.
  3. Tapez ce qui suit dans le terminal CICS :
    CEMT INQUIRE TASK

    La sortie de cette commande correspond à l'ID processus de votre serveur d'applications CICS. Vous devez définir une liaison à ce processus dans le cadre du débogage.

Remarque : Ce document décrit le processus de débogage d'une transaction CICS COBOL. Le processus de débogage d'une transaction CICS PL/I est identique. La seule différence réside dans le nom du programme PL/I, qui sera NOM_PROGRAMME.IBMPLI (où NOM_PROGRAMME correspond au nom de votre programme), et non TIMEZONE.IBMCOB.
Vous devez commencer par prendre une "nouvelle copie" du programme. Cette action décharge TIMEZONE.IBMCOB du serveur d'applications CICS. Ouvrez un terminal local pour votre région CICS puis saisissez les éléments suivants :

CEMT SET PROGRAM(TIMEZONE) NEW

Remarque : Vérifiez que vous tapez bien CEMT en majuscule. Sinon, la commande ne fonctionne pas.
Pourquoi et quand exécuter cette tâche

Jonction avec les serveurs CICS.

  1. Ouvrez la perspective Projets z/OS.
  2. Dans le menu déroulant Exécuter, sélectionnez Déboguer.
  3. Sélectionnez Connecter à un processus en cours, puis cliquez sur Nouveau.
  4. Sélectionnez l'onglet Principal. Dans le champ Projets, sélectionnez celui sur lequel vous travaillez.
  5. Cliquez sur Parcourir, situé en regard de la zone d'entrée ID processus. Réduisez toutes les fenêtres de la console Windows® qui s'affichent.
  6. Sélectionnez le premier processus "cicsas.exe" de la liste. Cliquez sur OK.
  7. Cliquez sur Déboguer.
  8. Réduisez toutes les fenêtres de la console Windows qui s'affichent.
  9. Si une fenêtre en incrustation affiche "Aucun texte de message d'erreur disponible", cliquez sur OK.
  10. Important : Répétez ces étapes avec de nouvelles configurations de débogage jusqu'à ce que toutes les instances de cicsas.exe en cours aient été jointes.
Que faire ensuite
Etablissement d'un point d'interruption de chargement du programme exécutable CICS. (Dans ce cas, TIMEZONE.IBMCOB.)
  1. Sélectionnez le premier processus cicsas.exe en cours que vous avez joint.
  2. Cliquez avec le bouton droit de la souris dans la vue Points d'arrêt. Sélectionnez Ajouter un point d'arrêt, puis Charger.
  3. Saisissez TIMEZONE.IBMCOB comme nom de bibliothèque. Cliquez sur Terminer.
Reprise des processus cicsas.exe.
  1. Développez le premier processus cicsas.exe en cours de la liste, s'il ne l'est pas déjà. Avec le bouton droit de la souris, cliquez sur la ligne de texte qui commence par "State:".
  2. Sélectionnez Reprendre.
  3. Répétez ces étapes pour tous les processus cicsas.exe en cours à joindre.
Exécution de la transaction.
  1. Au démarrage du terminal CICS, saisissez : TMZN
  2. Appuyez sur Contrôle (la touche Retour du terminal 3270).
  3. L'exécution du terminal CICS doit s'interrompre. (Aucune flèche ni heure doit s'afficher.)
Sélection du module.
  1. Sélectionnez la vue Modules.
  2. Recherchez puis développez TIMEZONE.IBMCOB.
  3. Développez TIMEZONE.OBJ.
  4. Développez TIMEZONE.cbl.
  5. Dans TIMEZONE.cbl, une image représentant deux engrenages doit apparaître en regard de TIMEZONE. Double-cliquez sur l'image. La source TIMEZONE.cbl s'affiche.
Modification de la source prétraitée.
  1. Avec le bouton droit de la souris, cliquez sur l'écran du code source de TIMEZONE.cbl. Sélectionnez Modifier le fichier texte.
  2. Sélectionnez le fichier TIMEZONE.ppr dans le sous-répertoire BuildOutput de votre projet.
  3. Cliquez sur OK. Une version prétraitée de votre fichier source COBOL s'affiche avec toutes les lignes EXEC CICS développées.
Définition du point d'interruption.
  1. Dans la source TIMEZONE.cbl, définissez un point d'interruption à la première ligne exécutable de la source COBOL.
  2. Dans le menu déroulant Exécuter, sélectionnez Reprendre. Vous pouvez maintenant passer à l'étape suivante pour déboguer votre programme.

Conditions d'utilisation | Commentaires en retour

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