com.ibm.msg.client.services

Trace de classe

java.lang.Object

com.ibm.msg.client.services.Trace

classe publique Trace
étend java.lang.Object

Cette classe permet d'activer et de désactiver la fonction de trace de manière dynamique à partir d'une application. L'activation ou la désactivation de la trace affecte tous les codes IBM MQ Classes for JMS dans la même machine virtuelle Java.

Outre l'utilisation de l'API dans cette classe, le traçage dans les classes IBM MQ pour JMS peut également être surveillé et activé / désactivé à distance via l'utilisation de Java Management Extensions (JMX). Lorsque les classes IBM MQ pour JMS sont exécutées sur une machine, un MBean est enregistré auprès de la plateforme MBeanServer. Il sera ensuite disponible pour les outils de surveillance à distance tels que JConsole. Le MBean sera enregistré et rendu disponible si la machine virtuelle Java est démarrée avec des propriétés système Java telles que les suivantes:

 -Dcom.sun.management.jmxremote
 -Dcom.sun.management.jmxremote.port=
 -Dcom.sun.management.jmxremote.ssl=false
 -Dcom.sun.management.jmxremote.authenticate=false
 

Lorsqu'un outil approprié, tel que JConsole, est utilisé pour afficher les beans gérés enregistrés, un domaine nommé IBM IBM MQ classes for JMS est disponible. Dans ce domaine se trouve un MBean nommé TraceControl qui contient des méthodes qui correspondent à l'API fournie par cette classe. Ces méthodes peuvent être appelées à distance via le MBean pour interroger le comportement de traçage en cours et pour l'activer ou le désactiver alors qu'une application client JMS est en cours d'exécution.

Enfin, si une installation client complète (ou une installation serveur) est présente, il est possible de contrôler le traçage IBM IBM MQ pour JMS à l'aide des commandes strmqtc/endmqtrc . Le fichier com.ibm.mq.commonservices.jar doit être présent dans le chemin d'accès aux classes et le fichier Java library.path doit inclure le répertoire bin IBM MQ . Il ne s'agit pas de pré-demandes obligatoires des classes IBM MQ pour JMS. Il se peut donc qu'elles ne soient pas présentes dans tous les déploiements, par exemple, dans un serveur d'applications. Cette fonction n'est pas disponible sous z/OS d' i5/OS.

Récapitulatif des méthodes

Modificateur et type	Méthode et description
static int	getTraceLevel() Extrait le niveau de détail de la trace en cours.
static void	inject(java.lang.String className, java.lang.String description, java.lang.Object data) Permet à une application d'injecter des points de trace dans le fichier de trace. Cela peut être utile pour fournir des informations ou des indications de points utiles lors de la fourniture de la trace au service IBM .
static boolean	isOn() Méthode permettant de déterminer si la trace est activée ou désactivée.
static void	setOff() Désactive la fonction de trace.
static void	setOn() Active la fonction de trace.
static void	setStatus(boolean traceOn) Définit si la trace est activée ou désactivée.
static void	setTraceFileAppend(boolean append) Détermine si le fichier de trace sera ajouté une fois ouvert.
static void	setTraceFileCount(int count) Définissez le nombre de fichiers de trace à parcourir. Cette API doit être appelée AVANT que la trace soit activée ; une fois la trace activée sur cet appel API, elle est ignorée, même si la trace est ensuite désactivée à nouveau.
static void	setTraceFilename(java.lang.String filename) Définit le nom du fichier de trace.
static void	setTraceLevel(int newTraceLevel) Définit le niveau de détail de la fonction de trace.
static void	setTraceLimit(int count) Définit la limite de la taille de chaque fichier de trace. Cette API doit être appelée AVANT que la trace soit activée ; une fois que la trace a été activée sur cet appel d'API, elle est ignorée, même si la trace est à nouveau désactivée par la suite.

Méthodes héritées de la classe java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Détails de la méthode

isOn

public static boolean isOn()

Méthode permettant de déterminer si la trace est activée ou désactivée.

Retour :

true si la trace est activée.

setStatus

public static void setStatus(boolean traceOn)

Définit si la trace est activée ou désactivée.

Paramètres :

traceOn -indique si la trace est activée ou non.

setOn

public static void setOn()

Active la fonction de trace.

setOff

public static void setOff()

Désactive la fonction de trace.

setTraceLevel

public static void setTraceLevel(int newTraceLevel)

Définit le niveau de détail de la fonction de trace. Cette valeur détermine le niveau minimal pour lequel les appels de trace seront traités.

Paramètres :

newTraceLevel -niveau minimal d'appel de trace à traiter.

getTraceLevel

public static int getTraceLevel()

Extrait le niveau de détail de la trace en cours. Plus la valeur est élevée, plus les informations sont tracées.

Retour :

le niveau de détail de la fonction de trace en cours.

setTraceFileCount

public static void setTraceFileCount(int count)

Définissez le nombre de fichiers de trace à parcourir. Cette API doit être appelée AVANT que la trace soit activée ; une fois la trace activée sur cet appel API, elle est ignorée, même si la trace est ensuite désactivée à nouveau. Cela a le même effet que la définition de com.ibm.msg.client.commonservices.trace.count dans le fichier de configuration-cet appel a priorité sur le fichier de configuration.

Paramètres :

count -Entier positif-nombre de fichiers à parcourir jusqu'à 0-un seul fichier (valeur par défaut)

setTraceFilename

public static void setTraceFilename(java.lang.String filename)

Définit le nom du fichier de trace. Cette API doit être appelée BEFORE trace est activée ; une fois que la trace a été activée sur cet appel API, elle est ignorée même si la trace est à nouveau désactivée par la suite. Cela a le même effet que la définition de com.ibm.msg.client.commonservices.trace.outputName dans le fichier de configuration-cet appel est prioritaire sur le fichier de configuration.

Paramètres :

filename -

setTraceLimit

public static void setTraceLimit(int count)

Définit la limite de la taille de chaque fichier de trace. Cette API doit être appelée AVANT que la trace soit activée ; une fois que la trace a été activée sur cet appel d'API, elle est ignorée, même si la trace est à nouveau désactivée par la suite. Cela a le même effet que la définition de com.ibm.msg.client.commonservices.trace.limit dans le fichier de configuration-cet appel est prioritaire sur le fichier de configuration.

Paramètres :

count - Entier positif - les données seront écrites jusqu'à cette valeur d'octets par fichier de trace 0 - signifie qu'aucune donnée ne sera écrite -1 - signifie illimité (par défaut)

setTraceFileAppend

public static void setTraceFileAppend(boolean append)

Détermine si le fichier de trace sera ajouté une fois ouvert. Par défaut, un nouveau fichier de trace est créé pour chaque processus. Notez que le nom de fichier par défaut inclut l'ID de processus. Par conséquent, même si la valeur est true, un nouveau fichier est créé. Définissez le nom de fichier sur true. Cela a le même effet que la définition de com.ibm.msg.client.commonservices.trace.append dans le fichier de configuration-cet appel a priorité sur le fichier de configuration.

Paramètres :

append -True si les fichiers sont ajoutés.

injecter

public static void inject(java.lang.String className,)
                          Description de java.lang.String ,
                          java.lang.Object )

Permet à une application d'injecter des points de trace dans le fichier de trace. Cela peut être utile pour fournir des informations ou des indications de points utiles lors de la fourniture de la trace au service IBM . Les valeurs sont facultatives.

Paramètres :

className -nom de classe de la classe d'application

description -description en texte libre

data -Objet pouvant être incorporé dans la trace. Appellera toString() pour la valeur à mettre dans la trace.