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.
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.
Tópico de Conceito