Annexe A. Fichiers des propriétés d'exécution

Les paramètres d'exécution, tels que les paramètres de journalisation, de trace et de licence sont enregistrés dans l'un des deux fichiers suivants :

Pour plus d'informations sur la gestion des paramètres d'exécution des applications Web, voir Gestion des éléments d'identification des incidents. Pour plus d'informations sur la gestion des paramètres d'exécution des applications client enrichi, voir Administration des applications client enrichi HATS.

Les fichiers runtime.properties et runtime-debug.properties contiennent les propriétés suivantes :

adminPortNum
Définit la valeur par défaut utilisée par la console d'administration HATS lorsque la portée de la gestion doit être modifiée. La valeur indiquée doit correspondre à un port BOOTSTRAP_ADDRESS WebSphere actif. La valeur par défaut est 2809, qui est le port BOOTSTRAP_ADDRESS par défaut pour server1 dans une installation WebSphere de base, ou pour le serveur nodeagent lorsque vous fédérez un noeud de serveur d'applications dans une cellule du gestionnaire de déploiement.
ioPatternKey  Web uniquement 
Un ou plusieurs masques définissant les objets d'intégration qui doivent faire l'objet de la trace. Voir la description de trace.INTEGRATIONOBJECT, ci-après.

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.

numLicenses
Indique le nombre de licences acquises. HATS effectue le suivi du nombre de connexions HATS aux ressources hôte et enregistre un message lorsque ce nombre dépasse la valeur de num_licenses.

La valeur de ce paramètre est un nombre entier. Il n'existe pas de valeur par défaut. Les valeurs admises pour les licences utilisateurs autorisés sont comprises entre 1 et 50000. Pour les licences d'unité de valeur, la valeur doit être -1.

licenseHardLimit
Une zone chiffrée qui contient les justificatifs d'autorisation d'utilisation de licence HATS. Ne pas modifiercette zone.
licenseTracking
Indique si HATS enregistre l'utilisation des licences. La valeur de ce paramètre est binaire. La valeur par défaut est 0.
0
HATS n'enregistre pas l'utilisation des licences.
1
HATS enregistre l'utilisation des licences pour tous les serveurs d'applications d'un noeud. HATS assure le suivi du nombre de connexions aux ressources des systèmes hôte ou des bases de données et consigne un message lorsque ce nombre dépasse le nombre de licences acquises. Les informations relatives à l'utilisation des licences sont consignées dans un fichier nommé licensex.txt situé dans le sous-répertoire log du répertoire d'installation de HATS sur le serveur, où x est égal à 1 ou à 2.

La taille maximale des fichiers relatifs à l'utilisation des licences est de 512 ko. Lorsque la taille du fichier license1.txt atteint 512 ko ou que le serveur HATS est redémarré, le fichier est renommé license2.txt et un nouveau fichier license1.txt est créé. Le nouveau fichier license1.txt contient les informations les plus récentes relatives à l'utilisation des licences. Lorsque le nouveau fichier license1.txt atteint 512 ko et est renommé, l'ancien fichier license2.txt est supprimé.

Les fichiers relatifs à l'utilisation des licences contiennent les informations suivantes, organisées en lignes, chaque ligne correspondant à une heure de fonctionnement. Les différentes valeurs sont séparées par un espace ( ).

  1. Date
  2. Heure
  3. Nombre le plus élevé de licences depuis que le serveur est démarré.
  4. Nombre le plus élevé de licences au cours de la dernière heure (valeur maximale parmi les 60 dernières entrées)
  5. Nombre de licences par minute (1-60)
licenseFile
Nom utilisé comme modèle pour la génération des fichiers destinés à contenir les informations relatives à l'utilisation des licences. La valeur par défaut pour cette propriété est license.txt.
logFile
Nom utilisé comme modèle pour la génération des fichiers du serveur d'applications destinés à contenir les données de journalisation. Le nom de base par défaut est messages.txt.
maxLogFiles
Nombre maximal de fichiers de messages. La valeur par défaut est 2.

