Utilisée avec des applications CLI ou .NET, l'optimisation client pureQuery
offre des mécanismes permettant d'effectuer la consignation des enregistrements et le traçage des fichiers avec
des niveaux de gravité configurables.
Avant de commencer
Pour d'utiliser
les fonctions pureQuery, vous devez activer pureQuery Runtime pour IBM® Data Server CLI Driver version
9.7 Fix pack 3 ou version ultérieure, avec IBM Optim
pureQuery Runtime 2.1 ou version ultérieure.
Pourquoi et quand exécuter cette tâche
L'optimisation client pureQuery fournit des fonctionnalités de
consignation et de traçage avec une gravité configurable. La consignation et
le traçage peuvent fournir les informations nécessaires sur chaque niveau afin de
prendre en charge la détermination des incidents lors de l'exécution. La tâche explique comment définir les propriétés
d'exécution des fonctionnalités de traçage et de consignation de pureQuery Runtime.
Vous
pouvez définir les deux mots-clés suivants dans le fichier de configuration
db2cli.ini
ou
dsdriver.cfg :
- traceFile
- Définit le fichier dans lequel les informations de consignation sont
écrites. Vous pouvez
utiliser un chemin d'accès absolu ou un chemin d'accès relatif vers le répertoire dans
lequel s'exécutent les applications CLI ou .NET. Si le fichier existe, de
nouveaux messages de journal sont ajoutés au contenu existant du fichier.
- traceLevel
- Spécifie le niveau de détail à écrire dans le fichier journal. Les niveaux sont
les suivants, du moins détaillé au plus détaillé :
- OFF
- SEVERE
- WARNING
- INFO
- CONFIG
- FINE
- FINER
- FINEST
- ALL
Le niveau par défaut est OFF.
Les mots-clés peuvent être spécifiés en tant que propriété
de connexion d'application, dans le fichier
db2cli.ini ou dans
un fichier
dsdriver.cfg. Si un mot-clé est spécifié
dans plusieurs endroits, l'ordre de priorité du plus haut au plus bas
est le suivant :
- Propriété de connexion d'application
- Fichier db2cli.ini
- Fichier dsdriver.cfg
Exemple
Les lignes suivantes définissent traceFile par /user/CLIOPTtraces.log
et traceLevel par INFO dans le fichier db2cli.ini :
traceFile=/user/CLIOPTtraces.log
traceLevel=INFO
Si vous utilisez un fichier db2dsdriver.cfg, une autre
solution consiste à définir les mots-clés en tant qu'attributs dans les éléments des
paramètres :
<parameter name="traceFile" value="/user/CLIOPTtraces.log" />
<parameter name="traceLevel" value="INFO" />