Utilisation de la console d'administration HATS

L'interface d'administration de HATS permet de gérer les connexions et d'identifier les incident éventuels pour les applications Web HATS. Le présent chapitre décrit l'utilisation de ces fonctions de gestion. Pour des informations concernant les applications client enrichi HATS, voir Administration des applications client enrichi HATS.

Vous pouvez inclure les fichiers de prise en charge de la console d'administration HATS avec un ensemble d'applications HATS contenu dans un fichier .ear (Enterprise Archive) déployé sur WebSphere Application Server. Ce fichier .ear fournit un environnement d'exécution dans lequel la console d'administration vous permet de gérer des applications HATS. Si vous incluez les fichiers de la console d'administration dans plusieurs projets, vous pouvez lancer plusieurs consoles d'administration avec différents noms d'application. Toutefois, toutes ces consoles fournissent les mêmes vues et les mêmes fonctions.

Remarque :
Cette option n'est pas prise en charge par les projets de portlet standard HATS.

Au lieu d'inclure les fichiers de prise en charge de la console d'administration HATS dans chaque fichier .ear, vous pouvez créer un fichier .ear contenant uniquement les fichiers de la console. Lorsque vous déployez le fichier .ear, vous pouvez démarrer la console d'administration HATS et modifier la portée de la gestion pour gérer à distance des applications HATS dans plusieurs fichiers .ear (ainsi que les portlets HATS IBM® et les portlets standard) avec une seule instance de la console d'administration. L'application de la console d'administration HATS déployée constitue un point d'administration unique pour toutes les applications HATS. Lorsque vous créez un nouveau projet HATS, vous devez indiquer s'il doit inclure les fichiers de la console d'administration. Si vous créez un projet de la console d'administration HATS, vous n'avez pas besoin d'inclure les fichiers des fonctions d'administration dans les projets que vous créez.

