Variables de WebSphere
Las variables de WebSphere son pares de nombre y valor que se utilizan para proporcionar valores para cualquiera de los atributos de tipos de datos de serie que se utilizan para configurar el producto. Una vez que se ha definido una variable, el nombre simbólico que se especifica para dicha variable se puede especificar en el campo Valor de cualquier otro campo de configuración del producto que acepte un valor de serie.
- Nombres de vía de acceso de WebSphere Application Server, tales como JAVA_HOME y APP_INSTALL_ROOT.
- El valor de la vía de acceso para el atributo de servicio de archivos o JSP extendedDocumentRoot. Esta capacidad le permite añadir una aplicación a cada uno de los nodos de un entorno en clúster sin modificar el archivo ibm-web-ext.xmi de dicha aplicación en cada nodo.
Supported configurations: Para los archivos de enlace y extensión de IBM®, la extensión del nombre de archivo .xmi o .xml es diferente en función de si se utiliza una aplicación o módulo previo a Java EE 5 o una aplicación o módulo Java™ EE 5 o posterior. Un archivo de enlace o extensión de IBM se denomina ibm-*-ext.xmi o ibm-*-bnd.xmi donde * es el tipo de archivo de extensión o enlace como app, application, ejb-jar o web. Se aplican las condiciones siguientes:
No obstante, puede existir un módulo de Java EE 5 o posterior dentro de una aplicación que incluya archivos previos a Java EE 5 y que utilice la extensión de nombre de archivo .xmi.
Los archivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, y ibm-portlet-ext.xmi siguen utilizando la extensión de archivo .xmi.
sptcfg - Determinados valores de personalización de la célula
El servicio de ubicación para la plataforma z/OS.
- Una variable con un ámbito a nivel de célula está disponible en toda la célula del gestor de despliegue.
- Una variable con un ámbito a nivel de clúster está disponible en todo el clúster de la célula.
- Una variable con un ámbito a nivel de nodo sólo está disponible en el nodo y en los servidores de ese nodo. Si una variable a nivel de nodo tiene el mismo nombre que una variable a nivel de célula, el valor de la variable a nivel de nodo tiene preferencia.
- Una variable de servidor sólo está disponible en el proceso de un servidor. La variable de servidor tiene prioridad sobre una variable con el mismo nombre definida en un nivel superior.
El valor de un atributo de configuración puede contener referencias a una o más variables. La sintaxis de un atributo de estas características es el nombre de la variable, incluido entre corchetes { } o entre paréntesis ( ). En cualquier caso, la variable irá precedida por el signo de dólar.
- Literales de serie, incluidos el valor nulo y una serie vacía
- Referencias de variable, cada una de las cuales con uno o varios niveles de indirección
- Referencias de variable anidadas.
- Cualquier combinación de literales de serie que no sean nulos ni vacíos, referencias de variable y referencias de variable anidadas.
Para sistemas operativos Microsoft
Windows, las vías de acceso de archivo van precedidas por /Archivos de programa.
El atributo de configuración consta de: | Valor de atributo de configuración | Nombre de la variable | Valor de la segunda variable | Valor de la tercera variable | Valor de la cuarta variable | Valor de atributo de configuración expandido |
---|---|---|---|---|---|---|
Literal de serie | /IBM/WebSphere/AppServer | N/D | N/D | N/D | N/D | /IBM/WebSphere/AppServer |
Referencia de variable | $(WAS_INSTALL_ROOT) | WAS_ INSTALL_ ROOT | /IBM/WebSphere/AppServer | N/D | N/D | /IBM/WebSphere/AppServer |
Referencia de variable con literal de serie | $(USER_INSTALL_ROOT)/temp | USER_ INSTALL_ ROOT | N/D | N/D | /IBM/WebSphere/AppServer/profiles/AppSrv01 | /IBM/WebSphere/AppServer/profiles/AppSrv01/temp |
Referencia de variable indirecta con un literal de serie | $(WAS_INSTALL_ROOT)/lib | WAS_ INSTALL_ ROOT | $(MY_INSTALL_ROOT) | MY_INSTALL_ ROOT | N/D | N/D |
Referencias de variable anidadas con literal de serie (Ejemplo 1) | $(${INSTALL_TYPE}_INSTALL_ROOT)/lib | INSTALL_ TYPE | USER | USER_INSTALL_ ROOT | /IBM/WebSphere/AppServer/profiles/AppSrv01 | /IBM/WebSphere/AppServer/profiles/AppSrv01/lib |
Referencias de variable anidada con literal de serie (Ejemplo 2) | $(${INSTALL_TYPE}_INSTALL_ROOT)/lib | INSTALL_ TYPE | WAS | WAS_INSTALL_ ROOT | /IBM/WebSphere/AppServer/AppServer | /IBM/WebSphere/AppServer/AppServer/lib |
Durante el proceso de configuración, siempre que se encuentra una variable como un valor de un atributo de configuración, se realiza una expansión de variable en dicha variable. Una expansión de variable es el proceso de sustituir de forma recursiva referencias de variable por valores de variable hasta que quede un solo literal de serie como valor para el atributo de configuración. Si el proceso de expansión detecta una variable no definida correctamente, la expansión de dicha variable se detendrá y se emitirá la excepción VariableExpansionException. El proceso de configuración del producto prosigue. Sin embargo, es posible que se produzcan errores de procesamiento debido al establecimiento incorrecto del valor de este atributo de configuración.

Valor de entrada | Valor tras la expansión |
---|---|
$ | $ |
$$ | $ |
$$$ | $$ |
$$$$ | $$ |
$$$$$ | $$$ |