Syntaxe des entrées d'un fichier d'options de l'utilitaire StaticBinder pour l'optimisation client

Ce diagramme de syntaxe affiche les options que vous pouvez définir pour chaque fichier pureQueryXML figurant dans un fichier d'options.
Lire le diagrammeSauter le diagramme
                                                    (1)   
>>-+-fichier_pureQueryXML----------------------+--=------------->
   '-fichier-pureQueryXML--:--nom-package-base-'          

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

>--+---------------------------------------------------------+-->
   '-+-----------------------------------------------------+-'   
     '-+- -bindOptions-- -"--options_définition_accès--"-+-'     
       |                  (4)                            |       
       '-| options DBRM |--------------------------------'       

>--+-----------------------------+--+----------------+---------->
   |                   .-FALSE-. |  |            (5) |   
   '- -differenceOnly--+-TRUE--+-'  '-| -grant |-----'   

>--+--------------------------+--+--------------------------+--->
   '- -isolationLevel--+-CS-+-'  |                .-FALSE-. |   
                       +-RR-+    '- -showDetails--+-TRUE--+-'   
                       +-RS-+                                   
                       '-UR-'                                   

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

Remarques:
  1. Vous pouvez spécifier les options dans n'importe quel ordre.
  2. Si vous ne précisez pas les URL, ID utilisateur et mot de passe lors de l'utilisation de l'option -bindOptions, vous devez le faire sur la ligne de commande ou dans l'entrée defaultOptions.
  3. Les options -url, -username- et -password ne sont pas nécessaires si vous créez uniquement des fichiers DBRM.
  4. Pour la syntaxe, voir la description de ces options.
  5. Pour la syntaxe, voir la description de cette option.

Descriptions des options

-bindOptions "chaîne_options_définition_accès"
Ces options sont équivalentes aux options DB2 de précompilation et de définition d'accès dont les noms sont identiques. La syntaxe de la chaîne est la suivante : "option_1 valeur_1 option_2 valeur_2".

Pour la liste et les descriptions de ces options, voir Commande BIND.

Si vous utilisez l'option de définition d'accès CONCURRENTACCESSRESOLUTION dans DB2 Version 9.7 for Linux, UNIX, and Windows, l'option s'applique à toutes les instructions se trouvant dans des packages associés au niveaux d'isolement CS et RR. Cette option, qui s'applique uniquement à ces deux niveaux d'isolement, permet aux applications de trouver la dernière valeur validée dans les lignes verrouillées par les autres applications.
options DBRM
Utilisez les options DBRM pour générer des fichiers DBRM plutôt que de créer des modules. Ces options ne sont applicables que si vous utilisez DB2 for z/OS.

Une fois les fichiers DBRM créés par l'utilitaire StaticBinder, vous devez les copier dans un fichier. Le nom du fichier DBRM est préfixe.DBRMLIB.DATA, où préfixe représente le qualificatif de haut niveau qui est indiqué dans le profil TSO de l'utilisateur. En règle générale, préfixe correspond à votre ID utilisateur dans TSO.

Si le fichier DBRM n'existe pas, vous devez le créer. Ce fichier doit disposer de suffisamment d'espace pour contenir toutes les instructions SQL, avec un supplément d'espace pour chaque nom de variable hôte ainsi qu'un certain nombre d'informations d'en-tête. Les informations d'en-tête requièrent environ deux enregistrements pour chaque module d'interrogation de base de données (DBRM), et il faut prévoir 20 octets pour chaque enregistrement SQL et 6 octets pour chaque variable hôte. Pour le format DBRM précis, reportez-vous à la macro de mappage DBRM, DSNXDBRM, dans la bibliothèque préfixe.SDSNMACS.

Le diagramme de syntaxe suivant décrit les options permettant de générer des fichiers DBRM.

Lire le diagrammeSauter le diagramme
                   .-FALSE-.                             
>>- -generateDBRM--+-TRUE--+-- -outputDBRMPath--chemin---------><

-generateDBRM TRUE|FALSE
Indique si des fichiers DBRM doivent être générés à la place de modules. Par défaut, si generateDBRM prend la valeur TRUE, l'utilitaire StaticBinder génère quatre fichiers DBRM, c'est-à-dire un pour chaque niveau d'isolement : CS, RR, RS et UR. Il vous est toutefois possible de générer un unique fichier DBRM en spécifiant l'option -isolationLevel.

Le nom racine des fichiers DBRM générés est le nom de module racine que vous indiquez lorsque vous exécutez l'utilitaire Configure.

La valeur par défaut est FALSE.

