Déboguer une application à l'aide d'informations obtenues sur un travail de manière dynamique

Pour déboguer une application où les informations sur le travail sont obtenues de manière dynamique, vous devez créer une configuration Dynamic Attach de débogage.

Pourquoi et quand exécuter cette tâche

Pour créer une configuration Dynamic Attach, procédez comme suit :

Procédure

  1. Ouvrez la boîte de dialogue Configurations de débogage. Pour plus d'informations, voir Démarrage du débogage.
  2. Dans le volet de gauche de la boîte de dialogue Configurations de débogage, cliquez avec le bouton droit de la souris sur IBM® i: Débogage de travail dynamique et sélectionnez Nouveau dans le menu contextuel.
  3. Dans la zone Nom, entrez le nom de votre choix pour la configuration que vous créez (ce nom ne doit pas être déjà attribué à une autre configuration).
    Conseil : Le menu Débogage affiche ce nom pour permettre de relancer la configuration.
  4. Sélectionnez chacun des onglets de la boîte de dialogue et remplissez-les en vous inspirant des tableaux des sections ci-dessous :
  5. La saisie de l'ensemble des informations obligatoires pour la configuration de lancement active les boutons Déboguer et Appliquer. Cliquez sur Appliquer pour enregistrer la configuration afin de l'exécuter ultérieurement ou cliquez sur Déboguer pour démarrer immédiatement une session de débogage prenant en compte les nouveaux paramètres. Vous serez invité à appeler votre application dans le travail que vous avez indiqué. L'appel du programme déclenche le démarrage de la session de débogage.

    Vous pouvez modifier une configuration de débogage une fois que vous l'avez enregistrée. Vous pouvez également en faire une copie et modifier cette copie. Pour savoir comment modifier des configurations de débogage, voir la tâche connexe ci-dessous.

    Conseil : Si vous n'avez pas encore enregistré les paramètres de la configuration et si vous souhaitez modifier ou supprimer certaines de ses entrées, cliquez sur Retour pour supprimer toutes les modifications que vous avez effectuées.
  6. Si des informations obligatoires n'ont pas été fournies dans la configuration ou si les informations que vous avez fournies comportent des erreurs, des messages indiquant les anomalies apparaissent en haut de la boîte de dialogue.
  7. Pour quitter la boîte de dialogue sans démarrer de session de débogage, cliquez sur Fermer.

Onglet Eléments à déboguer

Pourquoi et quand exécuter cette tâche

Sélectionnez l'onglet Eléments à déboguer pour l'afficher au premier plan. Sauf indication contraire, il convient de renseigner toutes les zones de cet onglet avant de démarrer une session de débogage.

Groupe Paramètres
Connexion Dans le menu déroulant, sélectionnez le nom d'une connexion systèmes distants existante. Cette connexion doit être liée au serveur IBM i contenant le travail à déboguer. Si aucune connexion n'a été créée, cliquez sur Nouveau pour lancer un assistant qui vous permettra de le faire.
Clé Dans cette zone, vous entrez une clé unique qui servira à rechercher le travail dans la file d'attente des données de débogage présente sur l'hôte IBM i. La syntaxe de la clé doit être identique à celle qui est écrite dans la file de données pour le travail correspondant. Le caractère générique ('*') n'est pas reconnu. Clé : Entrez la clé. Longueur maximale : 64 octets.
Commande de reprise de l'application Dans cette zone, vous entrez la commande qui relance l'application à déboguer. Cette commande sera appelée par le débogueur intégré d'IBM i une fois que ce dernier se sera attaché à votre application. Cette zone n'est obligatoire que si votre application est mise en suspens pour spécifier l'appel du débogueur et démarrer ce dernier. Sinon, vous pouvez la laisser vide. Commande de reprise de l'application : Entrez la commande qui relancera l'application. Une fois que vous avez entré la commande, vous pouvez cliquer sur le bouton Invite pour afficher une invite à la saisie des paramètres de la commande.
Délai de lancement (en secondes) Dans cette zone, vous entrez le délai maximum en secondes pendant lequel le lancement du débogueur doit attendre dans la file d'attente des données de débogage les informations relatives au travail. Le lancement du débogueur prend fin automatiquement si aucune information de travail correspondant à la clé spécifiée n'a été trouvée lorsque le délai indiqué est atteint. Délai de lancement : Entrez le nombre de secondes à attendre. Si la zone est vide, la valeur du délai est extraite des préférences du débogueur.
Programmes ou programme de service à déboguer Cette section vous permet d'entrer des informations sur les programmes et les programmes de service à déboguer. Vous pouvez spécifier plusieurs programmes. Cliquez sur Ajouter pour ajouter un programme ou un programme de service à la liste. Pour déboguer une application en cours d'exécution et l'arrêter à la première instruction exécutable, assurez-vous qu'il n'existe aucun programme ou programme de service spécifié dans cette section.
  1. Bibliothèque : Dans la zone Bibliothèque de la boîte de dialogue Ajout d'un programme ou d'un programme de service, indiquez la bibliothèque contenant le programme à déboguer. Vous trouverez des informations sur la spécification des noms de bibliothèque valides dans la procédure connexe ci-dessous. Pour parcourir la bibliothèque, sélectionnez Parcourir.
  2. Sélectionnez Programme ou Programme de service et indiquez son nom dans la zone appropriée. Sélectionnez Parcourir pour parcourir sur l'hôte IBM i la liste des programmes ou des programmes de service disponibles dans la bibliothèque spécifiée.
  3. Cliquez sur OK.
