Propriedades customizadas do IBM MQ

WebSphere Application Server suporta o uso de propriedades customizadas para definir propriedades do IBM MQ. Isto é útil porque permite que o WebSphere Application Server trabalhe com versões mais recentes do IBM MQ que podem ter propriedades que não estão disponíveis no console administrativo do WebSphere Application Server.

Para o WebSphere Application Server Versão 7.0 ou posterior, as propriedades customizadas definidas são validadas pelo adaptador de recursos do IBM MQ contido no WebSphere Application Server. Em liberações anteriores, isso era feito no próprio WebSphere Application Server e, depois, pelos clientes jar do cliente IBM MQ. Se você definiu uma propriedade que não é válida para o IBM MQ, o adaptador de recursos do IBM MQ cria uma exceção, que é capturada pelo WebSphere Application Server, e registrada nos arquivos Systemout.log e SystemErr.log. Exemplos de mensagens de erro são fornecidos no final deste tópico.

Quando uma versão mais recente do IBM MQ que é suportada pela instalação do WebSphere Application Server está disponível, novas propriedades do IBM MQ que não são conhecidas pelo WebSphere Application Server podem ser criadas. É possível configurá-las como propriedades customizadas por meio do WebSphere Application Server para que sejam reconhecidas pelo adaptador de recursos do IBM MQ. Também é possível configurar o WebSphere Application Server para apontar para o adaptador de recursos do IBM MQ no provedor JMS externo, conforme descrito em Configurando o provedor de sistemas de mensagens IBM MQ com informações de bibliotecas nativas.

Para obter informações sobre valores válidos para propriedades do IBM MQ, consulte as seções Usando Java e Administração do Sistema do centro de informações do IBM MQ.

Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma recomendação alternativa, é possível configurar o servidor para usar a infraestrutura de log e rastreio do High Performance Extensible Logging (HPEL) em vez de usar os arquivos SystemOut.log , SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM® i. Também é possível usar HPEL em conjunção com os recursos de criação de log z/OS nativos. Se você estiver usando HPEL, será possível acessar todas as informações de log e rastreio usando a ferramenta de linha de comandos LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre a utilização do HPEL para resolução de problemas dos aplicativos para obter mais informações sobre o uso do HPEL.

Os cenários a seguir ilustram como as diferentes configurações de células podem ser afetadas.

Cenário de Nó Misto

Neste cenário de modo combinado, uma célula consiste em um gerenciador de implementação do WebSphere Application Server, Versão 9.0, dois nós do WebSphere Application Server, Versão 6, e dois nós do WebSphere Application Server, Versão 9.0. Se um connection factory do IBM MQ for definido no nível de célula e tiver definidas propriedades customizadas que exploram os novos campos disponíveis no IBM MQ, a connection factory será ligada apenas às células do WebSphere Application Server que estão no nível do Versão 9.0. Os nós do WebSphere Application Server, Versão 6 não sabem sobre as novas propriedades do IBM MQ e não são ligadas ao Java™ Naming and Directory Interface (JNDI). Os aprimoramentos feitos no WebSphere Application Server, Versão 9.0 permitem que a validação das propriedades seja adiada para o adaptador de recursos IBM MQ.
Figura 1. Cenário de Nó Misto

Cenário do WebSphere MQ Versão 7 ou Posterior

Neste cenário, uma célula consiste em um WebSphere Application Server, um gerenciador de implementação do Versão 9.0 e nós. O provedor de sistemas de mensagens do IBM MQ está em execução em um nível posterior ao Versão 6. O WebSphere Application Server está usando o adaptador de recursos padrão do IBM MQ fornecido com o WebSphere Application Server Versão 9.0. Neste cenário, o adaptador de recursos do IBM MQ não está ciente das novas propriedades do IBM MQ, assim, a validação falha e a connection factory não faz ligação com a JNDI.
Figura 2. Versão Futura do Cenário do IBM MQ

Cenário Configurado Corretamente

Neste cenário, que é semelhante ao anterior, uma célula consiste em um WebSphere Application Server, um gerenciador de implementação do Versão 9.0 e nós. O provedor de sistemas de mensagens do IBM MQ está em execução em um nível posterior ao Versão 6. Para usar com sucesso as novas propriedades do IBM MQ, é necessário configurar o WebSphere Application Server para apontar para o adaptador de recursos do IBM MQ associado à versão mais recente do IBM MQ.
Figura 3. Cenário Configurado Corretamente

Exemplo de Mensagem de Erro

A exceção criada pelo adaptador de recursos contém mensagem de erro semelhante ao seguinte exemplo:
[09/02/06 15:40:06:377 GMT] 0000000a ContainerImpl E   WSVR0501E: Erro ao criar
componente nulo [class com.ibm.ws.runtime.component.ApplicationServerImpl]
com.ibm.ws.exception.RuntimeWarning: com.ibm.ws.runtime.component.binder.
ResourceBindingException: configuração inválida transmitida para a lógica de ligação de recursos.
RAZÃO: Falha ao criar a connection factory: Ocorreu um erro ao construir AdminObject,
código de erro: XAQCF PropertyName : XAQCF PropertyName
em que PropertyName é o nome da propriedade inválida.

Í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=cmm_customprops
Nome do arquivo: cmm_customprops.html