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 modules DB2
dans le fichier pureQueryXML. Vous employez l'utilitaire StaticBinder pour
créer des modules DB2 à partir des
instructions SQL et d'autres informations du fichier pureQueryXML et vous liez
les modules à 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 jeux
d'instructions nommés. Les noms des jeux d'instructions sont fonction de 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 modules qui contiennent des instructions
SQL et vous liez ces modules à la base de données. Dans l'environnement de
scénario, vous créez des modules sur la base de données de test qui utilise le
qualificatif TEST. L'utilitaire StaticBinder crée les modules à partir des jeux
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 spécifie que l'utilitaire Configure doit configurer le fichier entier. 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 jeux 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
-bindOption
"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"
-username "myuser" -password "mypwd"
-isolationLevel CS
-bindOptions "QUALIFIER TEST"
-pureQueryXml testApp.pdqxml -showDetails true
L'utilitaire StaticBinder lie les modules à un emplacement de connexion
indiqué dans le fichier pureQueryXml.
L'option StaticBinder -isolationLevel CS spécifie que
StaticBinder crée un seul module 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 l'application vers un environnement de
production pour ce scénario, exécutez l'utilitaire StaticBinder avec l'option
-bindOptions "QUALIFIER PROD" afin de créer des modules qui
contiennent des instructions SQL 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 module '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 modules en entrée :'1'
Nombre de modules en entrée pour lesquels isBindable est faux : '0'
Nombre de modules en entrée dont aucune instruction ne peut être liée : '0'
Nombre de modules 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.