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

Utilisez le fichier Default.genProps pour définir les options applicables aux modules DB2 devant contenir les instructions SQL dont les accès ont été définis.

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 applicables à toutes les interfaces répertoriées dans le fichier.

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

>--+---------------------------------------------+-------------->
   '- -baseDataOverride--package_java.nom_classe-'   

>--+----------------------------------+------------------------->
   |               .-NULLID---------. |   
   '- -collection--+-nom_collection-+-'   

>--+--------------------------------+--------------------------->
   '- -pkgVersion-- -+-AUTO-------+-'   
                     '-ID_version-'     

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

>--+------------------------+--+--------------------------+----><
   '- -xmlFile--fichier_XML-'  |                      (1) |   
                               '-| options de trace |-----'   

Remarques:
  1. 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--=------------------------------------>

>--+---------------------------------------------+-------------->
   '- -baseDataOverride--package_java.nom_classe-'   

>--+----------------------------------+------------------------->
   |               .-NULLID---------. |   
   '- -collection--+-nom_collection-+-'   

>--+--------------------------------+--------------------------->
   '- -pkgVersion-- -+-AUTO-------+-'   
                     '-ID_version-'     

>--+----------------------------------+------------------------->
   '- -rootPkgName--racine_nom_module-'   

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

>--+------------------------+----------------------------------><
   '- -xmlFile--fichier_XML-'   

-baseDataOverride package_java.nom_classe
Indique le nom d'une classe Java que l'implémentation générée va étendre. Par défaut, les classes d'implémentation générées étendent la classe com.ibm.pdq.runtime.generator.BaseData. Si vous spécifiez votre propre classe, vous pouvez étendre la classe d'implémentation générée avec vos propres méthodes.
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é.
module_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 module Java auquel l'interface appartient.
-collection nom_collection
Qualificatif des modules pour lesquels l'utilitaire pureQuery StaticBinder définit des accès. Ce qualificatif doit satisfaire aux contraintes applicables aux noms de collection pour la base de données DB2 que vous utilisez.
Si vous ne définissez pas ce paramètre, celui-ci prend la valeur par défaut NULLID.
-pkgVersion AUTO|ID_version
Indique la version du module à utiliser lorsque la définition d'accès est effectuée.

DB2 accepte la présence simultanée de plusieurs versions d'un même module, ce qui vous permet de définir les accès des nouveaux modules sans devoir remplacer les anciennes versions des modules portant un nom identique. Si vous rencontrez des difficultés avec une version récente d'un module, vous pouvez toujours utiliser une version plus ancienne de ce module.

Si vous n'utilisez pas cette option, les modules de base de données résultant de définitions d'accès ultérieures sont créés sans version.

AUTO
Indique que la version doit être générée de façon automatique en utilisant l'horodatage en cours.
ID_version
Indique l'identificateur de version d'un package. La chaîne entrée doit être valide pour la version de DB2 que vous utilisez.
L'utilitaire Configure crée une copie du fichier pureQueryXML en ajoutant l'ID version au nom de ce fichier. L'ID version ne peut donc inclure que des caractères valides pour les noms de fichier sur votre système d'exploitation. Par ailleurs, la chaîne et le nom du module ne peuvent pas excéder la longueur acceptée par votre système d'exploitation pour les noms de fichier.

La vérification de la version au moment de l'exécution est basée sur la marque de cohérence, et non pas sur le nom de la version.

-rootPkgName racine_nom_module
Indique la racine du nom à utiliser pour les modules DB2. Pour tout détail concernant la façon dont l'utilitaire Configure crée les noms des modules DB2, voir la description donnée pour sqlLimit.

La valeur racine_nom_module doit respecter les contraintes imposées par la base de données DB2 que vous utilisez.

Si vous prévoyez de générer des fichiers DBRM avec l'utilitaire pureQuery StaticBinder plutôt que de créer des modules DB2, vous devez utiliser des majuscules pour la valeur racine_nom_module et cette valeur ne doit pas comporter plus de 6 caractères. L'utilitaire Configure ajoute des caractères à la racine du nom soit lorsque le fichier pureQueryXml contient des instructions DDL, soit lorsque le nombre maximal d'instructions par module (défini avec sqlLimit) est atteint. Si vous utilisez l'utilitaire StaticBinder pour générer un fichier DBRM, cet utilitaire émet une exception dès lors que vous dépassez un total de 8 caractères pour la combinaison racine_nom_module / caractères supplémentaires consécutifs à l'intervention de l'utilitaire Configure / niveau d'isolement.

-forceSingleBindIsolation TRUE | FALSE
Indique si vous prévoyez la création d'un package DB2 pour un niveau d'isolement unique et si vous souhaitez associer un nombre au nom du package pour indiquer son niveau d'isolement. La valeur par défaut est FALSE, ce qui signifie que l'indicateur numérique est attaché.
Utilisez cette option avec l'option -isolationLevel dans le fichier Default.bindProps.

Si vous souhaitez utiliser l'option -isolationLevel pour définir les accès d'un seul jeu d'instructions en deux ou trois packages différents (chaque package à un autre niveau d'isolement), n'utilisez pas l'option -forceSingleBindIsolation lorsque vous exécutez l'utilitaire Configure sur le fichier pureQueryXML dans lequel apparaît le jeu d'instructions.

Par exemple, dans un fichier d'options pour l'utilitaire StaticBinder, supposez que vous avez inclus les deux entrées suivantes :

C:/dir/captureFile.pdqxml:MYPKGA = -isolationLevel UR
C:/dir/captureFile.pdqxml:MYPKGA = -isolationLevel CS

Si vous avez utilisé l'option -forceSingleBindIsolation lors de l'exécution de l'utilitaire Configure sur le fichier captureFile.pdqxml, l'utilitaire StaticBinder effectue les actions suivantes :

  1. Définition des accès du package MYPKGA au niveau d'isolement UR.
  2. Redéfinition des accès du package MYPKGA au niveau d'isolation CS.

Le résultat est un package MYPKGA unique dont les accès sont définis au niveau d'isolement CS.

Si vous voulez avoir deux packages MYPKGA comme résultat, un au niveau d'isolement UR et l'autre au niveau CS, n'utilisez pas l'option -forceSingleBindIsolation lors de l'exécution de l'utilitaire Configure sur captureFile.pdqxml.

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 n'indiquez pas de fichier pour l'écriture des entrées de journal et si vous sélectionnez toute valeur autre que OFF pour cette option, les entrées sont écrites dans la vue Console.
-xmlFile fichier-XML
Nom du fichier de configuration XML contenant les instructions SQL qui spécifient ou remplacent les instructions SQL des méthodes définies dans l'interface. Un fichier de configuration XML peut également écraser les définitions des beans correspondants.

Commentaires