Le nom de base des fichiers journaux, défini dans le fichier runtime.properties, est utilisé comme modèle pour la génération d'un ensemble unique de fichiers journaux pour chaque serveur d'applications. Le nom de base par défaut peut être modifié dans runtime.properties. Le nom du serveur d'applications qui exécute HATS est la concaténation d'un trait de soulignement (_) suivi du nom de l'instance de HATS, suivi d'un autre trait de soulignement (_).

L'ID de l'instance de HATS (par exemple _SSS_) est ajouté au nom de base pour les fichiers journaux associés au serveur d'applications. Dans notre exemple, le fichier journal est appelé messages _SSS_.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. Par exemple, si l'ID de l'instance de HATS est cellule_noeud_serveur, le fichier journal du serveur d'applications s'appelle messages_cellule_noeud_serveur_.txt. S'il existe plusieurs fichiers journaux pour ce serveur d'applications, ils sont nommés messages_cellule_noeud_serveur_1.txt, messages_cellule_noeud_serveur_2.txt, et ainsi de suite.

Lorsque messages_cellule_noeud_serveur_1.txt atteint maxLogFileSize, il est fermé et renommé messages_cellule_noeud_serveur_2.txt. Un nouveau fichier messages_cellule_noeud_serveur_1.txt est ouvert.

Lorsque messages_cell_node_server_1.txt atteint de nouveau maxLogFileSize, les fichiers journaux précédents sont renommés, par exemple messages_cell_node_server_2.txt est renommé to messages_cell_node_server_3.txt. Ensuite, messages_cellule_noeud_serveur_1.txt est renommé messages_cellule_noeud_serveur_2.txt et un nouveau fichier messages_cellule_noeud_serveur_1.txt est ouvert.

Lorsque maxLogFiles est atteint, le fichier le plus ancien est supprimé.

Remarque :
Dans un environnement WebSphere Application Server for z/OS, la partie serveur du nom des fichiers journaux inclut l'ID espace adresse (asid) du module Servant qui écrit dans le journal (par exemple : messages_asid_1.txt). Pour plus d'informations, voir Noms des fichiers journaux et des fichiers de trace.
maxLogFileSize
Indique la taille maximale d'un fichier journal, en kilooctets. Lorsqu'un fichier atteint cette taille, un nouveau fichier est ouvert.

La valeur de ce paramètre est un nombre entier. La valeur par défaut est 512 Ko.

traceFile
Nom utilisé comme modèle pour la génération des fichiers dans lesquels HATS écrit les informations de trace. Le nom de base par défaut est trace.txt.
maxTraceFiles
Nombre maximal de fichiers de trace. La valeur par défaut est 5.

Le nom de base des fichiers de trace, défini dans le fichier server.properties, est utilisé comme modèle pour la génération d'un ensemble unique de fichiers de trace pour chaque serveur d'applications. Le nom de base par défaut peut être modifié dans runtime.properties. Le nom du serveur d'applications qui exécute HATS est la concaténation d'un trait de soulignement (_) suivi du nom de l'instance du serveur HATS, suivi d'un autre trait de soulignement (_).

L'ID de l'instance du serveur HATS (par exemple _SSS_) est ajouté au nom de base pour la génération du modèle des fichiers de trace associés au serveur d'applications, qui devient trace _SSS_.txt. Enfin, pour la distinction entre les différents fichiers de trace associés à un même serveur, un numéro d'ordre (1, 2, 3, etc.) est ajouté à la fin du nom. Par exemple, si l'ID de l'instance du serveur HATS est cellule_noeud_serveur, le fichier de trace du serveur d'applications s'appelle trace_cellule_noeud_serveur_.txt. 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.

