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 :
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 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.
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 ( ).
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é.
La valeur de ce paramètre est un nombre entier. La valeur par défaut est 512 Ko.
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é.
La valeur de ce paramètre est un nombre entier. La valeur par défaut est 10240 ko.
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.
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.
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.
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.
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.
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.
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.
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.
La valeur de ce paramètre est un nombre entier, où
La valeur par défaut est 0.
La valeur de ce paramètre est binaire. La valeur par défaut est 0.
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.
La valeur de ce paramètre est un nombre entier compris entre 0 et 3. Les différentes valeurs ont la signification suivante :
La valeur par défaut est 0.
La valeur de ce paramètre est un nombre entier compris entre 0 et 2. Les différentes valeurs ont la signification suivante :
La valeur par défaut est 0.
La valeur de ce paramètre est un nombre entier compris entre 0 et 3. Les différentes valeurs ont la signification suivante :
La valeur par défaut est 0.
La valeur de ce paramètre est binaire. La valeur par défaut est 0.
La valeur de ce paramètre est binaire. La valeur par défaut est 0.
La valeur de ce paramètre est un nombre entier compris entre 0 et 3. Les différentes valeurs ont la signification suivante :
La valeur par défaut est 0.
La valeur de ce paramètre est un nombre entier compris entre 0 et 3. Les différentes valeurs ont la signification suivante :
La valeur par défaut est 0.
La valeur de ce paramètre est un nombre entier compris entre 0 et 3. Les différentes valeurs ont la signification suivante :
La valeur par défaut est 0.
La valeur de ce paramètre est binaire. La valeur par défaut est 0.