Syntaxe des entrées du fichier Default.bindProps pour la configuration du support des instructions SQL statiques dans le code pureQuery

Utilisez le fichier Default.bindProps pour spécifier les options déterminant la façon dont les accès des instructions SQL doivent être définis dans les modules DB2.

Dans ce fichier, vous pouvez spécifier des options qui s'appliquent à toutes les interfaces incluses dans votre projet. Vous pouvez également spécifier des options propres à chaque interface.

Vous pouvez ajouter des commentaires à ce fichier. Chaque commentaire doit commencer par le symbole #.

Lorsque vous créez ou éditez des entrées, il vous est possible d'afficher une aide en appuyant sur les touches CTRL+ESPACE (ou sur votre propre combinaison de touches si vous avez changé la combinaison par défaut).

Pour vous aider à comprendre les diagrammes de syntaxe, voir Comment lire les diagrammes de syntaxe.

Le diagramme suivant illustre la syntaxe admise pour la définition des options par défaut dans ce fichier.

Lire le diagrammeSauter le diagramme
>>-defaultOptions--=-------------------------------------------->

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

>--+----------------+--+--------------------------+------------->
   |            (2) |  '- -isolationLevel--+-CS-+-'   
   '-| -grant |-----'                      +-RR-+     
                                           +-RS-+     
                                           '-UR-'     

>--+--------------------------+--------------------------------><
   |                      (3) |   
   '-| Options de trace |-----'   

Remarques:
  1. Pour la syntaxe, voir la description de ces options.
  2. Pour la syntaxe, voir la description de cette option.
  3. Pour la syntaxe, voir la description de ces options.

Le diagramme ci-après illustre la syntaxe admise pour la définition des options individuellement applicables aux différentes interfaces répertoriées dans le fichier.

Lire le diagrammeSauter le diagramme
>>-package_java.interface--=------------------------------------>

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

>--+----------------+--+--------------------------+------------><
   |            (2) |  '- -isolationLevel--+-CS-+-'   
   '-| -grant |-----'                      +-RR-+     
                                           +-RS-+     
                                           '-UR-'     

Remarques:
  1. Pour la syntaxe, voir la description de ces options.
  2. Pour la syntaxe, voir la description de cette option.
defaultOptions
Indique que les options figurant sur la ligne s'appliquent aux instructions SQL de toutes les interfaces répertoriées dans ce fichier. Une seule ligne du fichier peut commencer par ce mot clé.
package_Java.interface (au début d'une ligne d'un fichier d'options)
Indique que les options figurant sur la ligne s'appliquent uniquement aux instructions SQL de l'interface spécifiée. Ces options remplacent celles que vous spécifiez par défaut.
Vous devez qualifier le nom de l'interface avec le nom du package Java auquel l'interface appartient.
-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. Si vous préparez votre programme en vue de son exécution sur un système DB2 for z/OS, spécifiez des options DB2 for z/OS. Si vous préparez votre programme en vue de son exécution sur un système DB2 for Linux, UNIX et Windows, spécifiez des options DB2 for Linux, UNIX et Windows.

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.
L'option de définition d'accès REOPT peut être utile pour le code pureQuery. Cette option permet d'utiliser des marqueurs de paramètre dans les instructions SQL et offre un nouveau supplément de performances au niveau des chemins d'accès DB2. Consultez les liens suivants pour des informations sur l'utilisation de cette option avec les bases de données DB2 prises en charge :
options DBRM
Utilisez les options DBRM pour générer des fichiers DBRM plutôt que de créer des packages. 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 package 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
>>- -generateDBRM--+-TRUE--+-- -outputDBRMPath--chemin---------><
                   '-FALSE-'                             

-generateDBRM
Indique si des fichiers DBRM doivent être générés à la place de packages. 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 package racine que vous indiquez lorsque vous exécutez le générateur. Si ce nom comporte plus de sept caractères, l'utilitaire StaticBinder émet une exception.

-outputDBRMPath chemin
Indique le répertoire dans lequel sauvegarder le fichier DBRM généré. La valeur par défaut est le répertoire à partir duquel vous exécutez l'utilitaire StaticBinder.
-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 et 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).

Restriction : Vous ne pouvez pas utiliser l'option -grant lorsque l'option -generateDBRM a pour valeur TRUE.

-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 -forceSingleBindIsolation lors de l'exécution de l'utilitaire Generator.
L'utilitaire StaticBinder ajoute la valeur 1 au nom du package ou du fichier DBRM créé, à moins que vous ayez utilisé l'option -forceSingleBindIsolation 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 -forceSingleBindIsolation lors de l'exécution de l'utilitaire Generator.
L'utilitaire StaticBinder ajoute la valeur 2 au nom du package ou du fichier DBRM créé, à moins que vous ayez utilisé l'option -forceSingleBindIsolation 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 package 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 -forceSingleBindIsolation lors de l'exécution de l'utilitaire Generator.
L'utilitaire StaticBinder ajoute la valeur 3 au nom du package ou du fichier DBRM créé, à moins que vous ayez utilisé l'option -forceSingleBindIsolation 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 package ou au fichier DBRM créé, à moins que vous ayez utilisé l'option -forceSingleBindIsolation lors de l'exécution de l'utilitaire Generator.
L'utilitaire StaticBinder ajoute la valeur 4 au nom du package ou du fichier DBRM créé, à moins que vous ayez utilisé l'option -forceSingleBindIsolation lors de l'exécution de l'utilitaire Configure.

Commentaires