Données du message

Toute identification des incidents d'événements de base communs doit fournir un texte lisible décrivant l'événement en question dans la zone du message de l'événement de base commun.

Le texte associé aux événements représentant les véritables messages ou entrées de fichier journal doit être traduit et localisé. Intégrez l'élément msgDataElement dans l'événement de base commun quand un texte internationalisé est fourni dans l'événement. Cet élément fournit des informations relatives au mode de création et d'interprétation du message. Ces informations sont particulièrement importantes lors de la tentative d'interprétation par programmation de l'événement ou de la tentative d'interprétation du message indépendamment de l'environnement local ou de la langue utilisée pour le formatage du texte du message.

Prérequis : compréhension des concepts associés à la création des messages internationalisés. Vous trouverez une initiation à ces concepts dans la documentation associée à l'internationalisation des informations Java™ et à l'utilisation des regroupements de ressources du langage Java.

L'élément msgDataElement de l'événement CBE (Common Base Event) comporte les informations suivantes relatives à la valeur de la zone msg fournie avec un événement :
  • L'environnement local du texte de message fourni, qui identifie le mode de formatage des zones indépendantes de l'environnement local dans le message, ainsi que la langue du message (msgLocale).
  • Un identificateur indépendant de l'environnement local associé au message, pouvant être utilisé pour interpréter le message indépendamment de la langue, de l'environnement local et du format du message (msgId et msgIdType).
  • Des informations relatives à la méthode de création d'un message traduit, y compris :
    • l'identificateur utilisé pour récupérer le modèle du message (msgCatalogId).
    • Le nom et le type du catalogue de messages utilisés pour récupérer le modèle du message (msgCatalog et msgCatalogType).
    • Toute information indépendante de l'environnement local insérée dans le modèle du message afin de créer le message final (msgCatalogTokens).
La spécification de l'événement de base commun [CBE101] fournit des informations sur le format requis de ces zones et le Guide du développeur d'événement de base commun [CBEBASE] offre des instructions d'utilisation générales. Cette section fournit des informations supplémentaires sur le formatage et l'utilisation de ces zones pour les événements d'identification des incidents.
msg
Tous les événements de message, de journal et de trace doivent fournir un message lisible dans la zone du message de l'événement de base commun. La zone du message est requis pour les événements d'identification des incidents, et les événements de journaux et de diagnostic. Cette zone est plus restrictive que la spécification de base pour l'événement de base commun, qui répertorie cette zone comme étant facultative. Une identification efficace des incidents nécessite que la condition rapportée soit identifiée rapidement. Le format et l'utilisation de ce message sont spécifiques au composant, mais utilisez les instructions générales suivantes :
  • Attendez-vous à ce que le texte fourni avec les messages et les événements à enregistrer soit internationalisé.
  • Indiquez l'environnement local du texte de message fourni dans la zone msgLocale de l'élément msgDataElement de l'événement de base commun.
  • Fournissez d'autres informations relatives au format et à la création des messages internationalisés dès que possible, à l'aide de l'élément msgDataElement de l'événement de base commun.
msgLocale
Indiquez l'environnement de message lorsque le texte de message est fourni dans l'événement de base commun, tel que dans les événements d'identification des incidents. La zone msgLocale est répertoriée comme valeur facultative de la spécification Common Base Event, mais indiquez cette information dans les événements de détermination des incidents dès que possible. Cette zone n'est pas requise pour les événements d'identification des incidents car des instances existent là où les informations d'environnement local ne sont pas fournies ou disponibles lors du formatage de l'événement de base commun.
msgId et msgIdType
Diverses sociétés intègrent un identificateur indépendant de l'environnement local dans le texte du message internationalisé que vous pouvez utiliser pour interpréter la condition décrite par le texte du message, indépendamment u message. Par exemple, la plupart des messages émis par le logiciel IBM® ont l'aspect suivant : IEE890I Mémoires tampon WTO dans la mémoire de sauvegarde de la console = 1024, où un identificateur unique indépendant de l'environnement local IEE890I précède le texte du message traduit. Cet identificateur permet d'identifier et de détecter de manière unique un message indépendant de l'emplacement et de la langue. Cette détection est primordiale pour l'analyse par programmation et indépendante de l'environnement local.
La zone msgID est répertoriée comme valeur facultative dans la spécification Common Base Event mais elle doit être fournie dans les événements d'identification des problèmes lorsque cet identificateur est inclus dans le texte du message. De la même façon, la zone msgIdType est répertoriée comme valeur facultative dans la spécification Common Base Event mais elle doit être fournie dans les événements d'identification des problèmes lorsqu'une valeur est fournie pour msgId. Ces zones ne doivent pas être renseignées lorsque le texte du message n'a pas été traduit ou localisé, par exemple pour les événements de traces.
msgCatalogId
La zone msgCatalogId est répertoriée comme valeur facultative dans la spécification Common Base Event, mais fournissez-la lorsque Common Base Event inclut des messages traduits ou localisés. Par exemple, dans le cas d'événements d'identification des problèmes représentant des événements de journal ou des messages émis. Cette zone n'est pas requise pour les événements d'identification des problèmes car tous les événements d'identification des événements n'incluent pas des textes de message traduits et il existe des cas dans lesquels la valeur n'est pas fournie ou disponible lors du formatage de Common Base Event. Cette zone ne doit pas être fournie lorsque le texte du message n'a pas été traduit ou localisé, par exemple pour les événements de traces.
msgCatalogTokens
La zone msgCatalogTokens est répertoriée comme valeur facultative dans la spécification Common Base Event, mais fournissez-la lorsque Common Base Event inclut des messages traduits ou localisés. Par exemple, dans le cas d'événements d'identification des problèmes représentant des événements de journal ou des messages émis. Cette zone n'est pas requise pour les événements d'identification des incidents car tous les événements d'identification des événements n'incluent pas des textes de message traduits et il existe des cas dans lesquels la valeur n'est pas fournie ou disponible lors du formatage de Common Base Event. Cette valeur contient la liste des valeurs indépendantes de l'environnement local ou les jetons de message insérés dans le message localisé lors de la création d'un message traduit.
Ces valeurs sont difficiles à extraire d'un message traduit sans connaître le modèle du message traduit qui a été utilisé pour créer le message. Cette zone ne doit pas être renseignée lorsque le texte du message n'a pas été traduit ou localisé
Common Base Event comporte plusieurs mécanismes permettant de mettre à disposition des données supplémentaires sur un événement, notamment cette zone, des éléments de données étendues et des extensions du schéma. Utilisez toujours la zone msgCatalogTokens pour fournir la liste des jetons de message inclus dans le texte du message associé à un événement. Ces valeurs peuvent également être fournies dans d'autres parties de Common Base Event mais elles doivent être incluses dans cette zone.
msgCatalog et msgCatalogType
Les zones msgCatalog et msgCatalogType sont répertoriées comme des valeurs facultatives dans la spécification Common Base Event mais elles doivent être fournies lorsque Common Base Event inclut des messages traduits ou localisés. Par exemple, dans le cas d'événements de détermination des problèmes représentant des événements de journal ou des messages émis. Ces zones ne sont pas requises pour les événements d'identification des problèmes car tous les événements d'identification des événements n'incluent pas des textes de message traduits et il existe des cas dans lesquels les valeurs ne sont pas fournies ou disponibles lors du formatage de Common Base Event. Ne complétez pas ces zones lorsque le texte du message n'a pas été traduit ou localisé, par exemple pour les événements de traces.

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rtrb_cbemessage
Nom du fichier : rtrb_cbemessage.html