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 variables WebSphere permettent de configurer :

WebSphere® Application Server noms de chemin, tels que JAVA_HOMEet 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 utilisez une application ou un module antérieur àJava EE 5 ou une application ou un module Java™ EE 5 ou ultérieur. Un fichier d'extension ou de liaison IBM est nommé ibm-*-ext.xmi ou ibm-*-bnd.xmi , où * correspond au type de fichier d'extension ou de liaison, tel que app, application, ejb-jarou web. Les conditions suivantes s'appliquent :
- Pour une application ou un module qui utilise une version Java EE antérieure à la version 5, l'extension de fichier doit être .xmi.
- Pour une application ou un module qui utilise Java EE 5 ou version ultérieure, l'extension de fichier doit être .xml. Si des fichiers .xmi sont inclus avec l'application ou le module, le produit ignore les fichiers .xmi.
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.
certaines valeurs de personnalisation applicables à une cellule
le service de localisation pour la plateforme z/OS.

Lorsqu'une variable est définie, une portée lui est attribuée. La portée correspond à la série d'emplacements du réseau du produit dans lesquels la variable est applicable.

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 tel attribut est le nom de la variable, entre une paire d'accolades { } ou une paire de parenthèses (). Dans les deux cas, la variable est effectuée par le signe dollar.

Une valeur d'attribut de configuration de chaîne peut être constituée des éléments suivants :

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.

[Windows] Pour les systèmes d'exploitation Microsoft Windows , les chemins de fichier spécifiés sont précédés du préfixe wth /Program Files.

Tableau 1. WebSphere variables et attributs . Le tableau suivant répertorie toutes les combinaisons possibles.
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	Non disponible	Non disponible	Non disponible	Non disponible	/IBM/WebSphere/AppServer
Référence de variable	$(WAS_ INSTALL_ ROOT)	WAS_ INSTALL_ ROOT	/IBM/WebSphere/AppServer	Non disponible	Non disponible	/IBM/WebSphere/AppServer
Référence de variable avec littéral chaîne	$(USER_ INSTALL_ ROOT)/temp	USER_ INSTALL_ ROOT	Non disponible	Non disponible	/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	Non disponible	Non disponible
Références de variables imbriquées avec littéral chaîne (Exemple 1)	$(${INSTALL_ TYPE}_ INSTALL_ ROOT)/lib	INSTALL_ TYPE	UTILISATEUR	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.

Pour les utilisateurs en transition: La syntaxe d'extension de variable fournie dans les versions 6.0.x et 6.1.x du produit inclut une variante qui se compose d'un signe dollar et d'un nom de variable à une seule lettre sans accolade ni parenthèse. Cette syntaxe n'est pas prise en charge dans version 8.5 ou ultérieure. Toutes les références de variables WebSphere doivent être placées entre parenthèses ou accolades, même s'il s'agit d'une unique lettre. Cette syntaxe nécessite le caractère d'échappement du symbole du dollar pour éviter toute ambiguïté.

Tableau 2. Signe littéral du dollar . Pour des raisons de compatibilité avec les versions antérieures, la syntaxe sans symbole dollar est toujours prise en charge et le symbole dollar littéral est interprété comme indiqué dans le tableau ci-après.
Valeur en entrée	Valeur après extension
$	$
$$	$
$$$	$$
$$$$	$$
$$$$$	$$$