-outputDBRMPath chemin
Indique le répertoire dans lequel les fichiers du module d'interrogation de base de données seront sauvegardés. La valeur par défaut est le répertoire à partir duquel vous exécutez l'utilitaire StaticBinder.
-differenceOnlyTRUE|FALSE
Indique de ne pas remplacer les packages DB2 ayant des noms de collection, de module et des marques de cohérence qui correspondent à ces valeurs pour les jeux d'instructions se trouvant dans le fichier pureQueryXML sur lequel vous exécutez l'utilitaire StaticBinder.

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 le jeu d'instructions MYPKGA dans capture.pdqxml et vous exécutez l'utilitaire Configure sur ce fichier, avec l'option -cleanConfigure sur sa valeur par défaut de FALSE. L'utilitaire Configure affecte une nouvelle marque de cohérence au jeu 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.

La valeur par défaut est FALSE.
-grant "grantees(premier_ID,deuxième_ID,...)"
Donne la liste (entre parenthèses avec virgules de séparation) des bénéficiaires d'autorisations auxquels vous voulez accorder le privilège EXECUTE pour les modèles créés par l'utilitaire StaticBinder. Si vous n'utilisez pas cette option, l'utilitaire StaticBinder n'accorde pas ce privilège.
Lire le diagrammeSauter le diagramme
                             .-,-------------------.          
                             V                     |          
>>- -grant-- "--grantees--(----+-ID_autorisation-+-+--) - "----><
                               '-PUBLIC----------'            

grantees
Liste des ID autorisation, séparés par des virgules, auxquels vous voulez accorder le privilège EXECUTE. Assurez-vous que les ID autorisation répertoriés sont valides pour la base de données DB2 que vous utilisez.

Pour DB2 Database for Linux, UNIX, and Windows : vous pouvez utiliser les mots clés USER, GROUP et ROLE. Pour tout détail concernant ces mots clés, voir GRANT (Package Privileges) statement.

Pour DB2 for z/OS : vous pouvez utiliser le mot clé ROLE. Pour tout détail concernant ce mot clé, voir GRANT (package privileges).

Restrictions :

  • Vous ne pouvez pas utiliser l'option -grant lorsque l'option -generateDBRM prend la valeur TRUE.
  • Dans un fichier d'options, vous pouvez utiliser l'option -grant soit sur la ligne defaultOptions, soit au niveau d'une ou plusieurs entrées du fichier. Vous ne pouvez pas utiliser -grant aux deux emplacements dans un même fichier d'options.
-isolationLevel CS | RR | RS | UR
Indique que vous souhaitez générer un package DB2 unique ou un fichier DBRM pour un niveau d'isolement particulier, plutôt qu'un package DB2 ou un fichier DBRM pour les quatre niveaux d'isolement.

Le niveau d'isolement s'applique à toutes les instructions SQL du package. Si vous définissez un niveau d'isolement à l'aide de la méthode Connection.setTransactionIsolation() du pilote IBM® Data Server Driver for JDBC and SQLJ, pureQuery ignore ce niveau d'isolement pour les instructions exécutées de manière statique.

UR
Indique le niveau d'isolement Lecture non validée.
L'utilitaire StaticBinder ajoute la valeur 1 au nom du package ou du fichier DBRM créé, à moins que vous ayez utilisé l'option -forceSingleIsolationLevel lors de l'exécution de l'utilitaire Configure.
CS
Indique le niveau d'isolement Lecture non reproductible.
L'utilitaire StaticBinder ajoute la valeur 2 au package ou au fichier DBRM créé, à moins que vous ayez utilisé l'option -forceSingleIsolationLevel lors de l'exécution de l'utilitaire Configure.
RS
Indique le niveau d'isolement Lecture stable. La lecture stable garantit l'exécution isolée des instructions SQL du module par rapport aux autres processus de l'application pour les lignes qui sont lues et modifiées par cette application.
L'utilitaire StaticBinder ajoute la valeur 3 au nom du package ou du fichier DBRM créé, à moins que vous ayez utilisé l'option -forceSingleIsolationLevel lors de l'exécution de l'utilitaire Configure.
RR
Indique le niveau d'isolement Lecture reproductible.
L'utilitaire StaticBinder ajoute la valeur 4 au nom du package ou du fichier DBRM créé, à moins que vous ayez utilisé l'option -forceSingleIsolationLevel lors de l'exécution de l'utilitaire Configure.
-password mot_de_passe
Mot de passe à utiliser pour établir la connexion à la source de données.
fichier_pureQueryXML
Spécifie le fichier pureQueryXML qui contient les jeux d'instructions SQL dont vous voulez définir les accès en tant que package. 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
Spécifie le fichier pureQueryXML et un seul jeu d'instructions SQL dans ce fichier, pour lequel vous voulez définir les accès en tant que package. 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
-showDetails TRUE|FALSE
Indique si l'utilitaire StaticBinder doit afficher des informations récapitulatives sur les packages DB2 qu'il produit et sur les instructions SQL contenues dans les fichiers pureQueryXML qu'il traite.
La valeur par défaut est false.
-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.
-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