Propriedades customizadas do IBM MQ

WebSphere® Application Server suporta o uso de propriedades personalizadas para definir propriedades IBM MQ. Isso é útil porque permite que o WebSphere Application Server funcione com versões posteriores do IBM MQ que podem ter propriedades que não estão disponíveis no console administrativo WebSphere Application Server.

Para a versão WebSphere Application Server 7.0 ou posterior, as propriedades personalizadas que você define são validadas pelo adaptador de recursos IBM MQ contido em WebSphere Application Server. Nas versões anteriores, isso era feito dentro do próprio WebSphere Application Server e, em seguida, pelos arquivos jar do cliente IBM MQ. Se você definiu uma propriedade que não é válida para IBM MQ, o adaptador de recursos IBM MQ cria uma exceção, que é capturada por 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 posterior do IBM MQ estiver disponível e for compatível com a instalação do WebSphere Application Server, novas propriedades IBM MQ poderão ser criadas e não serão reconhecidas pelo WebSphere Application Server. Você pode configurá-las como propriedades personalizadas em WebSphere Application Server para que sejam reconhecidas pelo adaptador de recursos IBM MQ. Você também pode configurar WebSphere Application Server para apontar para o adaptador de recursos IBM MQ no provedor JMS externo, conforme descrito em Configurando o provedor de mensagens IBM MQ com informações sobre bibliotecas nativas.

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

Nota: Este tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma alternativa recomendada, é possível configurar o servidor para usar o log e a infraestrutura de rastreamento High Performance Extensible Logging (HPEL) em vez de usar arquivos SystemOut.log , SystemErr.log, trace.loge activity.log em sistemas distribuídos e IBM® i . Você também pode usar o HPEL em conjunto com suas instalações de registro nativas do z/OS® . Se estiver usando o HPEL, é possível acessar todas as suas informações de rastreamento e log usando a ferramenta de linha de comandos LogViewer no diretório bin do perfil do servidor. Consulte as informações sobre como usar o HPEL para solucionar problemas em aplicativos para obter mais detalhes 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

Nesse cenário de nó 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 WebSphere Application Server, Versão 9.0 . Se uma fábrica de conexões IBM MQ for definida no nível da célula e tiver propriedades personalizadas definidas que exploram os novos campos disponíveis em IBM MQ, então a fábrica de conexões será vinculada apenas às células WebSphere Application Server que estão no nível da versão 9.0. Os nós do WebSphere Application Server, versão 6, não reconhecem as novas propriedades IBM MQ e não se vinculam à Java™ Naming and Directory Interface (JNDI). As melhorias feitas em 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
Os nós da versão 6.0 não serão ligados ao JNDI

WebSphere MQ Versão 7 ou cenário posterior

Neste cenário, uma célula consiste em WebSphere Application Server, Versão 9.0 gerenciador de implementação e nós. O provedor de mensagens IBM MQ está sendo executado em um nível posterior à versão 6. WebSphere Application Server está usando o adaptador de recursos padrão IBM MQ fornecido com o WebSphere Application Server Versão 9.0. Nesse cenário, o adaptador de recursos IBM MQ não reconhece as novas propriedades IBM MQ, portanto a validação falha e a fábrica de conexões não se vincula ao JNDI.
Figura 2 Versão futura do cenário " IBM MQ "
As jarras clientes da versão 6 não reconhecem as novas propriedades da versão do WebSphere MQ e a fábrica de conexão falhará em ligar no JNDI

Cenário Configurado Corretamente

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

Exemplo de Mensagem de Erro

A exceção criada pelo adaptador de recursos contém mensagens de erro semelhantes ao seguinte exemplo:
[09/02/06 15:40:06:377 GMT] 0000000a ContainerImpl E   WSVR0501E: Error creating
component null [class com.ibm.ws.runtime.component.ApplicationServerImpl]
com.ibm.ws.exception.RuntimeWarning: com.ibm.ws.runtime.component.binder.
ResourceBindingException: invalid configuration passed to resource binding logic.
REASON: Failed to create connection factory: Error raised constructing AdminObject,
error code: XAQCF PropertyName : XAQCF PropertyName
em que PropertyName é o nome da propriedade inválida.