De part sa nature, WS-ReliableMessaging peut générer des incidents réseau et serveur ; l'emplacement de stockage des messages ou services Web cible peut alors ne pas être disponible. Dans ce cas, les séquences de messages ne peuvent pas
aboutir et les collections de messages des services Web restent en attente de transmission. Vous
pouvez utiliser le fichier SystemOut.log, des événements système et
les panneaux d'administration d'exécution pour surveiller le système, ainsi que
détecter et résoudre les incidents avec WS-ReliableMessaging.
Pourquoi et quand exécuter cette tâche
En cas d'échec d'une séquence, un message est écrit dans le fichier
SystemOut.log du serveur d'applications et un événement système est
généré. Vous pouvez ainsi détecter les séquences ayant échoué en consultant le
fichier
SystemOut.log ou en écrivant un programme d'écoute
d'événements (ou à l'aide d'un logiciel tiers) pour surveiller les événements.
Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL
en vue du traitement des incidents liés aux applications.
Pour
des informations de statut plus détaillées lors de l'exécution, ainsi que des
fonctions permettant de résoudre les incidents, utilisez les
panneaux d'exécution de la console d'administration WS-ReliableMessaging. Ces panneaux sont disponibles pour un grand nombre de portées différentes (par exemple, cellule ; serveur d'applications ; moteur de messagerie). Pour obtenir la liste complète des panneaux
d'exécution WS-ReliableMessaging et des détails sur les portées auxquelles ils sont
disponibles, voir WS-ReliableMessaging - Fenêtres de console d'administration.
A toutes les
portées, le panneau parent est
Paramètres Etat de la messagerie fiable. A partir de ce panneau, vous pouvez examiner chacun des trois aspects d'exécution clés d'une messagerie fiable :
- Magasins de messages
- Séquences entrantes
- Séquences sortantes
Les icônes suivantes s'affichent dans cette fenêtre et dans un certain nombre de fenêtres d'exécution de la messagerie fiable :
Icône |
Chaîne |
Description |
 |
OK |
Tous les éléments de cette fenêtre et, s'il existe un lien, de toutes les fenêtres d'exécution sous ce lien, s'exécutent normalement. |
 |
Avertissement |
Un ou plusieurs éléments de cette fenêtre ou, s'il existe
un lien, de l'une des fenêtres d'exécution sous ce lien, ne s'exécutent pas
normalement et une intervention peut être nécessaire. Par exemple, il se peut que le système attende une réponse d'un noeud final. Dans ce cas, soit la réponse est reçue (aucune action n'est nécessaire et les
informations d'exécution passent à l'état "OK"), soit la destination de la
messagerie fiable a stoppé les messages d'accusé de réception (une action est
nécessaire pour résoudre la séquence défaillante).
|
 |
