Configuration des préférences de débogage des procédures mémorisées

La page des préférences du débogueur de procédures mémorisées DB2 permet de définir des préférences pour les phases d'exécution des procédures mémorisées, les limites de caractère pour les variables, le traçage des erreurs et le gestionnaire de sessions de débogage.

Sélectionnez Fenêtre > Préférences dans la barre de menus du plan de travail pour ouvrir la boîte de dialogue Préférences. Les paramètres de débogage des procédures mémorisées spécifiés dans cette boîte de dialogue ne sont appliqués qu'au démarrage de la session suivante. Dans la boîte de dialogue, sélectionnez Exécution/Débogage > Débogueur de procédures mémorisées DB2 pour accéder aux préférences ci-après, que vous pouvez définir pour les procédures de débogage.

Tableau 1. Préférences du débogueur de procédures mémorisées DB2
Préférence Explication
Nombre de secondes d'inactivité avant la fin de l'exécution de la procédure Si vous interrompez le débogage d'une procédure mémorisée SQL pendant la période de temps indiquée dans cette zone, la session de débogage s'arrête et la procédure est exécutée jusqu'à la fin. La valeur minimale de ce paramètre est de 30 secondes et la valeur maximale de 1800 secondes. Sa valeur par défaut est de 300 secondes.
Remarque : Ce paramètre n'est pas appliqué dans le cadre du débogage des procédures mémorisées Java.
Nombre maximal de caractères analysé pour les variables longues Ce paramètre contrôle le nombre maximal de caractères qui s'affichent pour la valeur des variables dans la vue Variables. La valeur par défaut de ce paramètre est de 80 caractères.
Remarque : Ce paramètre n'est pas appliqué dans le cadre du débogage des procédures mémorisées Java.
Nombre de caractères par ligne du volet Détails de la vue Variables Cette option permet de contrôler les retours à la ligne dans la sous-fenêtre Détails de la vue Variables. Chaque ligne de la sous-fenêtre Détails comporte le nombre de caractères spécifiés ; lorsque ce nombre est atteint, une nouvelle ligne est commencée. La valeur par défaut de ce paramètre est de 72 caractères.
Remarque : Ce paramètre n'est pas appliqué dans le cadre du débogage des procédures mémorisées Java.
Niveau de trace des données de diagnostic sur le serveur DB2 Cette option détermine le niveau de trace des erreurs sur le serveur DB2. Les entrées admises pour cette zone sont les suivantes :
  • 0 - Pas de trace. Il s'agit de la valeur par défaut.
  • 1 - Seules les erreurs graves sont consignées.
  • 2 - Tous les messages de trace sont consignés.
Section Emplacement du gestionnaire de sessions de débogage des routines DB2 Le gestionnaire de sessions connecte l'interface utilisateur du débogueur au serveur DB2 et doit être exécuté pour que la session de débogage puisse démarrer. Dans la section des préférences, vous pouvez choisir d'utiliser un gestionnaire de sessions sur le serveur sur lequel la procédure mémorisée est exécutée ou un gestionnaire de sessions existant.
  • Pour utiliser le gestionnaire de sessions du serveur sur lequel la procédure mémorisée est déboguée, sélectionnez le bouton d'option Exécuter le gestionnaire de sessions sur chaque serveur connecté. Pour utiliser le gestionnaire de sessions par défaut, laissez la zone Port vierge. Si vous utilisez un gestionnaire de sessions différent, entrez le numéro de port sur lequel le gestionnaire de sessions doit s'exécuter dans la zone Port. Si le gestionnaire de sessions n'est pas démarré sur le serveur, il est démarré automatiquement lorsque vous lancez le débogage. La zone Délai d'expiration du gestionnaire de sessions, en minutes indique la durée pendant laquelle un nouveau gestionnaire de sessions peut rester inactif avant de s'arrêter automatiquement après une session de débogage.
  • Pour utiliser un gestionnaire de sessions existant, sélectionnez le bouton d'option Utiliser un gestionnaire de sessions déjà actif. Dans la zone Hôte, entrez le nom d'hôte ou l'adresse IP de la machine sur laquelle le gestionnaire de sessions s'exécute. Dans la zone Port, entrez le port sur lequel le gestionnaire de sessions s'exécute.

Vous pouvez utiliser un gestionnaire de sessions autonome lorsque qu'aucun gestionnaire de sessions n'est disponible pour le serveur DB2 que vous déboguez.

Pour démarrer un gestionnaire de sessions autonome, exécutez le fichier de commandes db2dbgm sous le répertoire d'installation pour ce produit (il y a deux fichiers de commandes différents : db2dbgm.bat a été conçu pourWindows et db2dbgm pour Linux). Vous pouvez modifier le fichier de commandes de sorte qu'il spécifie une valeur de port différente si la valeur par défaut n'est pas disponible.

Vous devez démarrer le gestionnaire de sessions autonome avant de tenter de l'utiliser avec ce produit ; de plus, vous devez spécifier dans les préférences pour le débogage des procédures mémorisées que vous utilisez un gestionnaire de sessions autonome. Pour ce faire, ouvrez la page des préférences du débogueur de procédures mémorisées DB2, sélectionnez le bouton d'option Utiliser un gestionnaire de sessions déjà actif et renseignez les zones Hôte et Port conformément aux instructions ci-dessus.

Ne pas utiliser le connecteur TCP/IP pour communiquer avec le gestionnaire de sessions de débogage Dans le cas des serveurs de base de données qui le prenne en charge, le débogueur utilise automatiquement un connecteur TCP/IP pour communiquer avec le gestionnaire de sessions afin d'améliorer les performances du débogage. Si vous ne voulez pas utiliser de connecteur (par exemple avec un pare-feu), sélectionnez cette option.
Tâches associées
Préparation du débogage
Configuration du serveur LUW pour le débogage
Préparation du débogage sous z/OS
Utilisation de la vue Sortie des données
Exécution
Arrêt et interruption

Commentaires en retour