Débogage d'un travail avec invite complète

Pour déboguer un travail avec une invite complète des paramètres de lancement, vous devez créer une configuration de lancement pour la session de débogage.

Pour ce faire, procédez comme suit :

  1. Ouvrez la boîte de dialogue des configurations de lancement Débogage. Pour plus d'informations, voir Démarrage du débogage.
  2. Dans la sous-fenêtre de gauche de la boîte de dialogue des configurations de lancement Débogage, cliquez avec le bouton droit de la souris sur iSeries : Débogage de travail et sélectionnez Nouveau dans le menu contextuel.
  3. Dans la zone Nom de la configuration de lancement, entrez le nom unique de votre choix pour la configuration que vous êtes en train de créer.
    Conseil : Ce nom apparaît dans le menu Débogage pour redémarrer le programme.
  4. Sélectionnez les onglets de la configuration de lancement et renseignez-les en vous référant aux tableaux contenus dans les 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 de lancement à exécuter ultérieurement ou sur Déboguer pour lancer 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 lancement du débogage après son enregistrement. Pour plus d'informations sur la modification de ces configurations, consultez la tâche connexe ci-dessous.

    Conseil : Si vous n'avez pas encore enregistré les paramètres de la configuration de lancement et si vous souhaitez y modifier certaines entrées ou encore en supprimer, cliquez sur Retour pour supprimer toutes les modifications que vous avez effectuées.
  6. Si les informations obligatoires n'ont pas été renseignées dans la configuration de lancement ou si elles 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

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 iSeries 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.
Travail Cette section vous permet d'entrer les informations complètes relatives au travail à déboguer :
  • Nom correspond au nom du travail tel qu'il est identifié sur le système - par exemple, QPADEV0017.
  • Utilisateur correspond au profil utilisateur sous lequel le travail est exécuté - par exemple, MYUSER.
  • Numéro correspond au numéro de travail attribué par le système - par exemple, 001234.

Vous pouvez obtenir une liste du sous-ensemble des travaux (actifs ou en file d'attente) disponibles sur le système iSeries en utilisant les caractères génériques ('*') dans chacune de ces zones, puis en cliquant sur le bouton Parcourir. Dans cette liste, sélectionnez le travail à déboguer : les informations associées à ce dernier vous permettront de renseigner les zones ci-dessus.

Remarque : Vous ne devez indiquer qu'un seul travail existant sur l'hôte iSeries, au risque de voir apparaître un message d'erreur.
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 la liste des programmes ou programmes de service disponibles dans la bibliothèque spécifiée sur le système iSeries.
  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

Groupe Paramètres
Chemin de recherche des fichiers source Les conteneurs source iSeries par défaut et Moteur de débogage sont répertoriés par défaut. Le conteneur source iSeries 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 Listing (*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 source iSeries ou Dossier distant.
    • Sélectionnez Fichier source iSeries si votre source se trouve dans des 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 Avancé

Groupe Paramètres
Adresse du nom d'hôte du poste de travail
  • Détection automatique du nom d'hôte de votre poste de travail : Le débogueur doit être en mesure de déterminer le nom d'hôte TCP/IP de votre poste de travail. Ce paramètre doit s'appliquer dans la plupart des cas.

    Si votre poste de travail dispose de plusieurs adresses IP sur des réseaux différents et que le démarrage de la session de débogage vous pose certaines difficultés, vous devez indiquer explicitement l'adresse IP ou le nom d'hôte de votre poste de travail.

  • Préciser le nom d'hôte de votre poste de travail : Si cette option est sélectionnée, précisez l'adresse IP du poste de travail dans la zone Nom d'hôte du poste de travail.

Onglet Commun

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.