Lorsque trace_cellule_noeud_serveur_1.txt atteint maxTraceFileSize, il est fermé et renommé trace_cellule_noeud_serveur_2.txt. Un nouveau fichier trace_cellule_noeud_serveur_1.txt est ouvert.

Lorsque trace_cellule_noeud_serveur_1.txt atteint de nouveau maxTraceFileSize, les autres fichiers de trace sont renommés -- par exemple, trace_cellule_noeud_serveur_2.txt est renommé trace_cellule_noeud_serveur_3.txt. Ensuite, trace_cellule_noeud_serveur_1.txt est renommé trace_cellule_noeud_serveur_2.txt et un nouveau fichier trace_cellule_noeud_serveur_1.txt est ouvert.

Lorsque maxTraceFiles est atteint, le fichier le plus ancien est supprimé.

Remarque :
Dans un environnement WebSphere Application Server for z/OS, la partie serveur du nom des fichiers de trace inclut l'ID espace adresse (asid) du module Servant qui écrit dans le journal (par exemple : trace_asid_1.txt). Pour plus d'informations, voir Noms des fichiers journaux et des fichiers de trace.
maxTraceFileSize
Indique la taille maximale d'un fichier de trace, en kilooctets. Lorsqu'un fichier atteint cette taille, un nouveau fichier est ouvert.

La valeur de ce paramètre est un nombre entier. La valeur par défaut est 10240 ko.

traceLogDirectory
Définit le répertoire à utiliser pour la consignation du journal et de la sortie de la trace lorsque le fichier EAR de l'application est déployé. Si ce mot clé n'est pas indiqué, ou si la valeur précisée n'est pas valide, le répertoire utilisé est logs et il est placé dans le répertoire d'installation du fichier EAR. Cette valeur est utilisée uniquement lorsque le fichier EAR est déployé sur un serveur d'applications. Elle n'a aucun effet dans l'environnement Toolkit.
maxHODThreadManagerThreads
Indique le nombre maximum d'unités d'exécution qui peuvent être créées dans le pool d'unités d'exécution Host On Demand. Vous pouvez indiquer une valeur comprise entre 10 et 10000. Si vous indiquez une valeur hors de cette plage, le paramètre est ignoré et la valeur Host On Demand par défaut de 10000 est utilisée.

Options de la fonction de trace

Les valeurs du niveau de trace utilisées par les options de la fonction de trace décrites dans cette section correspondent à des chaînes numériques hexadécimales. Chaque bit de la chaîne numérique contrôle un type de trace pour l'exécution. Les valeurs par défaut sont les suivantes :

tracelevel.1 : 0000000000020000
tracelevel.2 : 000000000000020f
tracelevel.3 : 000000000004023f  (minimum)
tracelevel.4 : 0000000000041a3f
tracelevel.5 : 00000000000c1bbf  (normal)
tracelevel.6 : 00000000000c1bbf
tracelevel.7 : 00000000001c1bbf  (maximum)
tracelevel.8 : 00000000001c1bbf
tracelevel.9 : 00000000001c1bbf

Les définitions de chaque bit du masque de trace sont présentées ci-dessous :

x000001  - Messages d'information
x000002  - Messages d'avertissement
x000004  - Messages d'erreur
x000008  - Messages d'erreur grave
x000010  - Traces API
x000020  - Traces API de procédure appelée
x000080  - Entrée de méthode
x000100  - Sortie de méthode
x000200  - Exceptions
x000400  - Traces diverses
x000800  - Créer objet
x001000  - Suppression d'objet
x020000  - Trace de performance - valeur à utiliser seule
x040000  - Données diverses - niveau 1
x080000  - Données diverses - niveau 2
x100000  - Données diverses - niveau 3

Pour personnaliser les valeurs du niveau de trace, ajoutez les valeurs hexadécimales aux masques de trace. Par exemple, si vous indiquez la valeur tracelevel.9=180 puis utilisez la valeur trace.RUNTIME=9, seules les traces d'exécution Entrée de méthode et Sortie de méthode sont effectuées.