Pour créer un projet de la console d'administration HATS dans HATS Toolkit, sélectionnez Fichier > Nouveau > Projet > HATS > Projet HATS Administration. Indiquez un nom identifiant de façon unique le projet d'application d'entreprise en tant que projet de laconsole d'administration HATS. Le projet de la console d'administration HATS apparaît uniquement dans HATS Toolkit dans l'onglet Navigateur. Déployez le fichier .ear que vous avez créé dans WebSphere Application Server et démarrez-le (voir Lancement de la console d'administration HATS). Pour modifier la portée de la gestion du projet de la console d'administration, voir Sélection de la portée de la gestion.

Pour des informations relatives à d'autres rubriques d'administration, voir Fonctions d'affichage du terminal.

Console d'administration HATS et sécurité WebSphere

La console d'administration HATS utilise un bean JMX (Java™ Management Extensions) pour effectuer des tâches d'administration à distance. Lorsque la sécurité globale de WebSphere Application Server est activée, ces appels JMX sont authentifiés par le biais des fonctions de sécurité WebSphere et ils doivent disposer d'un niveau d'autorisation valide dans WebSphere. Par conséquent, l'administration à distance par la console d'administration HATS ne peut fonctionner correctement que si l'ID utilisateur est défini en tant qu'utilisateur de la console d'administration WebSphere Application Server disposant de droits d'accès Administrateur ou Opérateur.

La console d'administration HATS permet d'afficher et de modifier les paramètres d'identification des incidents. Elle permet aussi d'afficher le statut des connexions ou de déconnecter les connexions hôte. Lorsqu'une application HATS est déployée à l'aide des fonctionnalités d'administration HATS, vous pouvez mapper chacun des trois rôles HATS sur les ID utilisateur d'un système spécifique. Chacun des trois rôles définis (HATSAdministrator, HATSOperator et HATSMonitor) possède des fonctionnalités différentes dans la console d'administration HATS. Pour plus d'informations, voir Rôles de la console d'administration HATS.

La console d'administration de WebSphere Application Server permet également d'afficher et de modifier la configuration de l'environnement WebSphere Application Server. Il vous permet d'installer, de démarrer, d'arrêter et de désinstaller les applications Web telles que les applications HATS. Les rôles utilisateur de la console WebSphere (Administrateur, Configurateur, Opérateur ou Moniteur) offrent différentes fonctionnalités dans la console d'administration WebSphere Application Server. Les liens suivants du centre de documentation WebSphere Application Server fournissent des détails supplémentaires sur ces rôles et ces règles de sécurité :

Si la sécurité globale de WebSphere est activée, les ID utilisateur qui disposent d'un rôle HATS peuvent se connecter à la console d'administration HATS dans une application HATS et exécuter les tâches d'administration uniquement dans le cadre de cette application. Si l'utilisateur tente de modifier la portée de gestion pour gérer à distance une autre application HATS, la sécurité de WebSphere vérifie les droits d'accès de l'ID utilisateur. Si ce dernier ne dispose pas de droits Administrateur ou Opérateur valides dans la console d'administration WebSphere Application Server, les appels JMX seront bloqués et l'administration à distance HATS ne fonctionnera pas correctement.

Par exemple, si l'ID utilisateur n'est pas défini en tant qu'utilisateur de la console d'administration WebSphere Application Server et ne dispose pas du simple droit d'accès Moniteur, la liste de sélection d'application sous l'option Portée de la gestion de la console d'administration HATS ne contient aucune autre application HATS. En l'absence d'applications sur la liste, la modification de la portée de la gestion est impossible.

Pour citer un autre exemple, si l'ID utilisateur est défini en tant qu'utilisateur de la console d'administration WebSphere Application Server dispose d'un droit d'accès Configurateur, la liste contient d'autres applications HATS et l'utilisateur peut modifier la portée d'une application à une autre. Cependant, les informations affichées dans la console d'administration HATS peuvent être incorrectes et les modifications apportées par le biais de la gestion à distance ne seront donc pas appliquées.

Ainsi, si la sécurité globale de WebSphere est activée, deux options d'utilisation de la console d'administration HATS sont disponibles.

Option 1 : séparer les rôles utilisateurs HATS et WebSphere Application Server
Si vous ne souhaitez pas affecter des droits d'administration WebSphere Application Server à des ID utilisateurs mappés vers des rôles HATS, vous devez inclure la console d'administration HATS dans chaque application HATS et gérer chacune d'elle à l'aide de sa propre console. Vous ne pouvez pas utiliser l'administration à distance.
Option 2 : combiner les rôles utilisateurs HATS et WebSphere Application Server
Si vous souhaitez utiliser la console d'administration HATS dans une seule application HATS pour gérer à distance d'autres applications HATS en modifiant la portée de gestion, les ID utilisateur mappés vers des rôles HATS doivent également être définis dans WebSphere Application Server en tant qu'utilisateurs de la console d'administration WebSphere disposant d'un rôle Administrateur ou Opérateur. Ces utilisateurs ont la possibilité de modifier la portée de gestion dans la console d'administration HATS et d'effectuer d'autres tâches d'administration qu'ils sont autorisés à accomplir en fonction du rôle HATS qui leur a été affecté. Ils peuvent également se connecter à la console d'administration WebSphere Application Server et exécuter les tâches d'administration WebSphere qu'ils sont autorisés à accomplir en fonction du rôle utilisateur qui leur a été affecté dans cette console.

Dans les deux cas, si la sécurité globale de WebSphere est activée, vérifiez que l'option Activer la sécurité des applications est sélectionnée. Pour WebSphere Application Server V6.x, à partir de la Console d’administration WebSphere , sélectionnez Sécurité > Sécuriser l'administration, les applications et l'infrastructure > Sécurité des applications > Activer la sécurité des applications. Pour WebSphere Application Server V7.x, à partir de la Console d’administration WebSphere , sélectionnez Sécurité > Sécurité globale > Sécurité des applications > Activer la sécurité des applications.

En résumé, si la sécurité globale de WebSphere est activée, les ID utilisateur mappés vers des rôles HATS quelconques doivent également être mappés vers les rôles Administrateur ou Opérateur de WebSphere Application Server pour que l'administration à distance HATS puisse fonctionner correctement.

Rôles de la console d'administration HATS

La console d'administration HATS est liée à la sécurité WebSphere. Ainsi, lorsque la sécurité WebSphere Application Server est activée, vos administrateurs système doivent disposer de l'authentification requise pour exécuter les tâches d'administration HATS. Les fonctions de sécurité utilisées par HATS s'appuient sur le processus d'authentification Java EE à base de panneaux. Lorsque la sécuritéWebSphere Application Server est activée, les opérations pouvant être exécutées dans la console d'administration HATS dépendent du rôle défini pour un ID utilisateur. Trois rôles sont définis pour la console d'administration HATS. Chaque rôle possède des fonctionnalités différentes.

HATSAdministrator
Ce rôle possède tous les droits d'administration. Il peut effectuer les opérations suivantes : Par défaut, le rôle HATSAdministrator est affecté à «tous les utilisateurs authentifiés».
HATSOperator
Ce rôle est équivalent au rôle HATSAdministrator à ceci près qu'il n'a pas accès aux données potentiellement sensibles. Un utilisateur possédant ce rôle ne peut pas effectuer de trace sur l'écran du terminal ni télécharger les fichiers de trace.
HATSMonitor
Ce rôle permet uniquement de consulter les données non sensibles telles que les connexions actives, les pools de connexions, les listes d'utilisateurs et les journaux. Un utilisateur possédant ce rôle ne peut pas modifier les paramètres tels que les options de gestion des licences, les options de journalisation et de trace ou les paramètres du terminal d'affichage. Il ne peut pas non plus télécharger les fichiers de trace.

Le mappage des rôles vers les utilisateurs ou les groupes d'utilisateurs s'effectue par le biais de la console d'administration WebSphere.

Pour WebSphere Application Server V6.x, vérifiez que l'option Tous authentifiés sur le panneau Mapper les rôles de sécurité aux utilisateurs/groupes est cochée pour le rôle HATS approprié. Pour WebSphere Application Server V7.x, vérifiez que l'option Tous authentifiés dans le domaine de l'application est sélectionnée pour le rôle HATS approprié, à l'aide de la liste déroulante Mapper les sujets spéciaux du panneau Mapper les rôles de sécurité aux utilisateurs/groupes.

Lancement de la console d'administration HATS

La console d'administration HATS est fondée sur le Web. Les tâches d'administration s'effectuent par le biais d'un navigateur Web, via une interface utilisateur fournie par le servlet de la console d'administration HATS, HATSAdminServlet.

Pour lancer la console d'administration HATS, accédez à l'URL suivante depuis votre navigateur : http://hôte:port/nom_app/hatsadmin/admin, où hôte correspond au nom d'hôte, port au numéro de port de transport HTTP du serveur d'applications sur lequel s'exécute l'application HATS et nom_app au nom d'une application HATS qui inclut des fonctions de prise en charge de l'administration.

Remarque :
Il n'est pas nécessaire de spécifier le port si les demandes d'adresse URL sont dirigées vers un serveur Web configuré pour prendre en charge WebSphere.

Lorsque vous lancez la console d'administration HATS, la langue par défaut du serveur est utilisée. Pour modifier cette langue, sélectionnez Préférences dans le cadre de navigation, choisissez la langue voulue puis redémarrez le navigateur. Cette nouvelle langue est utilisée dans le navigateur tant que vous n'en activez pas une autre via l'option Préférences.

Remarques :
  1. Si les cookies sont désactivés lorsque le navigateur accède à la console d'administration HATS :
  2. Pour obtenir une liste des navigateurs Web pris en charge et des limitations correspondantes, voir la section Prérequis pour HATS dans le centre de documentation de HATS à l'adresse : http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.

Lancement de la console d'administration depuis HATS Toolkit

La console d'administration HATS peut être lancée dans HATS Toolkit à l'aide du mode Déboguer sur le serveur ou Exécuter sur le serveur.

Pour lancer la console d'administration HATS pour un projet spécifique, cliquez avec le bouton droit de la souris sur l'affichage Projets HATS, puis cliquez sur Ouvrir la console d'administration.

Si le projet n'est pas en cours d'exécution dans un environnement de test local, il est lancé à l'aide du mode Déboguer sur le serveur. Une page du navigateur Web s'ouvre alors à l'adresse URL de la console d'administration.

Si le projet est en cours d'exécution en mode Exécuter sur le serveur, un invite s'affiche et vous informe que le serveur n'est pas lancé en mode Déboguer. Si vous sélectionnez l'option Continuer avec le mode en cours, la console d'administration s'ouvre en mode Exécuter sur le serveur.

Pour plus d'informations sur les différents modes de test, voir Modes de test des projets Web dans le Guide d'initiation HATS.

Les paramètres d'exécution à modifier lors du lancement de la console d'administration depuis HATS Toolkit varient selon le mode utilisé. Pour plus d'informations, voir Gestion des éléments d'identification des incidents.

Utilisation des fonctions de la console d'administration HATS

Cette section décrit les différentes fonctions de la console d'administration HATS.

Sélection de la portée de la gestion

Vous pouvez sélectionner la portée de la gestion. La console d'administration tient à jour la liste des portées utilisées pendant le cycle de vie de HttpSession. La portée initiale est par défaut le fichier .ear correspondant à l'application HATS utilisée pour accéder à la console d'administration console d'administration. Vous pouvez modifier la portée afin de gérer d'autres applications HATS déployées dans la même cellule WebSphere.

Pour changer la portée de la gestion, vous devez fournir à la console d'administration les informations relatives au système hôte et au port afin qu'il puisse localiser les applications HATS installées. Le port indiqué doit être un port WebSphere BOOTSTRAP_ADDRESS actif. Les serveurs d'applications, les noeuds et les cellules WebSphere possèdent chacun un port BOOTSTRAP_ADDRESS. En indiquant le port associé à l'une de ces ressources WebSphere, vous autorisez l'administration des applications d'entreprise HATS déployées sur cette ressource. En indiquant l'hôte et le port d'un noeud WebSphere, vous autorisez l'administration de toutes les applications d'entreprise HATS installées sur ce noeud. Pour plus d'informations sur le port BOOTSTRAP_ADDRESS, voir la documentation WebSphere Application Server.

Dans un environnement sécurisé, l'administrateur risque de rencontrer le message suivant dans la console d'administration s'il tente de modifier la portée de l'administration :

Un incident s'est produit au cours de la tentative de gestion de la portée sélectionnée. Les applications HATS sont introuvables. Votre portée de gestion n'a pas été modifiée.

Cela peut se produire, car dans un environnement sécurisé WebSphere, l'utilisateur n'est pas autorisé à établir les communications nécessaires à la création de la liste des applications disponibles à des fins d'administration.

Si WebSphere utilise le système d'exploitation local en tant que registre d'utilisateurs, le nom d'utilisateur employé pour accéder à la console d'administration HATS doit disposer des droits Administrateur dans le registre du système d'exploitation local. Si WebSphere utilise LDAP en tant que registre d'utilisateurs, le nom d'utilisateur employé pour accéder à la console d'administration HATS doit être l'ID serveur utilisé par WebSphere pour accéder à LDAP.

Gestion des licences

Le cadre de navigation gauche comprend deux panneaux pour la gestion des informations relatives aux licences, sous l'en-tête Gestion des licences :

Contrôle des connexions

Sous l'en-tête Gestion des connexions, vous disposez de plusieurs panneaux qui vous permettent de contrôler les différents types de connexions :

Chaque connexion indiquée dans ces panneaux représente un lien de communication avec une source de données dorsale telle qu'une application 3270 ou une base de données. Vous pouvez afficher des détails sur les utilisateurs connectés aux différentes sources de données et sur les identificateurs de connexion utilisés. S'il existe un nom d'unité logique ou de pool pour une connexion 3270, il est également affiché. Vous pouvez également fermer des sessions.

Contrôle des pools de connexions

Dans le cadre de navigation gauche, sous l'en-tête Gestion des connexions, le panneau Pools de connexions affiche des informations sur les pools qui ont été définis. Un pool n'apparaît dans la liste que si au moins une connexion est affectée.

Les pools de connexions sont des ensembles de liens de communication avec des sources de données dorsales telles que des applications 3270 ou des bases de données. Lorsqu'un objet d'intégration ou une application est lancé suite à une demande d'un client, il obtient une connexion disponible à partir d'un pool, l'utilise pour l'accès à la source de données puis rend la connexion au pool. Une fois activé, le pool de connexions permet de résorber la surcharge de la connexion lors de sa première utilisation. Chaque réutilisation d'une connexion tire parti du premier établissement de liaison et peut s'exécuter plus rapidement.

Contrôle des définitions de pool

Dans le cadre de navigation gauche, sous l'en-tête Gestion des connexions, le panneau Définition des pools de connexions affiche des informations sur les définitions de pool pour les connexions aux bases de données et aux systèmes hôte. Une définition de pool n'apparaît dans la liste que si au moins une connexion est affectée à partir de ce pool.

Une définition de pool fournit des informations sur un ensemble de connexions à différentes sources de données. Certaines définitions connexes sont associées à une définition de pool, par exemple les définitions de connexion et de macro et les listes d'utilisateurs. Une définition de pool ne se contente pas de créer des associations entre plusieurs autres définitions. Elle indique aussi les paramètres de configuration pour toutes les connexions du pool, notamment la taille minimale et la taille maximale du pool (en termes de connexions actives) et les délais associés aux connexions.

Contrôle des listes d'utilisateurs et de leurs membres

Dans le cadre de navigation gauche, sous l'en-tête Gestion des utilisateurs, le panneau Listes d'utilisateurs affiche des informations sur les listes d'utilisateurs.

Une liste d'utilisateurs définit les ID et d'autres paramètres relatifs aux connexions pour une définition de pool de connexions spécifique. Pour les systèmes n'admettant qu'une seule connexion par ID utilisateur, le nombre d'ID fixe le nombre de connexions qui peuvent être actives dans un pool.

Gestion des éléments d'identification des incidents

La console d'administration HATS permet de surveiller les activités de journalisation et de trace en vue de faciliter l'identification et la résolution des incidents. Vous pouvez consulter les messages consignés dans le journal, ou bien modifier les paramètres de journalisation et de trace en sélectionnant les liens situés sous l'en-tête Identification des incidents dans le cadre de navigation gauche. Les paramètres relatifs à la gestion de l'identification des incidents se trouvent dans les fichiers de propriétés.

Lorsque vous modifiez les paramètres en accédant à la console d'administration HATS lancée dans un environnement d'exécution, les modifications sont sauvegardées dans le fichier runtime.properties. Bien que ce ne soit pas recommandé, vous pouvez éditer le fichier directement pour modifier les paramètres. Ce fichier se trouve dans le répertoire rép_was/installedApps/nom_ear pour une application d'entreprise HATS.

Lorsque vous modifiez les paramètres lors de l'accès à la console d'administration HATS qui s'exécute dans un environnement de test local depuis HATS Toolkit, les modifications sont sauvegardées dans un des deux fichiers. Les modifications sont sauvegardées dans le fichier runtime.properties en mode Exécuter sur le serveur et dans le fichier runtime-debug.properties en mode Déboguer sur le serveur. Pour plus d'informations, voir Lancement de la console d'administration depuis HATS Toolkit. Vous pouvez aussi éditer les fichiers directement pour effectuer les modifications. Les fichiers se trouvent dans la racine du projet .ear dans HATS Toolkit. Sachez que les modifications apportées au fichier runtime.properties dans HATS Toolkit sont conservées et appliquées lors du déploiement de l'application dans un environnement d'exécution. Le fichier runtime-debug.properties est ignoré dans l'environnement d'exécution.

Remarque :
Lors de l'exécution dans WebSphere Application Server for z/OS, le fichier runtime.properties doit être édité à l'aide d'un éditeur ASCII. Pour cela, transférer le fichier sur un poste de travail, via FTP par exemple, modifiez-le et transférez-le à nouveau à son emplacement d'origine. Notez qu'il existe une copie de runtime.properties pour chaque module Servant actif dans un serveur d'applications (elles sont distinguées l'une de l'autre au moyen de l'ID espace adresse du module Servant). Il est nécessaire de modifier le fichier runtime.properties de base pour conserver les modifications après le redémarrage du serveur d'applications.

Pour plus d'informations sur les paramètres de journalisation et de trace contenus dans ces fichiers, voir Annexe A. Fichiers des propriétés d'exécution.

Noms des fichiers journaux et des fichiers de trace

Les noms de base des fichiers journaux et des fichiers de trace qui figurent dans le fichier runtime.properties sont utilisés comme modèles pour la génération d'un ensemble unique de fichiers journaux et de fichiers de trace pour chaque serveur d'applications. Le nom de base du fichier de trace est trace.txt, tandis que le nom de base du fichier journal est messages.txt. Pour générer les noms des fichiers journaux et des fichiers de trace d'un serveur d'applications spécifique, le nom du serveur est ajouté au nom de base. Le nom du serveur est indiqué dans sa forme complète telle que définie dans WebSphere. Il possède la structure cellule_noeud_serveur, où :

Le nom du serveur d'applications qui exécute HATS est la concaténation d'un trait de soulignement (_), suivi du nom du serveur d'applications, suivi d'un autre trait de soulignement (_).

Si l'on prend l'exemple du fichier de trace, le nom devient trace_cellule_noeud_serveur_.txt. Enfin, pour la distinction entre les différents fichiers associés à un même serveur, un numéro d'ordre (1, 2, 3, etc.) est ajouté à la fin du nom. S'il existe plusieurs fichiers de trace, ils sont appelés trace_cellule_noeud_serveur_1.txt, trace_cellule_noeud_serveur_2.txt, et ainsi de suite.

Remarque :
Lors de l'exécution dans WebSphere Application Server for z/OS, un serveur d'applications peut avoir plusieurs entités Servant, chacune d'elles générant son propre ensemble de fichiers journaux et de fichiers de trace. Pour les distinguer, le composant serveur du nom contient l'ID espace adresse (ASID) du module Servant (exemple : trace_asid_1.txt).

Visualisation du fichier journal

A partir du panneau Visualisation du fichier journal, vous pouvez consulter le fichier journal de HATS, télécharger ce fichier ou effacer son contenu. Le fichier journal enregistre des informations sur deux types d'événements :

erreurs
Incidents empêchant l'exécution d'une opération. Pour remédier à un incident, il est en général nécessaire d'effectuer une action.
Avertissements
Situations inattendues qui peuvent nécessiter une action. Ces situations ne sont pas considérées comme des erreurs.

Vous pouvez utiliser le fichier journal comme référence pour l'identification et la résolution des incidents. La plupart des messages susceptibles d'apparaître dans le journal sont décrits dans le manuel HATS Messages. Le cas échéant, ce manuel vous indique quelques actions possibles pour remédier à l'incident.

Remarque :
Sous Windows®, vous ne pouvez ni renommer ni supprimer la sortie standard et les journaux d'erreurs standard lorsque des applications HATS sont en cours d'exécution. Si vous souhaitez renommer ou supprimer les journaux dans le cadre de la résolution des incidents, d'une libération d'espace sur le disque ou d'une réduction de la taille d'un groupe de fichiers d'informations, vous devez arrêter le serveur d'applications correspondant à HATS. Le noeud WebSphere peut cependant rester actif.

Définition des options de journalisation

A partir du panneau Paramètres de journal, vous pouvez indiquer si les événements d'information et les avertissements doivent être consignés dans le journal, et préciser le fichier dans lequel s'effectue la journalisation. Pour plus d'informations sur les noms des fichiers journaux, voir Noms des fichiers journaux et des fichiers de trace. Si le fichier existe déjà, les nouveaux événements y sont inscrits. Les erreurs sont toujours consignées dans le journal. Vous pouvez également préciser le nombre de fichiers journaux à conserver et la longueur maximale de chacun.

Définition des options de trace

A partir du panneau Paramètres de la trace, vous pouvez sélectionner une ou plusieurs des options de trace suivantes :

Activer la fonction de trace de l'exécution
Active la trace des connexions du projet pendant l'exécution de HATS. Il est possible de définir un niveau différent à l'aide des paramètres de trace (voir Annexe A. Fichiers des propriétés d'exécution).
Activer la fonction de trace de l'objet fenêtre
Active la trace des objets fenêtre du projet pendant l'exécution de HATS. Il est possible de définir un niveau différent à l'aide des paramètres de trace (voir Annexe A. Fichiers des propriétés d'exécution).
Activer la fonction de trace de l'action
Active la trace des actions d'événement du projet pendant l'exécution de HATS. Il est possible de définir un niveau différent à l'aide des paramètres de trace (voir Annexe A. Fichiers des propriétés d'exécution).
Activer la fonction de trace du composant
Active la trace des composants du projet pendant l'exécution de HATS. Il est possible de définir un niveau différent à l'aide des paramètres de trace (voir Annexe A. Fichiers des propriétés d'exécution).
Activer la fonction de trace de l'utilitaire
Active la trace des utilitaires d'exécution du projet pendant l'exécution de HATS. Il est possible de définir un niveau différent à l'aide des paramètres de trace (voir Annexe A. Fichiers des propriétés d'exécution).
Fonction de trace des objets d'intégration
Active la trace pour des objets d'intégration spécifiques de votre projet. Utilisez la zone Nom de classe pour indiquer les objets d'intégration à prendre en compte, à l'aide d'un ou de plusieurs masques. Chaque masque peut contenir un ou plusieurs caractères alphanumériques (*). Par exemple, IntegrationObject.Callup* indique que la trace est activée pour tous les objets d'intégration dont le nom commence par Callup. Pour que la trace porte sur tous les objets d'intégration, indiquez IntegrationObject.*. Lorsque vous indiquez plusieurs masques, séparez-les par des virgules. La console d'administration HATS affecte le niveau de trace maximal à chaque objet d'intégration. Il est possible de définir un niveau différent à l'aide des paramètres de trace (voir Annexe A. Fichiers des propriétés d'exécution).
Fonction de trace de l'applet
Active la fonction de trace de l'applet. Un niveau de trace plus élevé génère davantage d'informations de trace. Lorsque la fonction de trace de l'applet est activée, les messages côté serveur apparaissent en sortie en vue de l'identification des incidents. Pour plus d'informations sur les paramètres de la fonction de trace de l'applet, voir Annexe A. Fichiers des propriétés d'exécution.
Fonction de trace macro utilisateur
Effectue une trace lors de l'exécution des macros. N'activez cette option que pour le débogage des macros, car elle affecte les performances du système.
Afficher le terminal
Permet d'afficher l'écran du terminal hôte pour n'importe quelle connexion lors de son exécution en temps réel sur le serveur. Lorsque vous activez l'affichage du terminal, les paramètres du terminal ne sont présentés que pour les connexions nouvellement créées. Pour plus d'informations sur le terminal d'affichage, voir Utilisation de l'affichage du terminal pour des opérations de test et de débogage.
Remarque :
Vous pouvez choisir si HATS doit afficher ou non une boîte de dialogue vous demandant si vous souhaitez désactiver le terminal d'affichage lors d'une exécution sur le serveur. Pour plus d'informations, voir Préférences HATS.
Enregistrer la trace de simulation hôte
Cochez la case Activer l'enregistrement de la simulation hôte pour activer l'enregistrement de la simulation hôte lors de l'exécution. L'enregistrement débute à l'ouverture de la session hôte suivante et finit à la fermeture de celle-ci, par exemple, lorsque l'utilisateur clique sur le bouton de déconnexion sur le bloc de touche de l'application. Si l'utilisateur ferme le navigateur alors que le traçage est actif, la trace se terminera à l'expiration du délai de la session HTTP. Le fichier de trace est sauvegardé dans un dossier de simulations hôte sur le serveur, par exemple, <racine install WebSphere>\AppServer\profiles\AppSrv01\installedApps\<ID noeud>\<nom de fichier ear>\<nom_application>.war\WEB-INF\profiles\hostsimulations. Les noms des fichiers de trace suivent le modèle suivant : NomApplication_NomConnexion_Date(aaaammjj)_Heure(hhmmss)_Numéro, par exemple, MonApplication_principal_20060101_134543_1.

Afin de tracer plusieurs sessions hôte à la fois, la simulation hôte utilise différents ports TCP/IP. Utilisez les zones Plage de ports TCP/IP pour l'enregistrement pour définir la plage de numéros de ports pour l'utilisation de l'environnement d'exécution du serveur. Le port de départ de la plage est 7021 et le port de fin est 7050.

Options de trace du service d'assistance IBM
La console d'administration HATS contient également la case à cocher Afficher les options de trace du service d'assistance qui permet d'activer les traces (sur instruction du service d'assistance IBM). Il est recommandé de n'utiliser ces traces qu'à la demande du service d'assistance IBM.
Sortie de trace
Permet d'indiquer si les informations de trace doivent être enregistrées dans un fichier et de préciser le nom de ce fichier. Pour plus d'informations sur les noms des fichiers de trace, voir Noms des fichiers journaux et des fichiers de trace. Si le fichier existe déjà, les nouvelles informations de trace sont ajoutées à la fin du fichier. Vous pouvez également préciser le nombre de fichiers de trace à conserver et la longueur maximale de chacun.

Fonctions d'affichage du terminal

Utilisation de l'affichage du terminal pour des opérations de test et de débogage

Lors du débogage d'applications sur un système de test, vous pouvez indiquer si une fenêtre du terminal affichant des écrans hôtes doit être créée sur le serveur. Vous pouvez utiliser les écrans hôtes affichés dans la fenêtre du terminal pour observer les interactions entre les applications HATS et l'application hôte à l'exécution. Vous pouvez également interagir avec l'application hôte dans la fenêtre du terminal. Les écrans du terminal ne sont créés que pour les connexions établies pendant que cette option est activée. Ils ne sont pas créés pour les connexions existantes ou pour les connexions inactives. Toutefois, le panneau Connexions hôte de la console d'administration HATS inclut un bouton Basculement de l'affichage du terminal qui permet d'activer ou de désactiver cette fonction pour des connexions spécifiques.

ATTENTION :
L'activation du terminal d'affichage peut avoir un effet important sur les performances ou surcharger le serveur. Ne l'utilisez pas sur les serveurs ayant de nombreuses connexions. Cette fonction est destinée au débogage lors du développement d'applications sur un système de test. Elle n'est pas destinée à être utilisée sur un système de production supportant une lourde charge.

Vous pouvez activer le terminal d'affichage pour toute nouvelle connexion hôte en cochant la case associée à l'option Activer le terminal d'affichage dans le panneau Paramètres de la trace, sous l'en-tête Identification des incidents dans le cadre de navigation gauche. Toutefois, vous pouvez utiliser le bouton Basculement du terminal d'affichage du panneau Connexions hôte pour activer ou désactiver cette fonction on à tout moment pour une connexion particulière, quelle que soit la sélection effectuée pour l'option Activer le terminal d'affichage dans le panneau Paramètres de la trace.

Remarques :
  1. Afin que le terminal d'affichage fonctionne correctement lorsque vous lancez WebSphere Application Server en tant que service sur une plateforme Windows, vous devez sélectionner l'option Allow service to interact with desktop dans les paramètres de service associés à WebSphere Application Server.
  2. Pour plus d'informations sur l'affichage des graphiques, (requis pour la fonction d'affichage du terminal), à l'aide de Native Abstract Windowing Toolkit (NAWT) sur la plateforme IBM i, voir la section Running your Java application on a host that does not have a graphical user interface, dans le document System i Programming IBM Developer Kit for Java, disponible à l'adresse http://publib.boulder.ibm.com/infocenter/iseries/v5r4/topic/rzaha/rzaha.pdf.
  3. Pour plus d'informations sur la configuration des fonctions d'affichage du terminal sur d'autres plateformes, voir la section System i, System z, and Unix platform-specific information dans le centre de documentation HATS à l'adresse http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.