Utilisation du pilote JDBC DB2 Universal pour accéder à DB2 for z/OS

Le système d'exploitation z/OS exige la configuration du pilote JDBC DB2 Universal et de la base de données pour assurer l'interopérabilité. Depuis WebSphere Application Server, configurez un objet fournisseur JDBC (Java™ Database Connectivity) ainsi qu'un objet source de données afin d'implémenter les fonctions du pilote pour vos applications.

Avant de commencer

Les versions disponibles du pilote DB2 Universal JDBC Driver pour la connexion à DB2 sous z/OS sont les suivantes :
  • Pilote JDBC DB2 Universal de DB2 UDB for z/OS version 8. Cette version prend en charge les types de pilote 2 et 4.
  • Pilote JDBC DB2 Universal pour DB2 UDB for OS/390 and z/OS version 7, comme indiqué dans l'APAR PQ80841. Cette version prend à la fois en charge les pilotes de type 2 et 4.
  • Le pilote JDBC DB2 Universal avec la fonction z/OS Application Connectivity to DB2 for z/OS fournit uniquement une connectivité de type 4. Si vous installez cette version du pilote, vous devez configurer un fournisseur de pilote JDBC DB2 Universal (XA) pour pouvoir accéder aux bases de données DB2 distantes.
Consultez les mises à jour de service DB2 afin de connaître les améliorations disponibles pour votre version.
Conseil de migration : Si vous remplacez le pilote JDBC Legacy DB2 for 390 and z/OS par le pilote JDBC DB2 Universal, vous pouvez faire migrer les paramètres du fournisseur JDBC existants. Pour plus d'informations, consultez la rubrique Migrating from the JDBC/SQLJ Driver for OS/390 and z/OS to the DB2 Universal JDBC Driver dans le centre de documentation Information Management Software for z/OS Solutions.