trace.RUNTIME
Indique le niveau de trace pour l'exécution principale et pour tous les paramètres de RUNTIME.* qui n'indiquent pas un niveau de trace.

La valeur de ce paramètre est un nombre entier compris entre 0 et 9. La valeur par défaut est 0, qui correspond à l'absence de trace à l'exécution.

trace.RUNTIME.ACTION
Indique le niveau de trace pour les événements de type action. Sa valeur supplante celle du paramètre trace.RUNTIME.

La valeur de ce paramètre est un nombre entier compris entre 0 et 9. La valeur par défaut est 0, qui correspond à l'absence de trace d'événement.

trace.TRANSFORM
Indique le niveau de trace des transformations HATS et de tous les paramètres de TRANSFORM.* qui ne précisent pas de niveau de trace.

La valeur de ce paramètre est un nombre entier compris entre 0 et 9. La valeur par défaut est 0, qui correspond à l'absence de trace de transformation.

trace.TRANSFORM.COMPONENT
Indique le niveau de trace pour les composants de HATS. Ce paramètre remplace le paramètre trace.TRANSFORM.

La valeur de ce paramètre est un nombre entier compris entre 0 et 9. La valeur par défaut est 0, qui correspond à l'absence de trace de composant.

trace.TRANSFORM.WIDGET
Indique le niveau de trace pour les objets fenêtre HATS. Ce paramètre remplace le paramètre trace.TRANSFORM.

La valeur de ce paramètre est un nombre entier compris entre 0 et 9. La valeur par défaut est 0, qui correspond à l'absence de trace d'objet fenêtre.

trace.INTEGRATIONOBJECT Web uniquement 
Indique le niveau de trace pour les objets d'intégration.

La valeur de ce paramètre est un nombre entier compris entre 0 et 9. La valeur par défaut est 0, qui correspond à l'absence de trace d'objet d'intégration.

trace.UTIL
Indique le niveau de trace pour les utilitaires d'exécution HATS.

La valeur de ce paramètre est un nombre entier compris entre 0 et 9. La valeur par défaut est 0, qui correspond à l'absence de trace d'utilitaire d'exécution.

trace.APPLET Web uniquement 
Indique le niveau de trace de l'applet.

La valeur de ce paramètre est un nombre entier, où

0
Aucune trace n'est exécutée.
3
Une trace de niveau minimal est effectuée.
5
Une trace normale est exécutée.

La valeur par défaut est 0.

Fonction de trace de Host On-Demand

trace.HOD.COMMEVENT
Indique le niveau de trace pour les événements COMM Host On-Demand.
0
La trace des événements COMM Host On-Demand n'est pas activée.
1
La trace des événements COMM Host On-Demand est activée.

La valeur de ce paramètre est binaire. La valeur par défaut est 0.

trace.HOD.DISPLAYTERMINAL
Indique si Host On-Demand affiche une fenêtre de terminal pour chaque connexion.
0
Host On-Demand n'affiche pas une fenêtre de terminal pour chaque connexion.
1
Host On-Demand affiche une fenêtre de terminal pour chaque connexion.

La valeur de ce paramètre est binaire. La valeur par défaut est 0.

Si la valeur de trace.HOD.DISPLAYTERMINAL est 1, lorsque HATS crée une connexion hôte (par exemple, en réponse à une demande émise par une application), il génère automatiquement l'affichage du terminal hôte. Ce n'est pas le cas lorsque le paramètre a la valeur 0. Toutefois, que l'affichage du terminal soit lancé automatiquement ou non lors de la création d'une connexion hôte, l'administrateur HATS peut utiliser la console d'administration pour activer ou désactiver cette fonction pour une connexion spécifique.

trace.HOD.DS
Indique le niveau de trace pour le flux de données Host On-Demand.

La valeur de ce paramètre est un nombre entier compris entre 0 et 3. Les différentes valeurs ont la signification suivante :

