Syntaxe d'exécution de l'utilitaire StaticBinder pour l'optimisation client avec un fichier d'options

Vous pouvez utiliser une commande et un fichier d'options pour indiquer les noms des fichiers pureQueryXML et les options de création de modules DB2 ou de fichiers DBRM reposant sur ces fichiers. Vous pouvez également utiliser un fichier d'options même si vous ne disposez que d'un seul fichier pureQueryXML.

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.

Lorsque vous exécutez l'utilitaire StaticBinder à partir d'une ligne de commande et que vous utilisez un fichier d'options, l'utilitaire reconnaît les options selon l'ordre de priorité suivant :
  1. Options dans la ligne de commande
  2. Options pour des fichiers pureQueryXML et jeux d'instructions individuels qui se trouvent dans le fichier d'options spécifié
  3. Options par défaut dans le fichier d'options spécifié
Lire le diagrammeSauter le diagramme
                                        (1)   
>>-java--com.ibm.pdq.tools.StaticBinder------------------------->

>--+------------------------------------------------------------------------------------------------------------------------+-->
   |  (2)                                                                                                                   |   
   '------- -url--jdbc--:--db2--:--//--serveur--+---------+--/--base_de_données-- -username--username-- -password--password-'   
                                                '-:--port-'                                                                     

>--+-------------------------------------------------------------------+-->
   |                 .-----------------------------------------------. |   
   |                 V                                               | |   
   '- -pureQueryXml----+-fichier_pureQueryXML----------------------+-+-'   
                       '-fichier-pureQueryXML--:--nom-package-base-'       

>-- -optionsFile--nom_fichier----------------------------------->

>--+-----------------------------+------------------------------>
   |                   .-FALSE-. |   
   '- -differenceOnly--+-TRUE--+-'   

>--+--------------------------+--+--------------------------+--->
   |                .-FALSE-. |  |                      (3) |   
   '- -showDetails--+-TRUE--+-'  '-| options de trace |-----'   

>--+-------------------------------+---------------------------->
   '- -verifyPackages--+-DETAIL--+-'   
                       '-SUMMARY-'     

>--+--------------------------+--------------------------------><
   |                .-FALSE-. |   
   '- -validateXml--+-TRUE--+-'   

Remarques:
  1. Vous pouvez spécifier les options dans n'importe quel ordre.
  2. Si vous ne précisez pas d'URL, d'ID utilisateur et de mot de passe dans la commande, vous devez les indiquer dans le fichier d'options, si vous ne créez pas uniquement des fichiers DBRM.
  3. Pour la syntaxe, voir la description de ces options.

Descriptions des options

-optionsFile nom_fichier
Nom du fichier, chemin absolu ou relatif inclus, qui répertorie les fichiers pureQueryXML contenant les instructions SQL pour lesquelles vous voulez définir des accès.
-password mot_de_passe
Mot de passe à utiliser pour établir la connexion à la source de données.
-pureQueryXml fichier-pureQueryXML|fichier-pureQueryXML:nom-package-base
Spécifie le fichier pureQueryXML qui contient les jeux d'instructions SQL dont vous voulez définir les accès en tant que package ou un seul jeu d'instructions SQL dont vous voulez définir les accès en tant que package. Vous pouvez spécifier plusieurs valeurs.
fichier_pureQueryXML
Nom du fichier pureQueryXML. Par exemple,C:\directory\captureFile.pdqxml .
Ce 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.
fichier-pureQueryXML:nom-package-base
Nom du fichier pureQueryXML et nom de base du package pour lequel les accès doivent être définis. Par exemple, C:\directory\captureFile.pdqxml:MYPKGA .

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.

Le nom de base du package est la valeur de l'attribut name de l'élément package qui décrit le package dans le fichier pureQueryXML. Le nom de base est constitué de deux parties :
  • Le nom du package racine
  • Tout caractère ajouté par l'utilitaire Configure au nom du package racine en raison de la valeur de l'option sqlLimit lors du dernier traitement par l'utilitaire Configure du fichier pureQueryXML
si vous utilisez -pureQueryXml conjointement avec -optionsFile dans une seule commande, un certain nombre de sorties sont possibles. Voir Utilisation d'un fichier d'options lors de la spécification des fichiers pureQueryXML et des ensembles d'instructions dans une commande.
options de trace
Vous pouvez demander à ce que le fichier journalise les messages et préciser le niveau d'information à journaliser.
Lire le diagrammeSauter le diagramme
>>-+--------------------------+--------------------------------->
   '- -traceFile--nom_fichier-'   

>--+---------------------------+-------------------------------><
   |               .-OFF-----. |   
   '- -traceLevel--+-ALL-----+-'   
                   +-SEVERE--+     
                   +-WARNING-+     
                   +-INFO----+     
                   +-CONFIG--+     
                   +-FINE----+     
                   +-FINER---+     
                   '-FINEST--'     

-traceFile nom_fichier
Indique le chemin absolu ou relatif ainsi que le nom du fichier à utiliser pour la journalisation des informations relatives à l'opération.
Si le fichier existe déjà, pureQuery ajoute les nouveaux messages à la suite des messages déjà placés dans ce fichier. Par défaut, les entrées sont écrites dans System.err.
-traceLevel OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST|ALL
Indique le type d'informations à journaliser. Le niveau par défaut est OFF. Si vous ne spécifiez pas de fichier dans lequel écrire les entrées de journal et que vous associez cette option à une valeur autre qu'OFF, les entrées sont écrites dans System.err.
-url URL_connexion
URL JDBC de type 4 pour la connexion à la base de données.
-username ID utilisateur
ID utilisateur à indiquer pour établir la connexion à la source de données.
-verifyPackages DETAIL|SUMMARY
Indique si l'utilitaire StaticBinder génère un rapport sur les packages existants et non existants pour les instructions SQL associées au fichier pureQueryXML. Si vous utilisez cette option, l'utilitaire StaticBinder ne définit pas l'accès aux packages.

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.

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.

Cependant, si vous avez exécuté l'utilitaire Configure sur myApp.pdqxml après la première 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 trouvera aucun des packages correspondant à ces nouvelles valeurs. Dans son rapport, l'utilitaire StaticBinder indiquera que les modules que vous recherchez sont introuvables.

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.

Vous pouvez spécifier 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.

DETAIL
Génère un rapport expliquant les informations suivantes, basées sur les valeurs des options -collection, -pkgVersion, et -rootPkgName:
  • Packages existants.
  • Packages non existants. Pour chaque package, le rapport répertorie le nom, la marque de cohérence, l'horodatage, et le niveau d'isolement.
  • Nombre de packages existants et non existants.
SUMMARY
Génère un rapport qui énumère les packages existants et non existants, en fonction des valeurs des options -collection, -pkgVersion, et -rootPkgName.
-validateXml TRUE|FALSE
Indique si la validation du schéma XML s'effectue sur les fichiers pureQueryXML en entrée à l'aide du schéma pureQueryXML. Si la valeur est TRUE, la validation s'effectue. Si la valeur est FALSE ou si l'option n'est pas définie, la validation ne s'effectue pas. La valeur par défaut est FALSE.

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.


Commentaires