Propriété de l'amélioration dynamique SQL de méthodes d'extension personnalisées

Cette page permet de modifier des réglages de propriétés d'amélioration dynamique SQL de méthodes d'extension personnalisées.

Les propriétés de JVM (Java virtual machine) et de bean (module) suivantes sont fournies afin de garantir la bonne exécution d'extensions dynamiques SQL pour des méthodes de localisation personnalisées définies dans une interface home EJB 1.1 utilisant un magasin de données dorsal qui nécessite des clauses de verrouillage SQL spéciales. Ces propriétés vous permettent d'indiquer quelles méthodes de localisation personnalisées doivent être étendues, en supposant que le magasin de données dorsal prend en charge les clauses SQL.

[IBM i] [AIX Solaris HP-UX Linux Windows] Pour les plateformes IBM i et réparties, pour afficher cette page de la console d'administration, cliquez sur Serveurs > Types de serveurs > Serveurs d'applications WebSphere > nom_serveur > Gestion de processus et Java > Définition de processus > Machine virtuelle Java > Propriétés personnalisées

[z/OS] Pour z/OS, pour afficher cette page de la console d'administration, cliquez sur Serveurs > Types de serveurs > Serveurs d'applications WebSphere > nom_serveur > Contrôle (pour définir la propriété dans le contrôle) ou Serviteur (pour définir la propriété dans le serviteur) > Gestion de processus et Java > Définition de processus > Machine virtuelle Java > Propriétés personnalisées.

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent

Permet d'indiquer quels beans enterprise sont concernés par l'extension SQL dynamique lors de l'exécution.

Cette propriété prend effet au niveau serveur. Toute méthode de localisation personnalisée définie dans une interface home EJB 1.1 (avec préfixe find) dont la tentative d'accès est de type Mise à jour, est candidate à l'extension SQL dynamique pour les méthodes de localisation personnalisées en fonction du niveau d'isolement indiqué. Tout code SQL spécial requis par la base de données dorsale est mis en oeuvre. Le code SQL employé varie selon le niveau d'isolement que vous choisissez pour les beans de l'application et selon la base de données dorsale utilisée. Si elle est réglée sur all, l'extension SQL dynamique s'applique à toutes les méthodes de localisation personnalisées définies dans tous les beans installés dans le conteneur. Si elle est réglée sur J2EENAME[:J2EENAME], où J2EENAME désigne un paquetage ou un nom de bean pleinement qualifié, l'extension SQL dynamique n'est activée que pour les méthodes de localisation personnalisées dans les beans installés dans le conteneur et représentés par les noms de bean indiqués.

Informations	valeur
Type de données	Chaîne
Plage de valeurs	Les valeurs valides sont all ou J2EENAME[:J2EENAME]
Valeur par défaut	Comportement inactif pour l'extension SQL

Remarque : Certaines applications peuvent utiliser des méthodes de localisation personnalisées codées manuellement et contiennent les clauses de verrouillage SQL ou les mots-clés ORDER BY et DISTINCT sur l'opération SELECT. Dans ces instances, l'extension SQL dynamique risque de générer des instructions SQL erronées exécutées sur le magasin de données dorsal sous-jacent. Si une application contient ces méthodes de localisation personnalisées, vous devez définir avec soin la valeur de la propriété JVM com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent. La valeur all a pour effet d'implémenter à l'ensemble des beans du serveur d'applications l'extension SQL dynamique des méthodes de localisation personnalisée dont la tentative d'accès est de type mise à jour ; cette opération induit des erreurs de syntaxe SQL pour ce groupe de méthodes de localisation personnalisées.

Pour éviter cela évitez de régler le paramètre de niveau serveur sur all. Préférez la propriété de niveau méthode, com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel afin que l'implémentation de l'extension SQL dynamique ne s'applique qu'aux méthodes de localisation personnalisées concernées.

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel

Définit au niveau méthode l'implémentation de l'extension SQL dynamique des méthodes de localisation personnalisées pour un bean précis.

Quand cette propriété de bean pointe vers une liste de méthodes de localisation personnalisées, les instructions de verrouillage SQL sont mises en oeuvre pour toute méthode de localisation personnalisée (ayant pour préfixe find) défini sur l'interface home et de paramètre de méthode et de signature correspondant. Ceci se produit uniquement si la tentative d'accès de la méthode de localisation personnalisée est de type mise à jour et si le magasin de données dorsal prend en charge les clauses SQL. Le code SQL employé varie selon le niveau d'isolement que vous choisissez pour l'application et selon le magasin de données dorsal utilisé.

Informations	valeur
Type de données	Chaîne
Plage de valeurs	La valeur admise est une chaîne sous la forme : method1(parm1,parm2,..parmn):method2(parm1,parm2,..parmn):methodn(...)

com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent

Permet aux utilisateurs WebSphere Application Server for z/OS Version 4.x d'indiquer que la fonction d'extension SQL ne doit pas être appliquée aux applications installées dans le produit WebSphere Application Server for z/OS.

Par défaut, WebSphere Application Server for z/OS Version 4.x effectue des extensions SQL dynamiques. Cet attribut permet aux utilisateurs z/OS de désactiver aux niveaux bean et serveur l'extension SQL dynamique de méthodes de localisation personnalisées pour la version 4.x.

Au niveau bean, une paire nom/valeur se compose de ce nom d'attribut et de la valeur true, ce qui a pour effet de désactiver l'extension SQL pour toute méthode de localisation personnalisée de l'interface home du bean indiqué.

Au niveau serveur, la valeur true associée à l'entrée appropriée dans le fichier de propriétés de WebSphere Application Server for z/OS a pour effet de désactiver l'extension SQL de tous les beans installés sur le serveur indiqué.

Au niveau bean, le produit prend toujours en charge cet attribut d'extension de méthode de localisation personnalisée. Son utilisation en tant qu'indicateur de niveau serveur est déconseillée car, par défaut, les versions antérieures n'étendent pas dynamiquement le code SQL des méthodes de localisation personnalisées.

Remarque : Si l'installation WebSphere Application Server for z/OS repose sur l'extension automatique dynamique de toutes les méthodes de localisation personnalisées, affectez à l'indicateur com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent la valeur all. Si une application contient un bean dont l'indicateur com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent pointe vers ses paramètres env-var, ce dernier continue d'être utilisé, à condition que les fonctions d'extension dynamique SQL du produit soient activées comme indiqué précédemment.

Informations	valeur
Type de données	Chaîne
Plage de valeurs	Les valeurs valides sont true et false

Remarques à propos de la priorité :

L'attribut com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel remplace tout attribut de niveau serveur ou de niveau bean.
Tout bean figurant dans la liste Nom J2EE de l'indicateur com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent déclenche l'extension dynamique pour les méthodes de localisation personnalisées qui lui sont associées, même si le comportement par défaut est actif pour le serveur en question.
L'attribut com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent désactive l'utilisation de cette fonctionnalité pour un bean précis si le paramètre de niveau serveur ou de niveau bean activé alors qu'aucun paramètre de niveau méthode n'est indiqué.

Nom du fichier : udat_sqllock.html