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.

As variáveis do WebSphere podem ser utilizadas para configurar:
  • 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 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:
    • Para um aplicativo ou módulo que usa um Java EE versão anterior à versão 5, a extensão do arquivo deverá ser .xmi.
    • Para um aplicativo ou módulo que usa Java EE 5 ou posterior, a extensão do arquivo deve ser .xml. Se os arquivos .xmi forem incluídos no aplicativo ou módulo, o produto ignorará os arquivos .xmi.

    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
  • [z/OS]O serviço do local para a plataforma z/OS.
Quando uma variável é definida, ela recebe um escopo. O escopo é o intervalo de locais dentro da rede do produto em que a variável é aplicável.
  • 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.

Um valor de atributo de configuração de cadeia pode consistir em:
  • 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.

[Windows]Para sistemas operacionais Microsoft Windows, os caminhos de arquivos especificados são prefixados com /Arquivos de Programas.

Tabela 1. Atributos e Variáveis do WebSphere . A tabela a seguir ilustra todas as combinações possíveis.
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.

Evitar Problemas Evitar Problemas: A sintaxe de expansão da variável que consiste em um símbolo de dólar e um nome de variável de única letra sem chaves ou parênteses circundantes, não é suportada. Todas as referências de variáveis do WebSphere devem ser colocadas entre parênteses ou chaves correspondentes, mesmo se for uma letra única. Essa sintaxe exigia o escape de sinais de cifrão para evitar ambigüidade.gotcha
Tabela 2. Símbolo de Dólar Literal . Para compatibilidade com versões anteriores, o escape do símbolo de dólar literal ainda é suportado e o símbolo de dólar literal é interpretado conforme indicado na tabela a seguir.
Valor de entrada Valor após expansão
$ $
$$ $
$$$ $$
$$$$ $$
$$$$$ $$$

Ícone que indica o tipo de tópico Tópico de Conceito



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ccws_variable
Nome do arquivo: ccws_variable.html