Définit le comportement d'optimisation client pureQuery si
des erreurs se produisent lors de la récupération ou de l'écriture des données pureQuery. Si les propriétés d'exécution pureQuery
et les données pureQueryXML ne peuvent pas être
récupérées de l'emplacement défini par la propriété finalRepositoryProperties ou si le référentiel qui stocke
les données SQL capturées n'est pas accessible.
Pour l'application Java avec l'optimisation de client
pureQuery, cette propriété est reconnue uniquement si la propriété finalRepositoryProperties est également spécifiée. Sinon, elle est ignorée. La propriété finalRepositoryProperties n'est pas prise en charge pour les applications d'interface de ligne de commande activées avec l'optimisation de client pureQuery.
Cette propriété peut posséder les valeurs suivantes :
- atStartup
- Indique que l'emplacement défini par la propriété finalRepositoryProperties est
demandé au démarrage de l'application. Si les propriétés pureQuery ne sont
pas disponibles ou que des erreurs de lecture sont détectées, une exception est émise.
- forOutput
- Indique que l'écriture des premières données SQL capturées dans le référentiel
doit être effectuée avec succès. Si le référentiel n'est
pas disponible ou que des erreurs d'écriture sont détectées, une exception est émise. Si le référentiel n'est pas disponible
après le démarrage de l'application, une erreur est consignée si la consignation est activée.
L'application se poursuit et l'écriture des données SQL capturées est tentée à l'heure
suivante programmée.
La valeur n'est pas prise en charge pour les applications d'interface de ligne de commande activées avec l'optimisation de client
pureQuery.
- atStartupAndForOutput
- Indique que les valeurs atStartup et forOutput sont
activées.
La valeur n'est pas prise en charge pour les applications d'interface de ligne de commande activées avec l'optimisation de client
pureQuery.
- no
- Indique le comportement par défaut si l'emplacement défini par la propriété finalRepositoryProperties
n'est pas disponible au démarrage de l'application. La liste suivante décrit le comportement par défaut :
- L'application est exécutée avec l'optimisation client pureQuery par défaut
et la configuration d'exécution pureQuery. L'application exécute des données
SQL dynamiques.
- Si la consignation est activée, un message est consigné et indique le problème qui se pose
avec le référentiel.
- Si une unité d'exécution de minuteur peut être créée, une tentative de récupération
des propriétés d'exécution pureQuery et des données pureQueryXML est effectuée toutes les 10 minutes.
Si les informations sont récupérées, l'optimisation client pureQuery utilise
les propriétés d'exécution pureQuery récupérées ainsi que les données pureQueryXML.
- Si l'optimisation client pureQuery est configurée pour stocker les données
SQL capturées dans un référentiel et que le référentiel n'est pas disponible ou
qu'une erreur d'écriture est détectée, un message est consigné et indique le problème qui se pose
avec le référentiel. L'écriture des données SQL capturées dans le référentiel
est tentée à l'heure
suivante programmée.
Remarques sur l'utilisation
La liste suivante contient
des informations relatives à l'utilisation de la propriété repositoryRequired :
- Pour écraser le comportement d'optimisation client pureQuery par défaut,
définissez la propriété repositoryRequired parmi les propriétés
pureQuery de démarrage de l'application.
- Si la propriété repositoryRequired est définie
comme une propriété récupérée dans un référentiel, la valeur de la propriété
remplace la valeur de la propriété actuelle.
- Si l'application est requise pour exécuter le SQL statique ou le remplacement SQL, indiquez la valeur de propriété
atStartup ou atStartupAndForOutput.
- Les étapes suivantes
impliquent l'utilisation de l'environnement suivant :
- Si le référentiel qui contient les propriétés d'exécution pureQuery
et les données pureQueryXML et si, le cas échéant, le référentiel qui stocke
les données SQL capturées sont disponibles au démarrage de l'application.
- Les propriétés pureQuery et les données pureQueryXML sont récupérées et
traitées avec succès.
- La propriété propertiesRefreshInterval est activée et
est paramétrée avec une valeur supérieure à zéro.
La liste suivante décrit l'interaction qui existe entre la propriétépropertiesRefreshInterval et la propriété
repositoryRequired :
- Si, au cours d'une actualisation, l'emplacement qui stocke les propriétés pureQuery et
les données pureQueryXML n'est pas disponible, une erreur est consignée et
l'application est exécutée avec les propriétés pureQuery et pureQueryXML qui ont été récupérées
avec succès au démarrage. A chaque intervalle de l'actualisation,
l'optimisation client pureQuery tente de récupérer les données pureQuery.
- Si, au cours d'une actualisation, des mises à jour sont détectées sur les propriétés pureQuery ou
les données pureQueryXML dans l'emplacement de stockage, les données mises à jour
sont récupérées. Si des erreurs se produisent au cours de la récupération, une erreur est consignée et
les données sont ignorées. Une tentative de récupération des données pureQuery
est effectuée au cours de l'actualisation suivante.
- Si, au cours d'une actualisation, les données pureQuery mises à jour ont été récupérées, mais que les propriétés ne sont pas valides ou que les données pureQueryXML sont incorrectes, une erreur est consignée et les données récupérées sont ignorées. Une tentative de récupération des données pureQuery
est effectuée au cours de l'actualisation suivante.
- Si la valeur de la propriété cmx.controllerDiscoveryInterval est définie sur
-2 dans les environnements suivants, la création d'unité d'exécution de minuteur est interdite et la propriété
propertiesRefreshInterval est ignorée :
- Procédure DB2 z/OS Java Stored
- CICS
La valeur de la propriété est définie sur -2 afin de désactiver la reconnaissance automatique sur Performance Expert Extended Insight.
Dans ces environnements,
l'application est exécutée avec SQL dynamique. Si l'optimisation client est
configurée pour capturer les données SQL et que les données SQL capturées ne peuvent pas être écrites, une erreur est consignée et une tentative d'écriture des données SQL
capturées est effectuée ultérieurement.
Notes
d'utilisation de l'interface CLI DB2
et d'IBM Data Server Driver
Lors de l'utilisation de l'interface CLI DB2 ou
d'IBM® Data Server Driver avec
pureQuery Runtime, vous pouvez utiliser la propriété pureQuery Runtime comme mot clé de configuration.
- Syntaxe de mot clé CLI IBM
- repositoryRequired = atStartup | no
- Syntaxe de configuration d'IBM Data Server
Driver
- <parameter name="repositoryRequired" value="atStartup | no"
/>
- Mot clé de chaîne de connexion équivalent d'IBM
Data Server Provider for .NET
- N/A
Notes d'utilisation de l'interface de ligne de commande DB2
Les informations d'utilisation suivantes s'appliquent lorsque le mot clé
pureQueryXmlRepository est spécifié et que les applications d'interface de ligne de commande (CLI) sont activées avec l'optimisation de client pureQuery :
- Pour les applications CLI, seules les données du fichier pureQueryXML sont récupérées sur le référentiel. Les paramètres pureQuery Runtime ne sont pas récupérés sur le référentiel. Les paramètres pureQuery Runtime utilisés sont spécifiés dans le fichier de configuration.
- repositoryRequired prend en charge uniquement les valeurs atStartup et no.
- Lorsque vous indiquez le mot clé repositoryRequired, les mots clés
pureQueryXmlRepository et propertiesGroupId doivent également être spécifiés.
- Lorsque la valeur repositoryRequired est définie sur no et que l'emplacement du référentiel indiqué par le mot clé
pureQueryXmlRepository n'est pas disponible au démarrage, les instructions SQL sont exécutées dynamiquement avec les paramètres
pureQuery Runtime par défaut. Toutes les valeurs de mots clés pureQuery Runtime sont définies sur leurs valeurs par défaut, à l'exception du mot clé
sqlLiteralSubstitution. La valeur sqlLiteralSubstitution définie dans le fichier de configuration est retenue.
- Si la récupération du fichier de capture pureQueryXml
à partir du référentiel échoue, l'erreur SQL CLI00202E est renvoyée.