Recherche du fichier source

Lorsque vous déboguez une application, le moteur de débogage recherche la source pour l'application, ou vous pouvez spécifier l'emplacement de la source dans l'interface utilisateur du débogueur. Lorsque le débogueur ne trouve pas la source, vous disposez de plusieurs options pour la rechercher.

Pourquoi et quand exécuter cette tâche

Lorsque le débogueur ne trouve pas le fichier source, l'éditeur du débogueur s'ouvre sans afficher la source ; toutefois, il contient des options qui permettent de le rechercher. L'une de ces options, le bouton de commande Modifier le chemin de recherche des fichiers source ouvre la boîte de dialogue Modifier le chemin de recherche des fichiers source dans laquelle vous pouvez sélectionner le type d'emplacement de fichier source à ajouter. Vous pouvez également modifier la liste des emplacements de fichier source en cliquant avec le bouton droit de la souris sur un cadre de pile ou une unité d'exécution dans la vue Débogage et en sélectionnant l'action Modifier le chemin de recherche des fichiers source.

Remarque : Pour plus d'informations sur l'utilisation d'un fichier source, voir le guide d'utilisation Debug Tool for z/OS.

Modification de la liste des emplacements du code source

Pourquoi et quand exécuter cette tâche

Une fois que vous avez lancé un session de débogage, vous pouvez modifier ou ajouter la liste des emplacements du code source :

Procédure

  1. Dans le menu déroulant, cliquez avec le bouton droit de la souris sur la cible de débogage (ou un/une de ses cadres de pile ou unités d'exécution) et choisissez Modifier le chemin de recherche des fichiers source.
  2. Dans la boîte de dialogue Modification du chemin de recherche des fichiers source, vous pouvez réaliser les tâches suivantes :
    • Pour ajouter un emplacement de fichiers source, cliquez sur Ajouter. Le programme affiche la boîte de dialogue Ajout d'un type de source dans laquelle vous pouvez sélectionner le type d'emplacement de fichier source à ajouter. Dans la liste des sélections dans la boîte de dialogue Ajout d'un type de source :
      • Choisissez Répertoire du système de fichiers pour afficher un répertoire de système de fichiers local à la liste des emplacements de fichier source. Si nécessaire, les sous-répertoires du répertoire font l'objet d'une recherche récursive si vous cochez la case Rechercher les sous-dossiers.
      • Pour ajouter le moteur de débogage dans la liste des emplacements du code source, choisissez Moteur de débogage.
      • Choisissez Chemin du moteur de débogage pour ajouter le chemin défini dans le moteur de débogage à la liste des emplacements de fichier source. Lorsque vous définissez plusieurs chemins, séparez-les avec un point-virgule (;).
        Remarque : La modification du chemin du moteur de débogage est appliquée aux sessions de débogage suivantes.
    • Pour supprimer une entrée, sélectionnez un emplacement de fichiers source et cliquez sur Supprimer.
    • Pour définir l'ordre des entrées, sélectionnez un emplacement de fichiers source et cliquez sur l'option Haut ou Bas pour déplacer l'emplacement.
  3. Si vous voulez rechercher toutes les instances du fichier source dans la liste des emplacements du code source, cochez la case Rechercher les fichiers source en double dans le chemin. Si vous cochez la case et que le débogueur trouve plusieurs instances du nom de fichier, une boîte de dialogue demande de sélectionner le fichier source approprié.
  4. Une fois que vous avez modifié le chemin, cliquez sur OK pour fermer la boîte de dialogue et utilisez le nouveau chemin pour trouver le code source.

Modification du fichier source dans l'éditeur

Pourquoi et quand exécuter cette tâche

Parfois, le débogueur trouve le fichier source incorrect du cadre de pile en cours dans votre programme et l'éditeur affiche le code source incorrect. Dans ce cas, vous pouvez modifier le fichier texte ouvert dans l'éditeur :

Procédure

  1. Cliquez avec le bouton droit de la souris dans l'éditeur, puis sélectionnez Changer le fichier texte dans le menu en incrustation.
  2. Dans la zone de la boîte de dialogue Changement du fichier texte, précisez ou recherchez le chemin et le nom du fichier à ouvrir.
    Remarque : Si vous définissez un fichier de votre poste de travail local, vous devez entrer le chemin qualifié complet et le nom de fichier dans cette zone.
  3. Cliquez sur OK pour charger le fichier source spécifié dans l'éditeur, puis fermez la boîte de dialogue Changement du fichier texte. Sinon, cliquez sur Annuler si vous ne souhaitez pas modifier le fichier source.

Résultats

Fichier source introuvable

Pourquoi et quand exécuter cette tâche

Lorsque le fichier source est introuvable, l'éditeur s'ouvre sans fichier source. Dans l'éditeur, vous pouvez :

  • Préciser un nom de fichier source différent dans l'éditeur. Pour ce faire, cliquez sur le bouton Changer le fichier texte et précisez ou recherchez le chemin et le nom du fichier à ouvrir.
    Remarque :
    • Si vous définissez un fichier de votre poste de travail local, vous devez entrer le chemin qualifié complet et le nom de fichier dans cette zone.
    • La possibilité de changer le fichier source de l'éditeur dépend du langage, de l'environnement et de la plateforme que vous utilisez pour le débogage.
  • Modifier le chemin de recherche des fichiers source pour désigner l'emplacement du fichier source. Pour ce faire, cliquez sur le bouton Ajouter un emplacement de fichiers source. La boîte de dialogue Modification du chemin de recherche des fichiers source apparaît. Pour savoir comment utiliser la boîte de dialogue, consultez la section Modification de la liste des emplacements du code source précédente.