Paramètres du service ORB (Object Request Broker)

Cette page permet de configurer le service ORB (Object Request Broker) Java.

Pour afficher cette page de la console d'administration :

Plusieurs paramètres sont disponibles pour contrôler le traitement interne des ORB (Object Request Broker). Vous pouvez les utiliser pour améliorer les performances de vos applications lorsque celles-ci contiennent des beans enterprise. Vous pouvez modifier ces paramètres pour le serveur par défaut ou pour tout autre serveur d'applications configuré dans le domaine d'administration.

Délai d'expiration de la requête

Indique le nombre de secondes à l'issue desquelles un message de demande arrive à expiration.

Si vous utilisez un script de ligne de commande, le nom complet de cette propriété système est com.ibm.CORBA.RequestTimeout.

Type de données Entier
Unité Secondes
Valeur par défaut 180
Intervalle 0 - Entier le plus élevé reconnu par Java
Nombre de nouvelles tentatives de demande [AIX Solaris HP-UX Linux Windows] [iSeries]

Indique le nombre de fois que l'ORB tente d'envoyer une demande en cas d'échec d'un serveur. Les tentatives permettent parfois de restaurer le système en cas d'échec temporaire du réseau. Cette zone est ignorée sous z/OS.

Si vous utilisez un script de ligne de commande, le nom complet de cette propriété système est com.ibm.CORBA.requestRetriesCount.

Type de données Entier
Valeur par défaut 1
Intervalle 1 à 10
Intervalle entre les tentatives de demande [AIX Solaris HP-UX Linux Windows] [iSeries]

Indique le nombre de millisecondes séparant deux tentatives. Cette zone est ignorée sous z/OS.

Si vous utilisez un script de ligne de commande, le nom complet de cette propriété système est com.ibm.CORBA.requestRetriesDelay.

Type de données Entier
Unité Millisecondes
Valeur par défaut 0
Intervalle 0 à 60 000
Taille maximale de la cache des connexions [AIX Solaris HP-UX Linux Windows] [iSeries]

Indique le nombre maximal d'entrées pouvant figurer dans la cache des connexions ORB avant que l'ORB ne commence à supprimer les connexions inactives de la cache. Cette zone est ignorée sous z/OS.

Il est possible que le nombre de connexions actives figurant dans la cache dépasse temporairement ce seuil. Si nécessaire, l'ORB continue d'ajouter des connexions tant que des ressources sont disponibles.

Dans un script de ligne de commande, le nom complet de cette propriété système est com.ibm.CORBA.MaxOpenConnections.

Type de données Entier
Unité VConnexions
Valeur par défaut 240
Intervalle 10 - Entier le plus élevé reconnu par Java
Taille minimale de la cache des connexions [AIX Solaris HP-UX Linux Windows] [iSeries]

Indique le nombre minimal d'entrées pouvant figurer dans la cache des connexions ORB. Cette zone est ignorée sous z/OS.

L'ORB ne supprime par les connexions inactives lorsque le nombre d'entrées est inférieur à cette valeur.

Dans un script de ligne de commande, le nom complet de cette propriété système est com.ibm.CORBA.MinOpenConnections.

Type de données Entier
Unité Connexions
Valeur par défaut 100
Intervalle Tout entier dont la valeur est inférieure d'au moins 5 unités à la valeur spécifiée pour la taille maximale de la cache de connexions.
Trace de l'ORB

Permet de tracer les messages GIOP (General Inter-ORB Protocol) de l'ORB.

Ce paramètre concerne deux propriétés système : com.ibm.CORBA.Debug et com.ibm.CORBA.CommTrace. Si vous définissez ces propriétés en utilisant un script de ligne de commande, vous devez affecter la valeur true à ces deux propriétés pour activer le traçage des messages GIOP.

Type de données Booléen
Valeur par défaut Non activé (false)
Délai d'expiration de la requête de recherche [AIX Solaris HP-UX Linux Windows] [iSeries]

Indique le nombre de secondes à l'issue desquelles un message de demande de localisation arrive à expiration. Cette zone est ignorée sous z/OS.

Si vous utilisez un script de ligne de commande, le nom complet de cette propriété système est com.ibm.CORBA.LocateRequestTimeout.

Type de données Entier
Unité Secondes
Valeur par défaut 180
Intervalle 0 à 300
Forcer le tunnel [AIX Solaris HP-UX Linux Windows] [iSeries]

Contrôle la manière dont l'ORB du client tente d'utiliser les tunnels HTTP. Cette zone est ignorée sous z/OS.

Si vous utilisez un script de ligne de commande, le nom complet de cette propriété système est com.ibm.CORBA.ForceTunnel.

