Personnalisation et liaison de profils pour le langage SQL dans les applications Java (SQLJ)

Simplifiez la personnalisation et la liaison des profils SQL pour Java pour vos applications en accomplissant ces fonctions à l'aide de la console d'administration ou d'un script. Les profils SQL pour Java doivent être personnalisés et liés avant que l'application d'entreprise ne puisse utiliser le SQL incorporé dans l'application.

Avant de commencer

Vous devez disposer d'une application SQL pour Java qui a déjà été déployée et installée sur le serveur d'applications.
Pour les applications SQL pour Java qui utilisent la persistance gérée par conteneur, vous pouvez déployer l'application de deux manières :
  • Déployez l'application SQL pour Java sur le serveur d'applications. Consultez la rubrique relative au déploiement d'applications SQL pour Java qui utilisent la persistance gérée par conteneur pour plus d'informations.
  • Déployez des applications SQL pour Java avec l'outil ejbdeploy. Consultez la rubrique relative au déploiement d'applications SQL pour Java qui utilisent la persistance gérée par conteneur avec l'outil ejbdeploy.
Pour les applications SQL pour Java qui utilisent la persistance gérée par le bean, consultez la rubrique relative au déploiement d'applications SQL pour Java qui utilisent la persistance gérée par le bean des servlets ou des beans session.

Pourquoi et quand exécuter cette tâche

Pour profiter des avantages offerts par les applications SQL pour Java dans le serveur d'applications, vous devez personnaliser les profils SQL pour Java qui contiennent les instructions SQL incorporées. Par défaut, quatre modules DB2 sont créés dans la base de données ; un pour chaque niveau d'isolation. Le processus de personnalisation ajoute aux profils des informations spécifiques à la base de données DB2. La base de données utilise ces informations à l'exécution.

En plus de personnaliser les profils, vous devez lier les profils personnalisés à la base de données DB2. La liaison des profils ne doit être effectuée qu'une fois les profils SQL pour Java personnalisés.

Vous pouvez également personnaliser et lier des profils à l'aide d'un script ou de l'outil db2sqljcustomize :
  • Pour la prise en charge des scripts, consultez la rubrique relative aux groupes de commandes de gestion des applications de l'objet AdminTask.
  • Pour plus d'informations sur l'outil db2sqljcustomize, consultez la rubrique relative à la personnalisation et à la liaison des profils SQL pour Java avec l'outil db2sqljcustomize. Si vous personnalisez des profils à l'aide de l'outil db2sqljcustomize vous devez réinstaller l'application.

