- -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 chaîne peut avoir l'un des formats suivants :
- "option_1 valeur_1 option_2 valeur_2"
- "option_1(valeur_1) option_2(valeur_2)"
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.
- -configureWarning configuration-avertissements
- Indique les avertissements générés par l'utilitaire pureQuery Configure. Les différentes valeurs d'avertissement sont séparées par un espace.
Lorsque vous indiquez l'option -optionsFileForBind de l'utilitaire Configure, l'utilitaire génère un fichier d'options StaticBinder. Le fichier d'options contient des options de liaison et d'autres informations reposant sur les instructions SQL, les ensembles d'instructions et des informations du registre spécial DB2 figurant dans le fichier pureQueryXML. L'utilitaire Configure ajoute l'option -configureWarning aux options de liaison lorsqu'il détecte un incident potentiel. Si vous liez des packages à la base de données en utilisant les options de liaison indiquées et exécutez les instructions SQL en mode statique, le comportement obtenu risque d'être incorrect.
L'utilitaire Configure ajoute également une marque d'avertissement à une ligne de commentaire de l'ensemble d'instructions.
Les commentaires peuvent contenir des avertissements et des informations relatives à l'ensemble d'instructions et à l'instruction SQL de l'ensemble. Pour plus d'informations sur la correction des avertissements, reportez-vous aux informations sur les marques générées avec les avertissements à la rubrique Fichier d'options de liaison par l'utilitaire ConfigureSi vous indiquez l'option -configureWarning lors de l'exécution de l'utilitaire StaticBinder, l'utilitaire tente de lier les packages associés. Il affiche également un message d'avertissement indiquant l'incident.
L'option -configureWarning peut utiliser les valeurs suivantes :
- INCREMENTAL_SPECIAL_REGISTER_VALUES_PRESENT
- Dans le fichier pureQueryXML, l'attribut XML d'une ou de plusieurs instructions SQL d'un ensemble d'instructions contient l'attribut incrementalSpecialRegValuesUsed.
L'attribut enregistre l'utilisation des nouveaux ensembles de valeurs des registres spéciaux.
Les ensembles d'instructions ont été regroupés en fonction des paramètres des registres spéciaux.
Toutefois, les nouveaux ensembles de valeurs des registres spéciaux n'ont pas été inclus dans le regroupement.
L'utilitaire Configure ajoute également la marque incrementalSpecialRegValuesPresent à une ligne de commentaire de l'ensemble d'instructions.
- SPECIAL_REGISTER_VALUE_SET_MISSING
- Cette valeur indique que les instructions SQL de l'ensemble d'instructions font référence à des ensembles de valeurs des registres spéciaux. Toutefois, les ensembles de valeurs des registres spéciaux ne sont pas définis dans le fichier pureQueryXML.
L'utilitaire Configure ajoute également la marque missingSpecialRegValueId(ID) à une ligne de commentaire de l'ensemble d'instructions.
- MULTIPLE_SPECIAL_REGISTER_VALUE_SETS
- Cette valeur indique que chacune des instructions SQL de l'ensemble d'instructions a été exécutée avec plusieurs ensembles de valeurs des registres spéciaux.
L'utilitaire Configure ajoute également la marque SQLGroupedBySpecialRegisters(MULTI_SRINFO) à une ligne de commentaire de l'ensemble d'instructions.
- SPECIAL_REGISTER_GROUPING_INCONSISTENT
- Cette valeur indique que l'ensemble d'instructions n'est pas regroupé correctement en fonction des paramètres des registres spéciaux.
L'utilitaire Configure ajoute également la marque SQLGroupedBySpecialRegisters(INCONSISTENT_SRINFO) à une ligne de commentaire de l'ensemble d'instructions.
- 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.

.-FALSE-.
>>- -generateDBRM--+-TRUE--+-- -outputDBRMPath--chemin---------><
- -generateDBRM TRUE|FALSE
- 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 l'utilitaire Configure.
La valeur par défaut
est FALSE.
- -outputDBRMPath chemin
- Indique le répertoire dans lequel les fichiers du package 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 package et des marques de cohérence qui correspondent à ces valeurs pour les ensembles 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 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.
- -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.

