Définit le comportement d'optimisation de 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.
Cette propriété est détectée uniquement si la propriété finalRepositoryProperties
est également définie, sinon elle est ignorée.
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.
- atStartupAndForOutput
- Indique que les valeurs atStartup et forOutput sont
activées.
- 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 de 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 de client pureQuery utilise
les propriétés d'exécution pureQuery récupérées ainsi que les données pureQueryXML.
- Si l'optimisation de 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 de client pureQuery par défaut,
définissez le 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 nécessaire pour exécuter les données SQL statiques ou avec les substitutions SQL,
indiquez une autre configuration.
- 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 de client pureQuery tente de récupérer les données pureQuery.
Si la capture incrémentielle est activée, une tentative d'écriture des données
SQL capturées est effectuée.
- 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.
- Les environnements suivants empêchent la création d'une unité d'exécution de minuteur et
la propriété propertiesRefreshInterval est ignorée :
- procédure DB2 z/OS Java™ Stored
- CICS
Le contrôle des mises à jour sur les propriétés d'exécution pureQuery ou les données pureQueryXML
est désactivé lorsque la propriété cmx.controllerDiscoveryInterval est
paramétrée sur -2. Le fait de paramétrer la propriété sur -2 désactive la reconnaissance automatique
pour Performance Expert Extended Insight.
Dans ces environnements,
l'application est exécutée avec SQL dynamique. Si l'optimisation de 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.