Cliquez deux fois sur ce fichier pour l'ouvrir avec un éditeur dans le plan de travail. Le fichier se trouve dans le dossier dataAccessFolder de votre projet Java™.
Dans ce fichier, vous pouvez spécifier des options qui s'appliquent à tous les fichiers pureQueryXML inclus dans votre projet. Vous pouvez également spécifier des options propres à chaque fichier pureQueryXML.
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 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.
>>-defaultOptions--=--------------------------------------------> >--+- -bindOptions-- -"--options_définition_accès--"-+----------> | (1) | '-| options DBRM |--------------------------------' >--+-----------------------------+--+----------------+----------> | .-FALSE-. | | (2) | '- -differenceOnly--+-TRUE--+-' '-| -grant |-----' >--+--------------------------+-------------------------------->< | (3) | '-| Options de trace |-----'
Le diagramme ci-après illustre la syntaxe admise pour la définition des options individuellement applicables aux différents fichiers pureQueryXML répertoriés dans le fichier.
>>-+-fichier_pureQueryXML----------------------+--=-------------> '-fichier-pureQueryXML--:--nom-package-base-' >--+- -bindOptions-- -"--options_définition_accès--"-+----------> | (1) | '-| options DBRM |--------------------------------' >--+-----------------------------+--+----------------+--------->< | .-FALSE-. | | (2) | '- -differenceOnly--+-TRUE--+-' '-| -grant |-----'
La valeur de chaque option ne doit pas contenir d'espaces.
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 et 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.
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.
.-FALSE-. >>- -generateDBRM--+-TRUE--+-- -outputDBRMPath--chemin---------><
Le nom racine des fichiers DBRM générés est le nom de package racine que vous indiquez lorsque vous exécutez l'utilitaire Configure.
La valeur par défaut est FALSE.
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.
La valeur par défaut est FALSE.
.-,-------------------. V | >>- -grant-- "--grantees--(----+-ID-autorisation-+-+--) - "---->< '-PUBLIC----------'
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.
Le niveau d'isolement s'applique à toutes les instructions SQL du package. Si vous définissez un niveau d'isolement par la méthode Connection.setTransactionIsolation() d'IBM® Data Server Driver for JDBC and SQLJ, pureQuery ignore ce niveau d'isolement pour les instructions exécutées en mode statique.
Le nom de ce fichier doit se terminer par l'extension .pdqxml ou .xml.
Le fichier doit être une ressource placée dans le chemin d'accès aux classes de votre application.
>>-+--------------------------+---------------------------------> '- -traceFile--nom_fichier-' >--+---------------------------+------------------------------->< | .-OFF-----. | '- -traceLevel--+-ALL-----+-' +-SEVERE--+ +-WARNING-+ +-INFO----+ +-CONFIG--+ +-FINE----+ +-FINER---+ '-FINEST--'
Si le fichier existe déjà, pureQuery ajoute de nouveaux messages au contenu existant du fichier. Par défaut, les entrées sont écrites dans System.err.