Variables WebSphere
Les variables WebSphere sont des paires nom-valeur qui fournissent des paramètres pour les attributs de type de données de chaîne utilisés pour configurer le produit. Après qu'une variable ait été définie, le nom symbolique spécifié pour cette variable peut être spécifié dans la zone Valeur de tout autre zone de configuration du produit acceptant une valeur de chaîne.
- les noms de chemins WebSphere Application Server, tels que JAVA_HOME et APP_INSTALL_ROOT
- une valeur de chemin pour les pages JSP extendedDocumentRoot ou le fichier qui fournit
l'attribut. Cette fonction permet d'ajouter une application à chaque noeud dans un environnement de cluster sans modifier le fichier ibm-web-ext.xmi de l'application sur chaque noeud.
Configurations prises en charge: Pour les fichiers de liaison et d'extension IBM®, l'extension de nom de fichier .xmi ou .xml est différente selon que vous utilisiez un module ou une application antérieure à Java EE 5 ou un module ou une application ultérieure à Java™ EE 5. Un fichier de liaison ou d'extension IBM porte le nom ibm-*-ext.xmi ou ibm-*-bnd.xmi où * correspond au fichier d'extension ou de liaison, tel app, application, ejb-jar ou web. Les conditions suivantes s'appliquent :
Toutefois, un module Java EE 5 ou version ultérieure peut exister dans une application qui inclut des fichiers antérieurs à Java EE 5 et utilise l'extension de nom de fichier .xmi.
Les fichiers ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi et ibm-portlet-ext.xmi continuent d'utiliser les extensions de fichier .xmi.
sptcfg - certaines valeurs de personnalisation applicables à une cellule
le service de localisation pour la plateforme z/OS.
- Une variable dont la portée est de niveau cellule est disponible dans toute la cellule du gestionnaire de déploiement.
- Une variable dont la portée est de niveau cluster est disponible dans tout le cluster de la cellule.
- Une variable dont la portée est de niveau noeud n'est disponible que sur le noeud et les serveurs de ce noeud. Si une variable de niveau noeud possède le même nom qu'une variable de cellule, c'est la valeur de la variable de niveau noeud qui prévaut.
- Une variable de serveur n'est disponible que sur le processus du serveur. Une variable de serveur est prioritaire par rapport à une variable de même nom définie à un niveau supérieur.
La valeur d'un attribut de configuration peut contenir des références à une ou plusieurs variables. La syntaxe d'un attribut de ce type est le nom de la variable placé entre accolades { } ou entre parenthèses ( ). Dans tous les cas, la variable est suivie du signe dollar.
- littéraux chaîne, incluant les valeurs null et les chaînes vides ;
- références de variables incluant chacune un ou plusieurs niveau(x) d'adressage indirect ;
- références de variables imbriquées ;
- toute combinaison de littéraux chaîne non vide et non null, références de variables, et références de variables imbriquées.
Pour les systèmes d'exploitation Microsoft Windows, les chemins d'accès spécifiés sont
précédés du préfixe /Program Files.
Les attributs de configuration sont constitués des éléments suivants : | valeur d'attribut de configuration ; | nom de variable ; | valeur de seconde variable | valeur de troisième variable | valeur de quatrième variable | valeur d'attribut de configuration détaillé |
---|---|---|---|---|---|---|
Littéral chaîne | /IBM/WebSphere/AppServer | N/A | N/A | N/A | N/A | /IBM/WebSphere/AppServer |
Référence de variable | $(WAS_ INSTALL_ ROOT) | WAS_ INSTALL_ ROOT | /IBM/WebSphere/AppServer | N/A | N/A | /IBM/WebSphere/AppServer |
Référence de variable avec littéral chaîne | $(USER_ INSTALL_ ROOT)/temp | USER_ INSTALL_ ROOT | N/A | N/A | /IBM/WebSphere/AppServer/profiles/AppSrv01 | /IBM/WebSphere/AppServer/profiles/AppSrv01/temp |
Référence de variable indirecte avec une littéral chaîne | $(WAS_ INSTALL_ ROOT)/lib | WAS_ INSTALL_ ROOT | $(MY_INSTALL_ ROOT) | MY_INSTALL_ ROOT | N/A | N/A |
Références de variables imbriquées avec littéral chaîne (Exemple 1) | $(${INSTALL_ TYPE}_ INSTALL_ ROOT)/lib | INSTALL_ TYPE | USER | USER_INSTALL_ ROOT | /IBM/WebSphere/AppServer/profiles/AppSrv01 | /IBM/WebSphere/AppServer/profiles/AppSrv01/lib |
Références de variables imbriquées avec littéral chaîne (Exemple 2) | $(${INSTALL_ TYPE}_ INSTALL_ ROOT)/lib | INSTALL_ TYPE | WAS | WAS_INSTALL_ ROOT | /IBM/WebSphere/AppServer/AppServer | /IBM/WebSphere/AppServer/AppServer/lib |
Lors du processus de configuration, dès qu'une variable tient lieu de valeur d'attribut de configuration, une extension est effectuée sur cette variable. Une extension de variable consiste à remplacer de manière répétée les références de variables par des valeurs de variables jusqu'à ce que seul un littéral chaîne demeure en tant que valeur de l'attribut de configuration. Si le processus d'extension rencontre une variable qui n'est pas correctement définie, l'extension de cette variable s'interrompt et une exception VariableExpansionException est générée. Le processus de configuration du produit se poursuit. Cependant, des erreurs de traitement peuvent se produire car la valeur de cet attribut de configuration n'est pas correctement établie.

Valeur en entrée | Valeur après extension |
---|---|
$ | $ |
$$ | $ |
$$$ | $$ |
$$$$ | $$ |
$$$$$ | $$$ |