Débogage d'une application par lots avec invite complète

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

Pourquoi et quand exécuter cette tâche

Pour ce faire, procédez comme suit :

Procédure

  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 partie gauche de la boîte de dialogue des configurations de lancement Débogage, cliquez avec le bouton droit de la souris sur i : Débogage d'application par lots et sélectionnez Nouveau dans le menu en incrustation.
  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. Votre application s'exécute dans un travail par lots transmis par le débogueur.

    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. 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 l'application à déboguer. Si aucune connexion n'a été créée, cliquez sur Nouveau pour lancer un assistant qui vous permettra de le faire.
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.
  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 IBM i.
  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é des programmes ou des programmes de service à déboguer dans le groupe Programmes ou programme de service à déboguer, le débogueur avance d'un pas avec entrée dans le premier objet de programme rencontré (dans la liste).
  • Si vous n'avez indiqué aucun programme ou programme de service, le débogueur s'arrête à l'entrée débogable suivante dans l'application.
Arrêt de la session de débogage à la fin du programme Si cette case est cochée et si un programme d'initiation correct (et non un programme de service) est indiqué dans les programmes ou les 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 cette case 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 Instructions de démarrage

Pourquoi et quand exécuter cette tâche

Utilisez cette page pour indiquer la commande IBM i à utiliser pour soumettre votre application par lots. Pour ce faire, utilisez la commande SBMJOB.

Dans cette page, il convient d'utiliser le bouton Invite pour obtenir les paramètres SBMJOB. Le débogueur utilise le paramètre HOLD(*YES) pour la commande SBMJOB.

Si vous avez renseigné l'onglet Eléments à déboguer avec un programme d'initiation ou si vous choisissez l'application à déboguer à partir de l'explorateur de systèmes éloignés ou dans Navigateur de projet i, la commande est créée automatiquement.

Onglet Source

Pourquoi et quand exécuter cette tâche

Groupe Paramètres
Chemin de recherche des fichiers source Initialement, les conteneurs source i par défaut et Moteur de débogage sont répertoriés. Le conteneur source 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