Variáveis do WebSphere
As variáveis do WebSphere são pares de nome e valor que são utilizadas para fornecer configurações de quaisquer atributos de tipo de dados da cadeia que são utilizados para configurar o produto. Depois que uma variável for definida, o nome simbólico especificado para essa variável pode ser especificado no campo Valor de qualquer outro campo de configuração do produto que aceite um valor de cadeia.
- Nomes de caminho do WebSphere Application Server, como JAVA_HOME e APP_INSTALL_ROOT
- Um valor de caminho para o atributo JSP ou de serviço de arquivo extendedDocumentRoot. Essa capacidade permite incluir um aplicativo em
cada nó em um ambiente em cluster sem modificar o arquivo
ibm-web-ext.xmi para esse aplicativo em cada nó.
Configurações suportadas: Para arquivos de extensão e de ligação IBM®, a extensão do nome do arquivo .xmi ou .xml é diferente dependendo de você estar utilizando um aplicativo pré-Java EE 5 ou um módulo ou um aplicativo ou módulo Java™ EE 5 ou posterior. Um arquivo de extensão ou de ligação IBM é denominado ibm-*-ext.xmi ou ibm-*-bnd.xmi em que * é o tipo de arquivo de extensão ou de ligação como app, aplicativo, ejb-jar ou web. As seguintes condições se aplicam:
No entanto, um módulo Java EE 5 ou posterior pode existir dentro de um aplicativo que inclui arquivos pré-Java EE 5 e usa a extensão do nome do arquivo .xmi.
Os arquivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, e ibm-portlet-ext.xmi continuam a usar as extensões de arquivo .xmi.
sptcfg - Determinados valores de customização de toda a célula
O serviço do local para a plataforma z/OS.
- Uma variável com um escopo de toda a célula está disponível por toda a célula do gerenciador de implementação.
- Uma variável com um escopo de todo o cluster está disponível por todo o cluster na célula.
- Uma variável com um escopo de nível do nó está disponível apenas no nó e nos servidores nesse nó. Se uma variável no nível do nó tiver o mesmo nome que uma variável de célula, o valor da variável no nível do nó tem precedência.
- Uma variável do servidor está disponível apenas em um processo do servidor. Uma variável do servidor têm precedência sobre uma variável com o mesmo nome definido em um nível superior.
O valor de um atributo de configuração pode conter referências a uma ou mais variáveis. A sintaxe de tal atributo é o nome da variável, colocada entre chaves { } ou entre parênteses ( ). Em qualquer um dos casos, a variável é seguida pelo sinal de cifrão.
- Cadeias literais, incluindo o valor nulo e uma cadeia vazia
- Referências de variáveis em que cada uma inclui um ou mais níveis de vias indiretas
- Referências a variáveis aninhadas.
- Qualquer combinação de cadeias literais não nulas e não vazias, referências de variáveis e referências de variáveis aninhadas.
Para sistemas operacionais Microsoft Windows, os caminhos de arquivos especificados são prefixados com
/Arquivos de Programas.
O atributo de configuração consiste em: | Valor do atributo de configuração | Nome da variável | Valor da segunda variável | Valor da terceira variável | Valor da quarta variável | Valor do atributo de configuração expandido |
---|---|---|---|---|---|---|
Cadeia literal | /IBM/WebSphere/AppServer | N/D | N/D | N/D | N/D | /IBM/WebSphere/AppServer |
Referência de variável | $(WAS_INSTALL_ROOT) | WAS_ INSTALL_ ROOT | /IBM/WebSphere/AppServer | N/D | N/D | /IBM/WebSphere/AppServer |
Referência de variável com uma cadeia literal | $(USER_INSTALL_ROOT)/temp | USER_ INSTALL_ ROOT | N/D | N/D | /IBM/WebSphere/AppServer/profiles/AppSrv01 | /IBM/WebSphere/AppServer/profiles/AppSrv01/temp |
Referência de variável indireta com uma cadeia literal | $(WAS_INSTALL_ROOT)/lib | WAS_ INSTALL_ ROOT | $(MY_INSTALL_ROOT) | MY_INSTALL_ ROOT | N/D | N/D |
Referências de variáveis aninhadas com cadeia literal (Exemplo 1) | $(${INSTALL_TYPE}_INSTALL_ROOT)/lib | INSTALL_ TYPE | USER | USER_INSTALL_ ROOT | /IBM/WebSphere/AppServer/profiles/AppSrv01 | /IBM/WebSphere/AppServer/profiles/AppSrv01/lib |
Referências de variáveis aninhadas com cadeia literal (Exemplo 2) | $(${INSTALL_TYPE}_INSTALL_ROOT)/lib | INSTALL_ TYPE | WAS | WAS_INSTALL_ ROOT | /IBM/WebSphere/AppServer/AppServer | /IBM/WebSphere/AppServer/AppServer/lib |
Durante o processo de configuração, sempre que uma variável for encontrada como o valor de um atributo de configuração, uma expansão de variável será executada nessa variável. Uma expansão de variável é o processo de substituição recursiva de referências de variáveis com valores de variáveis até apenas uma cadeia literal permanecer como o valor do atributo de configuração. Se o processo de expansão encontrar uma variável que não esteja corretamente definida, a expansão dessa variável será interrompida e uma exceção VariableExpansionException será emitida. O processo de configuração do produto continua. Entretanto, podem ocorrer erros de processamento devido ao valor desse atributo de configuração não estar estabelecido corretamente.

Valor de entrada | Valor após expansão |
---|---|
$ | $ |
$$ | $ |
$$$ | $$ |
$$$$ | $$ |
$$$$$ | $$$ |