Exécution des fonctions SQL définies par l'utilisateur
Il existe plusieurs méthodes pour exécuter les fonctions SQL définies par l'utilisateur (UDF) :
- Utilisez l'option de menu dans le menu contextuel de l'éditeur SQL.
- Utilisez l'option de menu Db2 for z/OS Routine > Call Routine dans le menu contextuel de l'éditeur SQL.
- Utilisez le bouton de la barre d'outils
Run. - Ouvrez le menu contextuel d'un objet UDF dans la navigation Catalogue et sélectionnez l'option Call Routine.
- Cliquez avec le bouton droit de la souris sur un fichier .udfsql dans l'explorateur de projets et sélectionnez .
Toutes les méthodes recherchent une configuration d'exécution Db2 for z/OS existante qui correspond au fichier dans le contexte. Si aucune correspondance n'existe, l'outil crée une configuration d'exécution pour le fichier en contexte et l'utilise. Si nécessaire, la fenêtre Run Routine s'ouvre pour vous demander les valeurs des variables ou des paramètres. Si l'instruction SQL a été exécutée récemment dans la base de données active, la fenêtre peut être remplie avec des valeurs récentes pour les champs Type de données, Nul et Valeur.
La boîte de dialogue Paramètres d'entrée comprend des options de chargement et d' enregistrement, permettant aux utilisateurs d'exporter les valeurs des paramètres vers un fichier XML ou de les charger ultérieurement. Cette fonction est particulièrement utile pour les jeux de paramètres importants ou fréquemment réutilisés. La boîte de dialogue affiche des champs d'une seule ligne pour les types de base et des champs de plusieurs lignes pour les types XML et LOB.
Les résultats de l'opération UDF sont affichés dans la vue Détails du système distant et dans la boîte de dialogue État de l'exécution, où vous pouvez voir les avertissements ou les erreurs et accéder à plus d'informations sur les codes SQL et l'état. L'enregistrement de la demande est également ajouté au dossier Historique des requêtes de la connexion Db2 for z/OS.
Création d'une configuration d'exécution
- Pour ouvrir la fenêtre Configurations d'exécution, cliquez sur .
- Dans la liste de navigation, cliquez avec le bouton droit de la souris sur Db2 for z/OS Routine et sélectionnez Nouvelle configuration. Une nouvelle configuration est ajoutée à la liste de navigation en tant qu'enfant de Db2 for z/OS Routine, et la nouvelle page de configuration s'ouvre dans le panneau de l'éditeur Run Configurations.
- Dans la nouvelle page de configuration, cliquez sur Parcourir, puis saisissez une chaîne de recherche, telle que *.udfsql , dans le champ de texte. Cette chaîne correspond à tous les UDF définis dans un projet local ou distant z/OS dans la vue z/OS Projects.
- Sélectionnez un UDF dans la liste et cliquez sur OK.
- Dans le champ Nom de la page de nouvelle configuration, saisissez un nom pour la nouvelle configuration.
- Pour enregistrer la configuration de l'exécution, cliquez sur Appliquer.