Exemple : Activation des fonctions de consignation et de trace pour des applications client ActiveX
La passerelle ActiveX vers EJB offre deux formats de consignation et de trace : Windows Application Event Log et Java™ Trace Log.
- Windows Event Log
Windows Application Event Log affiche les erreurs JNI, les messages d'erreur de la console Java et les messages d'initialisation XJB. Ce journal permet d'identifier les erreurs XJBInit() et les exceptions externes à l'environnement Java. Par défaut, la consignation des erreurs critiques est activée, tandis que le débogage et la consignation des événements sont désactivés.
Pour activer ou désactiver la consignation de certains types d'événement dans Windows Event Log, vous devez spécifier un ou plusieurs paramètres dans XJBInit(). Si vous définissez plusieurs paramètres, ils sont traités suivant l'ordre dans lequel ils apparaissent dans le tableau de chaînes fourni en entrée à la méthode XJBInit(). Une fois que la méthode XJBInit() est initialisée, ces paramètres ne peuvent plus être définis ou redéfinis pendant la durée de vie du processus. L'utilisation de Java java.lang.System.setProperty() pour définir ces valeurs n'a également aucun effet.- -Dcom.ibm.ws.client.xjb.native.logging.debug=enabled|disabled
Active ou désactive la consignation des messages de niveau débogage dans le journal des événements du système d'exploitation Windows. Ce niveau de consignation est très utile et permet d'afficher la plupart des erreurs internes, des erreurs de programmation de l'utilisateur et des problèmes de configuration.
- -Dcom.ibm.ws.client.xjb.native.logging.event=enabled|disabled
Active ou désactive les messages d'événement dans le journal des événements du système d'exploitation Windows.
- -Dcom.ibm.ws.client.xjb.native.logging.*=enabled|disabled
Active ou désactive les messages d'événement et de débogage dans le journal des événements du système d'exploitation Windows. Il est n'est pas possible de désactiver certains messages d'erreur importants dans le journal des erreurs. Seuls les messages de débogage et d'événement peuvent être désactivés.
Pour afficher le journal des événements des applications Windows à l'aide de l'observateur d'événements, procédez comme suit :- Cliquez sur .
- Cliquez deux fois sur Outils d'administration.
- Cliquez deux fois sur Observateur d'événements.
Tous les événements de la passerelle ActiveX vers EJB contiennent le texte WebSphere XJB dans la colonne source et dans le journal de l'application.
Lorsque vous utilisez l'observateur d'événements, pour obtenir de l'aide, cliquez sur l'option de menu
. - -Dcom.ibm.ws.client.xjb.native.logging.debug=enabled|disabled
- Journal de trace Java
Le journal de trace Java affiche des informations permettant de déboguer des appels de méthode, des recherches de classe et des problèmes de transtypage. Comme la portion Java de la passerelle reflète la fonction de l'interface COM IDispatch, les informations figurant dans le journal de trace sont similaires à celles d'une interface IDispatch. Pour comprendre le journal de trace, vous devez comprendre les bases d'IDispatch.
Pour activer la consignation des utilisateurs, ajoutez les paramètres suivants à la table des chaînes d'entrée de XJBInit() :"-DtraceString=com.ibm.ws.client.xjb.*=event=enabled" "-DtraceFile=C:\MyTrace.txt"