Procédure

  1. Installez les fichiers classe du pilote et tout fichier natif nécessaire dans un répertoire de système hiérarchique de fichiers disponible.

    Les fichiers natifs sont des fichiers classe qu'exigent certaines versions du pilote JDBC DB2 Universal pour s'exécuter sur le système d'exploitation z/OS.

  2. Configurez le pilote et la base de données en vue de l'interopérabilité
    1. Liez les modules DB2 requis.

      Si une application exécute des instructions SQL dans DB2 for z/OS, le pilote JDBC Universal doit se lier aux packages DB2 qui représentent les instructions SQL à exécuter.

      Les détails propres à l'utilitaire et au processus de liaison sont décrits dans le fichier readme fourni avec le pilote JDBC DB2 Universal installé. Il contient également des instructions pour la configuration et l'exécution de la liaison requise.

      L'utilitaire requiert le nom du serveur ou l'adresse IP, le numéro de port et le nom de la base de données (l'emplacement de la base de données sous z/OS) pour le système DB2 cible. Pour obtenir ces informations, émettez la commande DB2 -DISPLAY DDF sur le système DB2 cible. Cette commande affiche l'adresse IP (IPADDR), le nom du serveur (SQL DOMAIN), le numéro TCPPORT et l'emplacement et le nom de la base de données (LOCATION) à entrer dans l'utilitaire.

      Vous devez exécuter le processus de liaison pour chaque système DB2 cible auquel le pilote JDBC DB2 Universal accède.

    2. Configuration de la gestion des transactions en attente de validation

      Effectuez une fois cette configuration pour chaque emplacement DB2 for z/OS version 7 cible auquel le support du pilote JDBC DB2 Universal de type 4 XA accédera.

      DB2 for z/OS version 7 n'implémente pas le support XA Java EE (Java Platform, Enterprise Edition), le processus de traitement XA des pilotes de type 4 utilise le protocole de validation en deux phases de DB2 version 7 et une table à chaque emplacement (base de données) pour stocker une liste des transactions globales en attente ou terminées, mais non validées).

      Vous devez configurer cette table pour chaque emplacement DB2 version 7 accessible. Pour effectuer la configuration, utilisez l'utilitaire In-Doubt mis à disposition par le pilote JDBC DB2 Universal installé. Il permet de créer la table SYSIBM.INDOUBT qui stocke les informations relatives aux transactions globales en attente. De plus, il lie le module T4XAIndbtPkg, qui contient les instructions SQL pour l'insertion et la suppression dans la table SYSIBM.INDOUBT. Le module T4XAIndbtPkg est écrit en langage SQLJ.

      Ce processus d'installation requiert que DDF soit activé sur le sous-système DB2 cible pour les connexions TCP/IP entrantes.
      1. Pour activer DDF, émettez la commande DB2 -START DDF sur le système DB2 cible.
      2. Cet utilitaire requiert le nom du serveur, ou l'adresse IP, et le numéro de port du système DB2 version 7 cible. Pour obtenir ces informations, émettez la commande DB2 -DISPLAY DDF sur le système DB2 version 7 cible. L'adresse IP (IPADDR), le nom du serveur (SQL DOMAIN) et le numéro TCPPORT à entrer dans l'utilitaire s'affichent.

      Pour des informations détaillées sur l'utilitaire In-Doubt, consultez la documentation intitulée DB2 Universal Database for z/OS Version 7 Application Programming Guide and Reference for JavaTM. Vous pouvez télécharger cette documentation à partir de la section Library des pages Web contenant les informations relatives au produit DB2 Universal Database for z/OS version 7. Recherchez le passage sur l'utilitaire dans la section DB2T4XAIndoubtUtil, qui correspond au nom officiel de l'utilitaire In-Doubt.

      Remarque : La configuration décrite précédemment pour les transactions en attente de validation ne correspond pas à une configuration requise pour les serveurs DB2 for z/OS version 8 car DB2 for z/OS version 8 prend en charge en mode natif les commandes XA sur DRDA et gère en interne les transactions globales en attente de validation.
    3. Définition d'une variable db2.jcc.propertiesFile

      Vous pouvez créer un fichier de propriétés db2.jcc.propertiesFile qui sera utilisé par le traitement du pilote JDBC DB2 Universal JDBC de type 2 dans WebSphere Application Server for z/OS, puis le spécifier en tant qu'entrée dans le pilote. Ce fichier de propriétés d'exécution permet de spécifier plusieurs options d'exécution que le pilote JDBC DB2 Universal utilise pour la connectivité de type 2. Elles sont indiquées en tant que propriétés sous la forme paramètre=valeur. Consultez le fichier README fourni avec le pilote JDBC DB2 Universal installé pour une description détaillée de chaque propriété.

      Ce fichier n'est pas obligatoire ; toutefois, s'il n'existe pas, le traitement par défaut du pilote Universal est exécuté.

      La propriété db2.jcc.ssid est importante. Elle spécifie l'identificateur du sous-système DB2 (et pas le nom de l'emplacement) que le traitement du pilote JDBC DB2 Universal de type 2 doit utiliser comme nom de sous-système local auquel il se connecte. Si cette propriété n'est pas indiquée, le pilote utilise l'identificateur du sous-système qu'il trouve dans le module de chargement DSNHDECP. Dans ce cas, le module de chargement doit se trouver dans un fichier steplib des PROC de la région de servants correspondant à chaque serveur qui utilise le système DB2 identifié par l'ID sous-système. Consultez le fichier readme fourni avec le pilote Universal pour plus d'informations sur l'utilisation de ce module de chargement. Si ce module de chargement DSNHDECP ne reflète pas précisément le sous-système voulu, ou si plusieurs sous-systèmes sont susceptibles d'utiliser un module DSNHDECP générique, vous devez spécifier la propriété db2.jcc.ssid.

      Bien que la propriété db2.jcc.propertiesFile ne soit pas obligatoire, si vous décidez de la définir, vous devez indiquer le nom complet du fichier HFS en tant que propriété système de la façon suivante :
      • db2.jcc.propertiesFile = <nom du fichier hfs complet>
      Les propriétés générales d'un pilote étant souvent propres à son chargement, serveur par exemple, plutôt qu'à tous les serveurs utilisant le fournisseur JDBC, il est préférable de définir la propriété JVM au niveau du serveur. Pour définir la propriété db2.jcc.propertiesFile= au niveau du serveur à l'aide de la console d'administration de WebSphere Application Server for z/OS, procédez comme suit :
      1. Dans la console d'administration de WebSphere Application Server for z/OS, sélectionnez Serveurs > Serveurs d'applications, puis cliquez sur le serveur auquel vous voulez ajouter la propriété JVM.
      2. Sur la page du serveur sélectionné, développez Gestion des processus et Java, puis cliquez sur Définition des processus > Servant.
      3. Sur la page du servant, cliquez sur Propriétés supplémentaires, puis sur Machine virtuelle Java.
      4. Dans la page Machine virtuelle Java, cliquez sur Propriétés supplémentaires, puis sur Propriétés personnalisées.
      5. Faites défiler la page Propriétés personnalisées et cliquez sur Nouveau pour configurer une nouvelle propriété JVM pour le serveur sélectionné. Le nom de la propriété est db2.jcc.propertiesFile. La valeur de la propriété est le nom complet du fichier HFS que vous avez créé et initialisé avec les propriétés du pilote JDBC DB2 Universal. Le pilote de type 2 utilise ces propriétés pour le serveur sélectionné.
      6. Cliquez sur OK.
      7. Cliquez sur Sauvegarder pour enregistrer la nouvelle propriété JVM.
  3. Définissez un fournisseur JDBC pour le pilote JDBC DB2 Universal. L'objet fournisseur JDBC encapsule les classes du pilote pour l'implémentation dans WebSphere Application Server.
    1. Dans la console d'administration de WebSphere Application Server for z/OS, cliquez sur Ressources > JDBC > Fournisseurs JDBC.
    2. Sélectionnez la portée à laquelle les applications peuvent utiliser le fournisseur JDBC. Cette portée devient la portée de toute source de données que vous associez à ce fournisseur. Vous pouvez choisir cellule, noeud, cluster ou serveur. Pour plus d'informations, voir la rubrique Paramètres de portée de la console d'administration.
    3. Cliquez sur Nouveau. Cette action entraîne le lancement de l'assistant Création d'un nouveau fournisseur JDBC.
    4. Utilisez la première liste déroulante afin de sélectionner DB2 for z/OS comme type de base de données.
    5. Sélectionnez le fournisseur de pilote JDBC DB2 Universal comme type de fournisseur JDBC dans la deuxième liste déroulante.
    6. Dans la troisième liste déroulante, sélectionnez le type d'implémentation nécessaire à votre application.
      Si l'application ne requiert pas de connexion prenant en charge les transactions à validation en deux phrases et que vous prévoyez d'utiliser une connectivité de type 4, choisissez Source de données du pool de connexions. Cependant, si vous utilisez la source de données du pool de connexions avec une connectivité de type 2, Application Server on z/OS utilise RRS pour traiter à la fois les transactions à une phase et les transactions à deux phases.
      Restriction : Ne sélectionnez pas Source de données du pool de connexions si la fonction z/OS Application Connectivity to DB2 for z/OS est définie sur votre installation pour WebSphere Application Server for z/OS. Seule l'implémentation XA du pilote JDBC DB2 Universal prend en charge cette fonction.

      Choisissez Source de données XA si vous prévoyez d'utiliser un pilote de type 4 et que votre application nécessite des connexions prenant en charge des transactions à validation en deux phases. Utilisez uniquement la connectivité driverType 4 pour la source de données XA.

      Une fois un type d'implémentation sélectionné, l'assistant complète les champs de nom et de description pour votre fournisseur JDBC. Vous pouvez saisir différentes valeurs dans ces champs ; ils ne sont utilisés qu'à des fins administratives.

    7. Cliquez sur Suivant après avoir défini le type de votre base de données, le type de fournisseur et le type d'implémentation. Vous visualisez à présent la page de l'assistant de la saisie des informations de chemin d'accès aux classes de base de données.

      Dans la plupart des cas, il n'est pas nécessaire de modifier le chemin d'accès aux classes qui remplit déjà la zone. Ce chemin d'accès aux classes correspond à la valeur de la variable d'environnement WebSphere affichée sur cette page sous la forme de ${BASE_DE_DONNEES_CHEMIN_PILOTE_JDBC}. Vous n'aurez probablement pas non plus à modifier le chemin de la bibliothèque native ni le nom de la classe d'implémentation de la source de données.

    8. Cliquez sur Suivant pour afficher un récapitulatif des paramètres de votre fournisseur JDBC.
    9. Cliquez sur Fin lorsque l'ensemble de la configuration du fournisseur JDBC vous convient. La page Collection de fournisseurs JDBC s'affiche et présente le nouveau fournisseur JDBC dans un tableau avec les autres fournisseurs configurés pour la même portée.
  4. Définissez une source de données. WebSphere Application Server utilise l'objet source de données pour obtenir des connexions à la base de données et gérer ces connexions.
    1. Dans la console d'administration de WebSphere Application Server for z/OS, accédez à la page de la version de la source de données dont vos applications ont besoin. Si vous avez besoin de la prise en charge de transactions à deux phases, utilisez exclusivement une source de données de la version standard la plus récente. Les sources de données version 4 ne prennent pas en charge les connexions participant aux transactions en deux phases.
      Les deux méthodes suivantes vous permettent d'accéder à la page appropriée :
      • Cliquez sur Ressources > JDBC > Sources de données ou sur Sources de données (WebSphere Application Server version 4).
      • Cliquez sur Ressources > JDBC > Fournisseurs JDBC > fournisseur_JDBC > Sources de données ou Sources de données (WebSphere Application Server version 4).
    2. Sélectionnez la portée à laquelle les applications peuvent utiliser la source de données. Vous pouvez choisir cellule, noeud, cluster ou serveur. Pour plus d'informations, voir la rubrique Paramètres de portée de la console d'administration.
      Version 4 uniquement : A partir de maintenant, la procédure de création de sources de données (WebSphere Application Server version 4) diffère de la création de sources de données de la dernière version standard. Pour configurer une source de données version 4, procédez comme suit :
      • Cliquez sur Nouveau pour accéder à la page de la console permettant de définir les propriétés requises.
      • Dans cette page de propriétés, indiquez les valeurs des zones groupées sous l'en-tête Configuration. Le serveur d'applications a besoin de ces propriétés pour implémenter les classes du pilote JDBC; pour plus d'informations sur les valeurs valides, consultez la rubrique Paramètres minimum requis des sources de données par fournisseur.
      • Enregistrez la configuration en cliquant sur OK. Vous avez à présent terminé les premières tâches de configuration de la source de données.
      • En option : définissez d'autres propriétés prises en charge par le fournisseur JDBC DB2 Universal. Le serveur d'applications les appelle des propriétés personnalisées et exige que vous les définissiez également sur la source de données. Commencez par cliquer sur le lien Propriétés personnalisées qui apparaît maintenant dans la page de la console d'administration. Vous pouvez obtenir plus d'informations sur les propriétés de source de données facultatives dans le guide Application Programming Guide and Reference for Java de votre version de DB2 for z/OS.
    3. Cliquez sur Nouveau. Cette action entraîne le lancement et l'affichage de la page Saisie des informations de source de données de base par l'assistant Créer une source de données. La première zone, en lecture seule, indique la portée. Elle affiche votre sélection antérieure.
    4. Indiquez une source de données dans la zone Nom de la source de données. Ce nom n'est utilisé qu'à des fins d'administration.
    5. Saisissez un nom JNDI Java Naming and Directory Interface) dans la zone Nom JNDI. WebSphere Application Server utilise le nom JNDI pour lier les références des ressources d'application à cette source de données. Pour plus d'informations sur JNDI, voir la rubrique Désignation.
    6. Configurez un alias géré par composant pour sécuriser votre source de données si vous prévoyez d'implémenter une connectivité driverType 4 avec le pilote JDBC DB2 Universal. Si vous prévoyez d'utiliser la connectivité driverType 2, inutile de définir un alias. Dans ce cas, le gestionnaire de connexion utilise un alias d'authentification par défaut, à savoir l'identité de l'utilisateur d'une unité d'exécution lorsque celle-ci distribue une requête getConnection.

      Un alias géré par composant est constitué d'une combinaison d'ID et de mot de passe spécifiée dans une application pour l'authentification de la source de données. Par conséquent, l'alias que vous définissez sur la source de données doit être identique à celui du code de l'application. Pour plus d'informations sur la sécurité J2C (Java 2 Connector), voir la rubrique Gestion des entrées de données d'authentification Java 2 Connector Architecture.

      Pour définir un alias géré par composant, sélectionnez un alias existant ou créez-en un.

      • A l'aide de la liste déroulante, sélectionnez un alias d'authentification géré par composant existant.
      • Pour créer un alias, cliquez sur le lien Créer un nouvel alias. Cette action ferme l'assistant de source de données et incite la console d'administration à afficher la page de collection de données d'authentification J2C. Cliquez sur Nouveau pour définir un nouvel alias. Cliquez sur OK pour enregistrer vos paramètres et visualiser le nouvel alias dans la page de collection de données d'authentification J2C. Redémarrez l'assistant de source de données en naviguant à nouveau vers la page de collection de sources de données, en sélectionnant la portée appropriée et en cliquant sur Nouveau.
    7. Cliquez sur Suivant pour passer à la page de l'assistant de sélection d'un fournisseur JDBC.
    8. Sélectionnez un fournisseur JDBC existant ou créez-en un nouveau.
      Pour sélectionner un fournisseur JDBC existant :
      1. Cliquez sur l'option de sélection d'un fournisseur JDBC existant.
      2. Sélectionnez un pilote JDBC dans la liste déroulante.
      3. Cliquez sur Suivant. Vous visualisez à présent la page traitant de la saisie des propriétés spécifiques à la base de données pour la source de données.
      Pour créer un fournisseur JDBC :
      1. Cliquez sur l'option de création d'un nouveau fournisseur JDBC.
      2. Cliquez sur Suivant pour passer à la page traitant de la création d'un fournisseur JDBC.
      3. Utilisez la première liste déroulante afin de sélectionner DB2 for z/OS comme type de base de données.
      4. Sélectionnez le fournisseur de pilote JDBC DB2 Universal comme type de fournisseur JDBC dans la deuxième liste déroulante.
      5. Dans la troisième liste déroulante, sélectionnez le type d'implémentation nécessaire à votre application.
        Si l'application ne requiert pas de connexions prenant en charge les transactions à validation en deux phases, sélectionnez Source de données du pool de connexions. Les implémentations de connectivité driverType 2 et driverType 4 du pilote JDBC DB2 Universal prennent en charge les sources de données du pool de connexions.
        Restriction : Ne sélectionnez pas ce fournisseur si la fonction z/OS Application Connectivity to DB2 for z/OS est définie sur votre installation WebSphere Application Server for z/OS. Seule l'implémentation XA du pilote JDBC DB2 Universal prend en charge cette fonction.

        Si votre application requiert des connexions prenant en charge les transactions à validation en deux phases, sélectionnez Source de données XA. Les applications qui utilisent cette configuration de source de données bénéficient d'une reprise des transactions gérées par conteneur. Utilisez uniquement la connectivité driverType 4 pour l'implémentation XA.

        Une fois un type d'implémentation sélectionné, l'assistant complète les zones de nom et de description pour votre fournisseur JDBC. Vous pouvez saisir différentes valeurs dans ces zones ; elles ne sont utilisées qu'à des fins administratives.

      6. Cliquez sur Suivant après avoir défini le type de votre base de données, le type de fournisseur et le type d'implémentation. Vous visualisez à présent la page de l'assistant de la saisie des informations de chemin d'accès aux classes de base de données.

        Dans la plupart des cas, il n'est pas nécessaire de modifier le chemin d'accès aux classes qui remplit déjà la zone. Ce chemin d'accès aux classes correspond à la valeur de la variable d'environnement WebSphere affichée sur cette page sous la forme de ${BASE_DE_DONNEES_CHEMIN_PILOTE_JDBC}. Vous n'aurez probablement pas non plus à modifier le chemin de la bibliothèque native ni le nom de la classe d'implémentation de la source de données.

      7. Cliquez sur Suivant. Vous visualisez à présent la page traitant de la saisie des propriétés spécifiques à la base de données pour la source de données.
    9. Cochez la case Utiliser cette source de données dans la persistance CMP pour que les beans enterprise CMP (à persistance gérée par conteneur) accèdent à cette source de données.
    10. Spécifiez toutes les autres propriétés, car elles sont nécessaires à l'implémentation du pilote JDBC DB2 Universal. Il s'agit notamment des propriétés suivantes :
      • Nom de la base de données, qui correspond à l'emplacement de la base de données cible utilisée lors de l'établissement de connexions à cette source de données.
      • driverType qui est le type de connectivité JDBC utilisé par la source de données.
      • Nom du serveur, qui correspond à l'adresse TCP/IP ou au nom d'hôte du serveur DRDA (Distributed Relational Database Architecture).

        Cette propriété est requise uniquement si le type de pilote a pour valeur 4. Elle n'est pas utilisée si le type de pilote est 2.

      • Numéro de port, qui correspond au numéro de port TCP/IP sur lequel se trouve le serveur DRDA.

        Entrez une valeur pour cette propriété uniquement si driverType est 4. N'entrez pas de valeur driverType est 2.

    11. Cliquez sur Fin pour enregistrer la configuration et quitter l'assistant. Vous visualisez à présent la page Collection de sources de données, qui affiche la nouvelle configuration dans un tableau avec les autres sources de données configurées pour la même portée.

Que faire ensuite

Vous pouvez remplacer les valeurs par défaut de certaines propriétés de source de données. Cliquez sur le lien de la nouvelle source de données dans le tableau pour afficher la page de configuration générale des propriétés de source de données requises. Vous pouvez également définir d'autres propriétés prises en charge par le pilote JDBC DB2 Universal. Le serveur d'applications exige que vous les définissiez en tant que propriétés personnalisées sur la source de données. Vous pouvez obtenir plus d'informations sur les propriétés de source de données facultatives dans le guide Application Programming Guide and Reference for Java de votre version de DB2 for z/OS.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_jdbcdb2cfg
Nom du fichier : tdat_jdbcdb2cfg.html