Le fichier pureQueryXML que vous
avez créé à l'aide de l'utilitaire Merge pureQuery contient des instructions
SQL qui sont capturées à partir de l'application WebSphere.
Vous vous servez de l'utilitaire Configure pureQuery pour
spécifier les caractéristiques des packages DB2
dans le fichier pureQueryXML. Vous employez l'utilitaire StaticBinder pour
créer des packages DB2 à partir des
instructions SQL et d'autres informations du fichier pureQueryXML et vous liez
les packages à la base de données de transactions.
Pourquoi et quand exécuter cette tâche
Une fonction importe de l'utilitaire Configure consiste à
regrouper les instructions SQL dans le fichier pureQueryXML en ensembles d'instructions nommés. Le nom des ensembles d'instructions est basé sur la valeur
de l'option -rootPkgName et les regroupements sont basés sur
les options de configuration que vous indiquez.
Avec l'utilitaire
pureQuery StaticBinder, vous créez des packages qui contiennent des instructions
SQL et vous liez ces packages à la base de données. Dans l'environnement de
scénario, vous créez des packages sur la base de données de test qui utilise le
qualificatif TEST. L'utilitaire StaticBinder crée les packages à partir des ensembles d'instructions qui sont définis dans le fichier pureQueryXML.
Procédure
Pour configurer le fichier pureQueryXML et lier les instructions SQL
dans le fichier :
- Configurez le fichier pureQueryXML qui contient les données SQL capturées.
Pour utiliser l'utilitaire Configure sur le fichier pureQueryXML
testApp.pdqxml, exécutez la commande suivante :
java com.ibm.pdq.tools.Configure
-rootPkgName testApp
-cleanConfigure TRUE
-pureQueryXml testApp.pdqxml
–validateXml TRUE
L'option -cleanConfigure TRUE indique que l'utilitaire Configure doit configurer le fichier dans son intégralité. Si vous configurez un fichier
pureQueryXML qui a été précédemment configuré, vous pouvez utiliser l'option
-cleanConfigure FALSE.
L'utilitaire Configure tente de préserver le contenu des ensembles d'instructions
existants, préalablement configurés et liés dans le fichier pureQueryXML.
L'option -validateXml spécifie que l'utilitaire Configure
effectue la validation de schéma XML pour vérifier que le fichier pureQueryXML est
conforme au schéma pureQueryXML XML. L'utilitaire Configure affiche toutes
les erreurs de syntaxe XML qui se trouvent dans le fichier pureQueryXML.
Conseil : Par défaut, l'utilitaire Configure utilise l'ID de collecte NULLID.
Si vous souhaitez qu'il utilise une collecte différente, vous pouvez indiquer la
collecte à l'aide de l'option -collection.
- Liez les instructions SQL dans le fichier pureQueryXML.
Pour ce scénario, l'application s'exécute dans l'environnement de test et les
instructions SQL ont été capturées dans l'environnement de test. Pour lier les
instructions SQL capturées dans l'environnement de test, exécutez l'utilitaire
pureQuery StaticBinder à l'aide de l'option
-bindOptions
"QUALIFIER TEST" afin de lier les instructions de test dans la base de
données de test.
java com.ibm.pdq.tools.StaticBinder –url "jdbc:db2://testserver.test.com:32706/sample retrieveMessagesFromServerOnGetMessage=1;"
-username "myuser" -password "mypwd"
-isolationLevel CS
-bindOptions "QUALIFIER TEST"
-pureQueryXml testApp.pdqxml -showDetails TRUE
L'utilitaire StaticBinder lie les packages à un emplacement de connexion
indiqué dans le fichier pureQueryXml.
L'option StaticBinder -isolationLevel CS spécifie que
StaticBinder crée un seul package avec un niveau d'isolement de lecture non
reproductible.
Le niveau d'isolement de lecture non reproductible est le niveau par
défaut des bases de données DB2 for
Linux,
UNIX et Windows.
Conseil : Lorsque vous migrez une application d'un environnement de test vers un environnement de production, l'environnement de production peut utiliser des schémas différents de ceux de l'environnement de test. Si les schémas sont différents, veillez à indiquer l'option de liaison QUALIFIER appropriée. Dans ce scénario, le schéma de l'environnement de test est TEST et le schéma de l'environnement de production est PROD. Pour l'environnement de production, vous devez indiquer l'option de liaison -bindOptions "QUALIFIER PROD" de l'utilitaire StaticBinder pour créer des packages dans la base de données de production.
Le résultat de la commande est similaire à l'exemple suivant :
IBM Optim pureQuery Runtime 2.2.0.3 build 2.18.118
Licensed Materials - Property of IBM
5724-U16
(c) Copyright IBM Corp. 2006, 2010 All Rights Reserved.
================================================================================
L'utilitaire StaticBinder commence l'opération de liaison pour le
fichier pureQueryXml 'C:\test\pureQuery-test\zz-merged.pdqxml'.
Début de traitement des options : -url
"jdbc:db2://testserver.test.com:32706/sample
" -username "*****" -password "*****"
-pureQueryXml "testApp.pdqxml"
-isolationLevel "CS"
-bindOptions "QUALIFIER TEST" -showDetails "true"
L'utilitaire StaticBinder a lié avec succès le package 'TESTAPP'
pour le niveau d'isolement 'CS'.
Nombre d'instructions en entrée : '8', nombre d'instructions liées : '8',
options de liaison : 'ISOLATION CS QUALIFIER TEST'
L'opération de liaison s'est terminée avec succès pour 'testApp.pdqxml'.
Nombre de packages en entrée :'1'
Nombre de packages en entrée pour lesquels isBindable est faux : '0'
Nombre de packages en entrée dont aucune instruction ne peut être liée : '0'
Nombre de packages en entrée pouvant être liés, traités par l'utilitaire Static Binder : '1' : [TESTAPP]
================================================================================
Résultats de l'activité de l'utilitaire StaticBinder :
Nombre des éléments pour lesquels l'opération de liaison a REUSSI : 1
Que faire ensuite
Dans la tâche suivante, vous mettez à jour le référentiel à l'aide du
fichier pureQueryXML et des propriétés d'exécution pureQuery qui permettent à
l'application d'exécuter des instructions SQL de façon statique.