.-,-------------------.
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
Configure.
- CS
- Indique le niveau d'isolement Lecture non reproductible.
- 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
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
-forceSingleBindIsolation 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 ensembles 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 ensemble 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 que l'utilitaire Configure ajoute au nom du package racine lorsque plusieurs noms de package sont nécessaires.
Par exemple, l'utilitaire crée plusieurs packages lorsque le nombre d'instructions SQL d'un ensemble d'instructions dépasse la valeur de l'option -sqlLimit de l'utilitaire Configure.
- -showDetails TRUE|FALSE
- Indique si l'utilitaire StaticBinder doit afficher des informations détaillées 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.
- -statementBindError NOT_SET|MARK_INVALID|REMOVE
- Indique comment l'utilitaire StaticBinder gère les instructions SQL
dans le fichier pureQueryXML lorsque le processus de liaison renvoie une erreur SQL
à l'instruction. Il n'existe pas de valeur par défaut. Si l'option n'est pas définie,
l'utilitaire StaticBinder signale les instructions SQL qui renvoient
une erreur SQL pendant le processus de liaison à mesure qu'elles se manifestent. La
liste suivante décrit les valeurs prises en charge et la manière dont les instructions SQL sont gérées :
- NOT_SET
- Indique que les instructions SQL du fichier pureQueryXML ne sont pas
modifiées. Cette valeur correspond à la valeur par défaut.
- MARK_INVALID
- Indique que le fichier pureQueryXML est mis à jour afin de signaler que l'instruction
SQL est non valide lorsque des tentatives de liaison génèrent une erreur SQL. Les erreurs SQL et les instructions SQL qui sont marquées comme étant non valides sont affichées à la fin de l'opération de liaison de l'ensemble d'instructions contenant les instructions.
Les instructions SQL qui ont été précédemment marquées comme étant non valides
n'apparaissent pas dans le rapport.
Vous pouvez
restaurer les instructions SQL marquées comme étant non valides à l'aide de l'option de configuration
-restoreInvalidSQLForce. Vous pouvez supprimer des instructions
à l'aide de l'option -removeInvalidSQL.
- REMOVE
- Indique que l'instruction SQL est supprimée du fichier pureQueryXML
lorsque la tentative de liaison génère une erreur SQL. Les erreurs SQL et les instructions SQL qui sont
supprimées sont affichées à la fin de l'opération de liaison
de l'ensemble des instructions contenant les instructions.
Les instructions SQL qui ont été précédemment marquées comme étant non valides sont aussi supprimées.
ATTENTION :
Si vous utilisez cette option avec la valeur
MARK_INVALID ou REMOVE,
votre fichier pureQueryXML peut être modifié. L'utilitaire met à jour le fichier
afin de marquer une instruction SQL comme étant non valide ou supprimer l'instruction du
fichier.
Si l'option -statementBindError est spécifiée
avec la valeur MARK_INVALID ou REMOVE,
les fichiers pureQueryXML doivent être accessibles en écriture. Si l'utilitaire StaticBinder ne peut pas mettre le fichier à jour, une erreur s'affiche et le fichier n'est pas
traité.
Les éléments suivants affectent la capacité de l'utilitaire
StaticBinder à détecter des instructions SQL non valides :
- La spécification de l'option StaticBinder -differenceOnly
avec la valeur TRUE. L'utilitaire StaticBinder n'essaie pas
de lier toutes les instructions SQL. Il détecte
les instructions SQL non valides dans les ensembles d'instructions qu'il n'essaie pas de lier.
- La spécification de l'option de liaison SQLERROR (CONTINUE) ou VALIDATE (RUN)
avec l'option StaticBinder -bindOptions. Si l'une des
options BIND est indiquée, les diagnostics DB2
devant être signalés en tant qu'erreurs SQL sont signalés à la place comme avertissements SQL.
L'utilitaire StaticBinder ne reconnaît pas les instructions SQL comme étant des instructions non valides
lorsque les diagnostics signalent des avertissements SQL.
L'option -statementBindError n'est pas prise en charge
lors de la liaison des classes d'implémentation de l'interface pureQuery DAO (Data Access Object). Si l'utilitaire StaticBinder n'est pas exécuté pour lier
une classe d'implémentation et que l'option est spécifiée avec la valeur MARK_INVALID ou REMOVE,
l'utilitaire affiche un avertissement et n'essaie pas de lier
les classes.
Remarque : Les instructions SQL non valides sont des instructions qui renvoient
une erreur SQL lors d'une tentative de liaison. Toutefois, des modifications peuvent être apportées
à un objet de base de données afin que les instructions SQL ne référencent pas cet objet comme étant non valide. Ces modifications risquent d'affecter l'application qui exécute
l'instruction SQL. Par exemple : une instruction est non valide si la définition d'une colonne type,
référencée par l'instruction, passe de VARCHAR(20) à VARCHAR(100).
- -url URL_connexion
- URL JDBC de type 4 pour la connexion à la base de données.
Si vous liez des instructions SQL qui utilisent des marqueurs de paramètre nommés, vous devez indiquer la propriété
enableNamedParameterMarkers avec la valeur 1 lorsque vous définissez la connexion à la source de données. Dans l'exemple suivant, l'option -
url permet de se connecter à la base de données SAMPLE sur testserver.test.com et de définir la propriété
enableNamedParameterMarkers:
-url jdbc:db2://localhost:50000/SAMPLE:enableNamedParameterMarkers=1;
- -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 définie sur FALSE ou si l'option
n'est pas définie, la validation n'est pas effectuée.
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.