Vous pouvez faire figurer les fichiers pureQueryXML dans la commande et n'utiliser que l'entrée defaultOptions dans le fichier d'options.
Vous pouvez faire figurer des fichiers pureQueryXML dans la commande et le fichier d'options. Si un fichier figure à la fois dans la commande et le fichier d'options, l'utilitaire StaticBinder le traite. Si un fichier figure dans le fichier d'options, mais pas dans la commande, l'utilitaire StaticBinder ne le traite pas. Si un fichier figure dans la commande, mais pas dans le fichier d'options, l'utilitaire StaticBinder le traite avec les options de la ligne de commande et dans l'entrée defaultOptions du fichier d'options.
(1) >>-java--com.ibm.pdq.tools.StaticBinder-------------------------> >--+--------------------------------------------------------------------------------------------------------------------------------+--> | (2) | '------- -url--jdbc--:--db2--:--//--serveur--+---------+--/--base_de_données-- -username--ID-utilisateur-- -password--motdepasse-' '-:--port-' >--+-------------------------------------------------------------------+--> | .-----------------------------------------------. | | V | | '- -pureQueryXml----+-fichier_pureQueryXML----------------------+-+-' '-fichier-pureQueryXML--:--nom-package-base-' >-- -optionsFile--nom_fichier-----------------------------------> >--+-----------------------------+------------------------------> | .-FALSE-. | '- -differenceOnly--+-TRUE--+-' >--+--------------------------+---------------------------------> | .-FALSE-. | '- -showDetails--+-TRUE--+-' .-NOT_SET------. >-- -statementBindError--+-REMOVE-------+-----------------------> '-MARK_INVALID-' >--+--------------------------+---------------------------------> | (3) | '-| Options de trace |-----' >--+-------------------------------+----------------------------> '- -verifyPackages--+-DETAIL--+-' '-SUMMARY-' >--+--------------------------+-------------------------------->< | .-FALSE-. | '- -validateXml--+-TRUE--+-'
Le fichier doit avoir l'extension .pdqxml ou .xml. Il doit s'agir d'une ressource placée dans le chemin d'accès aux classes de l'application, ou bien vous devez indiquer le chemin complet ou relatif de ce fichier.
Par exemple, supposez que vous avez exécuté l'utilitaire StaticBinder sur un fichier pureQueryXML appelé capture.pdqxml. L'utilitaire crée les package MYPKGA, MYPKGB et MYPKGC. Vous modifiez ensuite l'ensemble d'instructions MYPKGA dans capture.pdqxml avec le plan de travail et vous exécutez l'utilitaire Configure sur ce fichier, avec l'option -cleanConfigure associée à sa valeur par défaut FALSE. L'utilitaire Configure affecte une nouvelle marque de cohérence à l'ensemble d'instructions car ce jeu a été modifié. Lorsque vous exécutez à nouveau l'utilitaire StaticBinder sur capture.pdqxml pour définir les accès de la nouvelle version de MYPKGA, vous spécifiez -differenceOnly TRUE. L'utilitaire redéfinit uniquement les accès de MYPKGA et non ceux des deux autres packages.
>>-+--------------------------+---------------------------------> '- -traceFile--nom_fichier-' >--+---------------------------+------------------------------->< | .-OFF-----. | '- -traceLevel--+-ALL-----+-' +-SEVERE--+ +-WARNING-+ +-INFO----+ +-CONFIG--+ +-FINE----+ +-FINER---+ '-FINEST--'
Les instructions SQL qui ont été précédemment marquées comme étant non valides n'apparaissent pas dans le rapport.
Vous pouvez restaurer les instructions SQL marquées comme étant non valides à l'aide de l'option de configuration -restoreInvalidSQLForce. Vous pouvez supprimer des instructions à l'aide de l'option -removeInvalidSQL.
Si l'option -statementBindError est spécifiée avec la valeur MARK_INVALID ou REMOVE, les fichiers pureQueryXML doivent être accessibles en écriture. Si l'utilitaire StaticBinder ne peut pas mettre le fichier à jour, une erreur s'affiche et le fichier n'est pas traité.
L'option -statementBindError n'est pas prise en charge lors de la liaison des classes d'implémentation de l'interface pureQuery DAO (Data Access Object). Si l'utilitaire StaticBinder n'est pas exécuté pour lier une classe d'implémentation et que l'option est spécifiée avec la valeur MARK_INVALID ou REMOVE, l'utilitaire affiche un avertissement et n'essaie pas de lier les classes.
-url jdbc:db2://localhost:50000/SAMPLE:enableNamedParameterMarkers=1;
Par exemple, admettons que vous exécutiez l'utilitaire Configure sur un fichier pureQueryXML appelé myApp.pdqxml. Lors de l'exécution de l'utilitaire, vous avez indiqué les valeurs des options -collection, -pkgVersion, et -rootPkgName, et l'utilitaire a stocké ces valeurs dans le fichier pureQueryXML. Vous exécutez l'utilitaire StaticBinder, en indiquant le nom de ce fichier, et l'utilitaire crée les packages DB2.
Plus tard, vous souhaitez afficher une liste des packages créés par l'utilitaire StaticBinder à partir du fichier pureQueryXML. Lorsque vous exécutez l'utilitaire, vous pouvez utiliser l'option -verifyPackages, en indiquant la valeur DETAIL, puis en indiquant à nouveau le nom du fichier.
L'option -verifyPackages ne fonctionne pas si, suite à l'exécution de l'utilitaire Configure puis de l'utilitaire StaticBinder sur un fichier pureQueryXML, vous avez exécuté à nouveau l'utilitaire Configure sur ce fichier et indiqué des valeurs différentes pour les options -collection, -pkgVersion, et -rootPkgName.
Si vous avez exécuté l'utilitaire Configure sur myApp.pdqxml après l'exécution de l'utilitaire StaticBinder et que vous avez modifié la valeur de l'une des options -collection, -pkgName ou -rootPkgName, l'utilitaire StaticBinder ne détecte pas de packages correspondant à ces nouvelles valeurs. Dans son rapport, l'utilitaire StaticBinder indique que les packages recherchés sont introuvables.
Si les valeurs des options -collection, -pkgVersion, et -rootPkgName sont identiques à celles définies lors de la précédente exécution de l'utilitaire StaticBinder, l'utilitaire trouve les packages et les répertorie.
Vous pouvez indiquer cette option avec l'option -bindOptions. Cependant, l'utilitaire StaticBinder ne définira pas les accès des packages. Utilisez -bindOptions uniquement pour indiquer la collecte des packages que vous souhaitez vérifier si vous avez utilisé cette option pour spécifier la collecte lors de la création des packages.
La réussite ou l'échec de la validation du schéma XML est déterminée et rapportée dans chaque fichier en entrée. Si un fichier en entrée échoue, l'exécution de l'utilitaire StaticBinder ne s'arrête pas et les fichiers ultérieurs seront traités.
Si un fichier pureQueryXML échoue lors de la validation de schéma, les packages contenus dans ce fichier ne seront pas liés. La première erreur de validation de schéma et l'échec de liaison pour le fichier sont reportés.
Seules les versions actuelle ou précédente des fichiers pureQueryXML sont validées (version 4 ou 3). Si une version antérieure de pureQueryXML est détectée, la validation ne s'effectue pas sur ce fichier.