Procédure

  1. Assurez-vous que les tables de base de données nécessaires existent, comme décrit dans la rubrique relative au déploiement d'applications d'accès aux données.
  2. Accédez à l'application SQL pour Java installée sur le serveur d'applications. Cliquez sur Applications > Applications Websphere enterprise > nom_app.
    Eviter les incidents Eviter les incidents: N'exécutez pas plusieurs sessions de la console d'administration pour personnaliser et lier les profils situés dans un même fichier EAR.gotcha
  3. Accédez à la section des profils SQL pour Java. Cliquez sur Profils SQL pour Java. Lorsque vous cliquez sur ce lien, le serveur d'applications développe le fichier EAR de l'application dans un répertoire temporaire. Il peut y avoir un certain retard de l'affichage du panneau des profils SQL pour Java.
  4. Sélectionnez l'option de personnalisation et de liaison de profils ou Packages de liaison. Choisissez une option en fonction des profils avec lesquels vous travaillez :
    • Si vos profils n'ont pas été personnalisés ou que vous souhaitez de nouveau les personnaliser, choisissez l'option de personnalisation et de liaison de profils.
    • Si les profils sont déjà personnalisés, choisissez Package de liaison.
  5. Choisissez des profils ou un groupe de profils à personnaliser et lier.
    • Sélectionnez des profils dans la liste fournie.
      1. Sélectionnez les profils dans la liste, puis cliquez sur Ajouter. La liste affiche les profils SQL pour Java présents dans l'application d'entreprise.
        Pratiques recommandées Pratiques recommandées:
        • Maintenez la touche CTRL enfoncée pour sélectionner plusieurs profils.
        • Sélectionnez le premier nom de profil, maintenez la touche SHIFT enfoncée, puis sélectionnez le dernier profil pour sélectionner une liste contiguë de profils. Vous sélectionnez ainsi le premier et le dernier profil, ainsi que tous ceux se trouvant entre les deux.
        bprac
      2. Sélectionnez Personnalisez/liez les profils SQL pour Java sélectionnés en tant que groupe. Cette option indique au serveur d'applications de créer un fichier .grp qui contient les profils SQL pour Java traités. Vous pouvez utiliser le fichier .grp pour d'autres liaisons ultérieures. Après en avoir fini avec ce panneau, cliquez sur OK. On vous propose alors de télécharger le fichier .grp.
    • Sélectionnez Utilisez un fichier de groupes de profils pour spécifier des profils SQL pour Java à personnaliser/lier. Vous pouvez ainsi indiquer un groupe de profils à traiter. Cliquez sur Parcourir... pour localiser le fichier sur le système.
  6. Indiquez les informations requises pour la connexion à la base de données. Vous devez remplir les zones suivantes :
    URL de base de données
    Indique l'URL de la base de données à laquelle le ou les profils seront liés. la syntaxe type est :
    jdbc:db2://<host name="">:<port>/<database name="">.</database></port></host> or 
    or
    fully_qualified_host_name:port
    Utilisateur
    Indique l'ID utilisateur de l'administrateur de la base de données sur le serveur où se situe la base de données.
    Mot de passe
    Indique le mot de passe de l'administrateur de la base de données sur le serveur où se situe la base de données.
    Options supplémentaires
    Indique des options supplémentaires à utiliser pendant la personnalisation et la liaison. Consultez la documentation DB2 pour une liste complète des options de personnalisation.
    Chemin d'accès aux classes
    Indique le chemin d'accès aux classes où se trouvent sqlj.zip et db2jcc.jar ou db2jcc4.jar.
  7. Cliquez sur OK.
    Eviter les incidents Eviter les incidents: Si vous traitez une application d'entreprise de grande taille ou de nombreux profils SQL pour Java, le processus peut prendre plus longtemps que le délai d'attente par défaut de la console d'administration. Le délai d'attente de connexion par défaut de la console d'administration du serveur est de 30 minutes. Si le délai d'attente par défaut est atteint et que vous perdez la connexion au serveur, vous pouvez vérifier le journal de sortie système pour prendre connaissance des résultats finals du processus de personnalisation et de liaison.

    Pour empêcher cette déconnexion, allongez le délai d'attente de la session de la console. Après une liaison et une personnalisation réussies, vérifiez dans le journal de sortie système le temps de traitement total. Utilisez cette durée comme base pour le nouveau délai d'attente. Pour plus d'informations sur la configuration du délai d'attente de la console, consultez la rubrique relative à la modification de l'expiration de la session de console.

    gotcha

Résultats

Une fois que le serveur d'applications a fini de traiter les profils SQL pour Java, les résultats de la personnalisation et de la liaison s'affichent. Le panneau de résultat affiche des messages issus du serveur de la base, ainsi que des résultats récapitulatifs provenant du serveur d'applications.
Si l'opération a réussi, le message suivant s'affiche dans le journal système :
ADMA0507I=ADMA0507I: The SQLJ operation on application {0} completed successfully.  Exit code: {1}
ADMA0507I.explanation=This informational message indicates the program status.
ADMA0507I.useraction=No user action is required.
Si l'opération a échoué le message suivant s'affiche dans le journal de sortie système :
ADMA0506I=ADMA0506I: The SQLJ operation on application {0} did not complete successfully.  Exit code: {1}
ADMA0506I.explanation=The SQLJ operation encountered a problem.  Ce message d'information indique 
l'état du programme. Prior messages in the command output give details of the problem.
ADMA0506I.useraction=Check the command output for the cause of the problem.

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_sqljcustomize
Nom du fichier : tdat_sqljcustomize.html