Type de données Chaîne
Valeur par défaut NEVER
Intervalle Les valeurs valides sont ALWAYS, NEVER et WHENREQUIRED.
Pour sélectionner une valeur appropriée, prenez en considération les informations ci-dessous :
ALWAYS
Utilise immédiatement la fonction de tunnels HTTP, sans tenter de se connecter en premier via TCP.
NEVER
Désactive les tunnels HTTP. En cas d'échec d'une connexion TCP, une exception système CORBA (COMM_FAILURE) se produit.
WHENREQUIRED
Utilise les tunnels HTTP en cas d'échec des connexions TCP.
URL de l'agent tunnel [AIX Solaris HP-UX Linux Windows] [iSeries]

Indique l'adresse Web du servlet à utiliser pour prendre en charge l'établissement de tunnels HTTP. Cette zone est ignorée sur la plateforme z/OS.

Le format de cette adresse Web doit être correct :

http://w3.mycorp.com:81/servlet/com.ibm.CORBA.services.IIOPTunnelServlet

Pour les applets : http://applethost:port/servlet/com.ibm.CORBA.services.IIOPTunnelServlet.

Cette zone est obligatoire si l'option de tunnels HTTP a été définie. Si vous utilisez un script de ligne de commande, le nom complet de cette propriété système est com.ibm.CORBA.TunnelAgentURL.

Transmission par référence

Indique comment l'ORB transmet les paramètres. Si ce paramètre est activé, l'ORB transmet les paramètres par référence et non par valeur pour éviter la copie d'objet. Si vous n'activez l'option de transmission par référence, une copie de paramètre est transmise à la place de l'objet paramètre réel. Cette opération peut demander du temps car l'ORB doit d'abord faire une copie de chaque objet paramètre.

Cette option peut être utilisée uniquement si le client EJB (Enterprise JavaBeans) et l'EJB sont sur le même chargeur de classe. Cette condition signifie que le client EJB et l'EJB doivent être déployés dans le même fichier EAR.

Si le client et le serveur EJB (Enterprise JavaBeans) sont installés sur la même instance ou si le produit, le client et le serveur utilisent des interfaces distantes, l'activation de l'option de transmission par référence peut améliorer les performances de 50%. L'option de transmission par référence ne permet d'améliorer les performances que si des types d'objet non primitifs sont transmis comme paramètres. Par conséquent, les variables flottantes (float) et les valeurs int sont toujours copiées quel que soit le modèle d'appel.

Eviter les incidents : Activez cette propriété avec précaution car elle peut entraîner un comportement inattendu. si un objet est modifié par l'appelé, l'objet de l'appelant est également modifié car il s'agit du même objet.gotcha

Si vous utilisez un script de ligne de commande, le nom complet de cette propriété système est com.ibm.CORBA.iiop.noLocalCopies.

Type de données Booléen
Valeur par défaut Non activé (false)

L'utilisation de cette option pour les beans enterprise avec les interfaces éloignées n'est pas conforme à la spécification EJB (Enterprise JavaBeans) version 2.0 (voir la section 5.4). Les références d'objets transmises aux méthodes EJB (Enterprise JavaBeans) ou aux méthodes EJB home ne sont pas copiées et peuvent être altérées.

Prenons l'exemple suivant :
Iterator iterator = collection.iterator();
MyPrimaryKey pk = new MyPrimaryKey();
while (iterator.hasNext()) {
   pk.id = (String) iterator.next();
   MyEJB myEJB = myEJBHome.findByPrimaryKey(pk);
}

Dans cet exemple, une référence au même objet MyPrimaryKey est transmise au au produit avec une valeur d'identificateur différente à chaque fois. Lorsque ce code est exécuté avec la transmission par référence activée, un incident se produit sur le serveur d'applications car plusieurs beans enterprise font référence au même objet MyPrimaryKey. Pour résoudre cet incident, attribuez la valeur true à la propriété système com.ibm.websphere.ejbcontainer.allowPrimaryKeyMutation lorsque l'option de transmission par référence est activée. Le conteneur d'EJB effectue alors une copie locale de l'objet PrimaryKey. Cela provoque la perte partielle des performances obtenues en définissant l'option de transmission par référence.

En règle générale, tout code d'application qui transmet une référence d'objet à une méthode de bean enterprise ou une méthode Home EJB sous la forme d'un paramètre doit être examiné afin de déterminer si la transmission de cette référence d'objet provoque une perte d'intégrité des données ou d'autres incidents.

Après avoir examiné le code, vous pouvez activer l'option de transmission par référence en associant la propriété système com.ibm.CORBA.iiop.noLocalCopies à la valeur true. Vous pouvez également activer cette option dans la console d'administration. Cliquez sur Serveurs > Types de serveurs > Serveurs d'applications > nom_serveur > Services de conteneur > Services ORB et sélectionnez Transmission par référence.




Les liens marqués (en ligne) requièrent un accès à Internet.

Tâches associées
Référence associée
[AIX Solaris HP-UX Linux Windows] [iSeries] Paramètres du pool d'unités d'exécution
[AIX Solaris HP-UX Linux Windows] [iSeries]
[AIX Solaris HP-UX Linux Windows] [iSeries]


Nom du fichier : uorb_rsetg.html