Avance d'un pas avec entrée Si cette case n'est pas cochée, le débogueur s'arrête au premier point d'arrêt détecté. Il peut s'agir d'un point d'arrêt de profil (défini lors de la précédente session de débogage) ou d'un point d'arrêt source (défini dans l'éditeur du débogueur avant le lancement du débogage).

Si l'option Avance d'un pas avec entrée est sélectionnée :

  • Si vous avez spécifié un programme d'initiation ou un programme de service à déboguer dans le tableau Programmes ou programme de service à déboguer, le débogueur avance pas à pas dans l'objet du programme ou du programme de service spécifié.
  • Dans le cas contraire, le débogueur s'arrête à la prochaine instruction débogable de l'application.
Arrêt de la session de débogage à la fin du programme Si cette case est cochée et si un programme correct (et non un programme de service) est indiqué comme programme d'initiation dans le tableau des programmes ou programmes de service à déboguer, la session de débogage se termine dès la fin de l'exécution du programme.
Mise à jour des fichiers de production Si la case Mise à jour des fichiers de production est cochée, l'application en cours de débogage est autorisée à mettre à jour les enregistrements de la base de données dans des bibliothèques de production.

Onglet Source

Pourquoi et quand exécuter cette tâche

Groupe Paramètres
Chemin de recherche des fichiers source Initialement, les conteneurs source IBM i et Moteur de débogage par défaut sont répertoriés. Le conteneur source IBM i par défaut permet au débogueur de rechercher la source dans le répertoire de compilation de l'objet de programme. Le conteneur source du moteur de débogage fournit des données pour les vues autres que la vue *SOURCE (par exemple, la vue Liste (*LISTING) ou Instruction (*STATEMENT)). Vous pouvez spécifier votre propre chemin de recherche de la source :
  1. Cliquez sur Ajouter pour ajouter votre chemin source IFS.
  2. Dans la boîte de dialogue Ajouter une source, cliquez sur Fichier physique source IBM i ou Dossier distant.
    • Sélectionnez Fichier physique source IBM i si votre source se trouve dans les fichiers physiques source. Cliquez sur OK. Dans la boîte de dialogue "Sélection d'un ou de plusieurs fichiers physiques", accédez aux fichiers physiques source.
    • Sélectionnez Dossier distant s'il réside dans une source IFS. Cliquez sur OK. Dans la boîte de dialogue "Recherche d'un dossier", accédez au dossier distant contenant votre source.
  3. Cliquez sur OK. Votre source est ajoutée à la liste de la zone Chemin de recherche des fichiers source.
  4. Cliquez sur Appliquer. Vous pouvez ajouter plusieurs chemins source. La séquence dans laquelle ils sont répertoriés correspond à la séquence suivie par le débogueur lorsqu'il recherche la source.
Rechercher les fichiers source en double dans le chemin Si cette case n'est pas cochée, le débogueur recherche les chemins spécifiés dans la séquence et utilise la première occurrence. Si elle est cochée, le débogueur recherche les chemins spécifiés et répertorie toutes les occurrences, ce qui vous permet d'en sélectionner une.

Onglet Commun

Pourquoi et quand exécuter cette tâche

Sélectionnez l'onglet Commun pour l'afficher au premier plan, puis procédez comme suit :

  1. Si vous souhaitez stocker la configuration de lancement en local et la mettre à disposition d'un seul utilisateur, assurez-vous que le bouton radio Local est sélectionné. Si la configuration de lancement doit être stockée dans l'espace de travail comme un simple fichier et mise en partage dans un référentiel à l'usage du groupe, sélectionnez le bouton radio Partagé. Indiquez ensuite dans la zone Emplacement de la configuration partagée l'emplacement du projet sur lequel vous souhaitez stocker la configuration de lancement. Vous pouvez également rechercher un projet.
  2. Si vous voulez que la configuration de lancement apparaisse dans le menu de préférences de Débogage ou dans la liste Historique du débogage du menu Débogage, cochez la case Débogage dans le menu Afficher dans le menu Favoris.

Commentaires en retour