0
Aucune trace n'est exécutée.
1
Une trace de niveau minimal est effectuée.
2
Une trace normale est exécutée.
3
Une trace de niveau maximal est effectuée.

La valeur par défaut est 0.

trace.HOD.MACRO
Indique le niveau de trace pour les macros Host On-Demand.

La valeur de ce paramètre est un nombre entier compris entre 0 et 2. Les différentes valeurs ont la signification suivante :

0
La trace des macros Host On-Demand n'est pas activée.
1
La trace des événements Host On-Demand est activée.
2
La trace du support Host On-Demand est activée.

La valeur par défaut est 0.

trace.HOD.PS
Indique le niveau de trace pour l'espace de présentation Host On-Demand.

La valeur de ce paramètre est un nombre entier compris entre 0 et 3. Les différentes valeurs ont la signification suivante :

0
Aucune trace n'est exécutée.
1
Une trace de niveau minimal est effectuée.
2
Une trace normale est exécutée.
3
Une trace de niveau maximal est effectuée.

La valeur par défaut est 0.

trace.HOD.PSEVENT
Indique le niveau de trace pour les événements de l'espace de présentation Host On-Demand.
0
La trace des événements de l'espace de présentation Host On-Demand n'est pas activée.
1
La trace des événements de l'espace de présentation Host On-Demand est activée.

La valeur de ce paramètre est binaire. La valeur par défaut est 0.

trace.HOD.OIAEVENT
Indique le niveau de trace pour les événements de la zone d'informations opérateur Host On-Demand.
0
La trace des événements de la zone d'informations opérateur Host On-Demand n'est pas activée.
1
La trace des événements de la zone d'informations opérateur Host On-Demand est activée.

La valeur de ce paramètre est binaire. La valeur par défaut est 0.

trace.HOD.SESSION
Indique le niveau de trace pour les sessions Host On-Demand.

La valeur de ce paramètre est un nombre entier compris entre 0 et 3. Les différentes valeurs ont la signification suivante :

0
Aucune trace n'est exécutée.
1
Une trace de niveau minimal est effectuée.
2
Une trace normale est exécutée.
3
Une trace de niveau maximal est effectuée.

La valeur par défaut est 0.

trace.HOD.TRANSPORT
Indique le niveau de trace pour le transport Host On-Demand.

La valeur de ce paramètre est un nombre entier compris entre 0 et 3. Les différentes valeurs ont la signification suivante :

0
Aucune trace n'est exécutée.
1
Une trace de niveau minimal est effectuée.
2
Une trace normale est exécutée.
3
Une trace de niveau maximal est effectuée.

La valeur par défaut est 0.

trace.HOD.USERMACRO
Indique le niveau des actions de trace pour les macros utilisateur Host On-Demand.

La valeur de ce paramètre est un nombre entier compris entre 0 et 3. Les différentes valeurs ont la signification suivante :

0
Aucune trace n'est exécutée.
1
Une trace de niveau minimal est effectuée.
2
Une trace normale est exécutée.
3
Une trace de niveau maximal est effectuée.

La valeur par défaut est 0.

Trace de simulation de l'hôte

recordSimulationTrace
Indique si l'enregistrement de trace de simulation de l'hôte est activé lors de la phase d'exécution.
0
L'enregistrement de trace de simulation de l'hôte n'est pas activé.
1
L'enregistrement de trace de simulation de l'hôte est activé.

La valeur de ce paramètre est binaire. La valeur par défaut est 0.

startPort
Indique le port de démarrage de la plage de ports à utiliser pendant l'exécution pour procéder à un enregistrement de la trace de simulation hôte pour plusieurs sessions hôte simultanément. Le port par défaut est 7021.
endPort
Indique le port de fin de la plage de ports à utiliser pendant l'exécution pour procéder à un enregistrement de la trace de simulation d'hôte pour plusieurs sessions hôte simultanément. Le port par défaut est 7050.