Erreur |
Une erreur s'est produite et une action est nécessaire
pour la résoudre, dans cette fenêtre ou, s'il existe un lien, dans l'une des
fenêtres d'exécution sous ce lien. |
Pour l'identification des incidents, il suffit de suivre les liens vers
les sous-fenêtres si des états autres que
"OK" sont affichés.
Pour
utiliser les panneaux d'exécution de la messagerie fiable en vue de détecter et de
résoudre des incidents avec WS-ReliableMessaging, effectuez une ou plusieurs
des étapes suivantes :
- Analysez les incidents avec les emplacements de stockage des messages.
Dans le panneau de navigation, cliquez sur l'un des chemins d'accès à ce panneau. Par exemple : .
La liste des gestionnaires de stockage de messagerie fiable pour la portée en
cours est présentée dans le formulaire
Collections de magasins de messages.
Pour les qualités de service gérées, les messages sont écrits dans un moteur de messagerie. Pour
la qualité de service non permanente non gérée, les messages sont stockés en mémoire. Pour le stockage en mémoire, la seule valeur possible est "Running". Pour
les messages stockés dans un moteur de messagerie, les valeurs possibles sont "Running" ou "Messaging engine not
contactable". Cela peut être dû au fait que le moteur de messagerie n'est pas en cours d'exécution. L'icône "OK" indique que l'emplacement de stockage des messages est en
cours d'exécution. Si le moteur de messagerie ne peut pas être contacté, l'icône "Error" est affichée.
Pour chaque emplacement de stockage des messages dans la liste, le nom de
l'application de messagerie fiable associée apparaît dans la colonne description.
Si
un moteur de messagerie ne peut être contacté, redémarrez l'emplacement de stockage
des messages pour cette application.
- Analysez les incidents avec des séquences entrantes.
Dans le panneau de navigation, cliquez sur l'un des chemins d'accès à ce panneau. Par exemple : . L'état d'exécution de chacune des séquences entrantes pour la portée en cours s'affiche dans le formulaire Collection de séquences entrantes.
Vous pouvez utiliser un filtre afin d'observer des séquences avec un état
déterminé (par exemple, celui d'échec en raison d'un message manquant) ou
comptant un grand nombre de messages en attente de
répartition à des applications. Si le statut de la séquence est Erreur, un
incident s'est produit et le serveur source hébergeant l'autre extrémité de la
séquence y a mis fin. Si la séquence est active et qu'il existe un grand nombre de
messages en attente de répartition à l'application, un incident peut se produire
avec l'application ou, si une distribution ordonnée est demandée, elle peut être
bloquée car la séquence y inclut des écarts.
Vous pouvez sélectionner une ou plusieurs séquences, puis utiliser les boutons
fournis pour distribuer les messages aux applications associées, exporter les messages dans des fichiers compressés, fermer ou terminer les séquences
sélectionnées, ou encore supprimer les séquences sélectionnées et tous les messages qu'elles comportent.
Avertissement : Supprimez ou arrêtez les séquences uniquement si cela est nécessaire. Si vous supprimez ou mettez fin à une séquence active, le comportant de messagerie résultant est imprévisible et peut entraîner la perte des messages. Si vous ne savez pas si vous pouvez supprimer ou mettre fin à une séquence en toute sécurité, n'exécutez pas l'opération ; le système supprime automatiquement les séquences inactives pendant 12 heures.
Pour voir plus d'informations à propos d'une séquence particulière, cliquez dans la zone
Identificateur de séquence.
Le formulaire
Paramètres Séquences entrantes s'affiche.
Ces informations détaillées incluent des données d'adressage pour permettre d'identifier la source de la séquence et la valeur (
true ou
false) pour la
distribution ordonnée de la séquence. A partir de ce panneau, vous pouvez également afficher les formulaires suivants :
- Le formulaire Collection Etat de l'accusé de réception. (Plages de numéros de séquence des messages reçus de la source WS-ReliableMessaging. Si plusieurs plages sont affichées, c'est qu'il existe une interruption dans la séquence des messages reçus. Si
l'option de livraison dans l'ordre est sélectionnée dans le gestionnaire de séquence, les messages dont le numéro de
séquence est supérieur au numéro le plus faible de l'intervalle d'écart ne peuvent être livrés à l'application tant que l'écart n'a pas été comblé.)
- Le formulaire Collection de messages entrants.
(Messages de la séquence entrante
Vous pouvez l'utiliser pour supprimer des messages individuels.)
Pour en savoir plus sur le diagnostic des incidents avec des séquences
entrantes, voir Diagnosing the problem when a reliable messaging source cannot deliver its messages
- Analysez les incidents avec des séquences sortantes.
Dans le panneau de navigation, cliquez sur l'un des chemins d'accès à ce panneau. Par exemple : . L'état d'exécution de chacune des séquences sortantes pour la portée en cours s'affiche dans le formulaire Collection de séquences sortantes.
Vous pouvez utiliser un filtre afin d'observer des séquences avec un statut
déterminé. Par exemple, l'état signalant qu'il est impossible de
contacter le noeud final éloigné indique que la séquence a été établie mais que
la destination de la messagerie fiable a arrêté des messages d'accusé de
réception (ce qui, en plus du nombre élevé de messages en attente de transmission,
peut signaler un incident potentiel). Si le statut de la séquence est Erreur,
un incident s'est produit et le serveur hébergeant l'autre extrémité de la séquence
y a mis fin.
Vous pouvez sélectionner une ou plusieurs séquences, puis utiliser les boutons fournis pour exporter les messages vers des fichiers compressés, fermer ou terminer les séquences sélectionnées ou encore supprimer les séquences sélectionnées et tous leurs messages. Pour plus d'informations sur la suppression des séquences, voir Deleting a failed WS-ReliableMessaging outbound sequence.
Avertissement : Supprimez ou arrêtez les séquences uniquement si cela est nécessaire. Si vous supprimez ou mettez fin à une séquence active, le comportant de messagerie résultant est imprévisible et peut entraîner la perte des messages. Si vous ne savez pas si vous pouvez supprimer ou mettre fin à une séquence en toute sécurité, n'exécutez pas l'opération ; le système supprime automatiquement les séquences inactives pendant 12 heures.
Pour voir plus d'informations à propos d'une séquence particulière, cliquez dans la zone
Identificateur de séquence.
Le formulaire
Paramètres Séquences sortantes s'affiche. Ces informations détaillées incluent des données d'adressage pour permettre
d'identifier le serveur auquel la séquence est destinée.
A partir de ce panneau, vous pouvez également afficher les formulaires suivants :
Pour en savoir plus sur le diagnostic des incidents avec des séquences
sortantes, voir Diagnosing and recovering a WS-ReliableMessaging outbound sequence that is in retransmitting state.