Configurações de Especificação de Ativação do Provedor de Sistemas de Mensagens do WebSphere MQ

Use este painel para visualizar ou alterar as propriedades de configuração da especificação de ativação selecionada para uso com o provedor de sistemas de mensagens do IBM MQ. Essas propriedades de configuração controlam como as conexões são criadas para filas e tópicos associados.

Para visualizar as configurações de especificação de ativação do IBM MQ, use o console administrativo para concluir as seguintes etapas:

Na área de janela de navegação, clique em Recursos > JMS->Especificações de Ativação para exibir especificações de ativação existentes.
Se apropriado, na área de janela de conteúdo, altere a configuração Escopo para o nível no qual as especificações de ativação estão definidas. Isso restringe o conjunto de especificações de ativação exibidas.
Selecione o nome da especificação de ativação com a qual deseja trabalhar.

Em Propriedades Gerais, há cinco grupos de propriedades:

Administration
Connection
Destino
Avançada
Definições de Segurança

Faça todas as alterações necessárias nos grupos de propriedades das configurações de Administração, Conexão, Destino, Avançado e Segurança e depois clique em Aplicar para salvar as configurações, na área de janela de conteúdo sob Propriedades Adicionais antes, de clicar em qualquer um dos seguintes links:

Propriedades Avançadas para exibir ou alterar as propriedades avançadas da sua especificação de ativação do IBM MQ.
Propriedades do Broker para exibir ou alterar as propriedades do broker da sua especificação de ativação do IBM MQ.
Propriedades Customizadas para exibir ou alterar as propriedades avançadas da sua especificação de ativação do IBM MQ. Por exemplo, use essa opção para configurar a propriedade customizada WAS_EndpointInitialState para uma especificação de ativação. O WAS_EndpointInitialState determina se o consumo de mensagem inicia, ou não, a partir do destino JMS assim que a especificação de ativação é usada para um bean acionado por mensagens para conexão ao destino.
Propriedades de Transporte do Cliente para exibir ou alterar as propriedades de transporte do cliente de especificação de ativação do IBM MQ. Se a especificação de ativação selecionada não tiver sido criada usando uma Client Channel Definition Table (CCDT), siga este link para inserir todas as informações necessárias para se conectar ao IBM MQ. Se a especificação de ativação selecionada foi criada usando um CCDT, não é necessário fornecer as propriedades de transporte do cliente e, assim, o link está ausente.

Sob Itens Relacionados, é possível clicar em Dados de autenticação JAAS - J2C para configurar as informações de autenticação para uso com a especificação de autenticação.

Também é possível especificar a propriedade -localAddress usando o comando administrativo createWMQActivationSpec IBM MQ.

Nota: Ao especificar as propriedades do IBM MQ, as seguintes restrições se aplicam:

Os nomes podem ter um máximo de 48 caracteres, com exceção dos canais que possuem um máximo de 20 caracteres.
Os valores de propriedade que você especifica devem corresponder aos valores que especificou quando configurou o IBM MQ para os recursos JMS. Para obter mais informações, consulte as seções Usando Java e Administração do Sistema do centro de informações do IBM MQ.

Se a funcionalidade do IBM MQ tiver sido desativada em um escopo que afeta esse recurso do provedor de sistemas de mensagens do IBM MQ, então aparece uma mensagem informativa indicando que o IBM MQ foi desativado. Em um ambiente do servidor único, essa mensagem informativa será exibida apenas quando o servidor for reiniciado depois que a funcionalidade do IBM MQ tiver sido desativada. Em ambiente de implementação de rede, a mensagem informativa é exibida imediatamente. Para obter informações adicionais, consulte Desativando a Funcionalidade IBM MQ no WebSphere Application Server.

Uma especificação de ativação do WebSphere MQ tem as seguintes propriedades.

Administration

Escopo

O nível no qual esta definição de recurso é visível aos aplicativos.

Os recursos como provedores de sistemas de mensagens, ligações de namespaces ou bibliotecas compartilhadas podem ser definidos em vários escopos, com recursos definidos em escopos mais específicos substituindo duplicatas que são definidas em escopos mais gerais.

O escopo é exibido apenas para informações e não podem ser alterados neste painel. Se você quiser procurar ou alterar esse recurso (ou outros recursos) em um escopo diferente, altere o escopo no painel de coleção de especificação de ativação do IBM MQ, em seguida, clique em Aplicar antes de clicar no link para o tipo de recurso.

Informações	Valor
Tipo de Dados	String

Provedor

O provedor JMS designado quando a especificação de ativação é criada.

Para todas as especificações de ativação criadas utilizando esse painel, o provedor será o de sistemas de mensagens do IBM MQ.

O provedor é exibido somente para informação.

Informações	Valor
Tipo de Dados	String

Nome

O nome pelo qual essa especificação de ativação é conhecida para propósitos administrativos no WebSphere Application Server.

Informações	Valor
Tipo de Dados	String
Intervalo	O nome deve ser exclusivo no conjunto de especificações de ativação definido para a célula.

Nome de JNDI

O nome JNDI que é utilizado para ligar a especificação de ativação ao namespace JNDI.

Como uma convenção, utilize o nome do JNDI completo; por exemplo, no formato jms/Nome, onde Nome é o nome lógico do recurso.

Informações	Valor
Tipo de Dados	String

Descrição

Uma descrição dessa especificação de ativação para propósitos administrativos no WebSphere Application Server.

Informações	Valor
Tipo de Dados	String
Padrão	Nulo

Connection

As informações necessárias para configurar uma conexão dependem da especificação de ativação selecionada ter sido criada usando uma Client Channel Definition Table (CCDT).

Se a especificação de ativação selecionada foi criada usando uma CCDT, somente as seguintes propriedades são exibidas:

URL da Tabela de Definições de Canal do Cliente
Gerenciador de Filas
Configuração do SSL

Se a especificação de ativação selecionada não foi criada usando uma CCDT, somente as seguintes propriedades são exibidas:

Gerenciador de Filas
Transporte
Se Inserir Informações Separadas de Host e Porta no Formato de Valores de Host e Porta for selecionado, a propriedade da lista de nomes de conexões não poderá ser usada e as seguintes propriedades poderão ser usadas:
- Nome do Host
- Port
Se Inserir Informações de Host e Porta no Formato de uma Lista de Nomes de Conexões for selecionado, a propriedade da lista de nomes de conexões poderá ser usada e as seguintes propriedades não poderão ser usadas:
- Nome do Host
- Port
Canal de Conexão do Servidor
Se você limpar a caixa de opção para a propriedade Usar SSL para garantir a comunicação com o IBM MQ, as seguintes propriedades não podem ser usadas:
- Centralmente Gerenciado
- Configuração Específica
- Configuração do SSL

Para obter mais informações sobre a configuração das propriedades SSL para o IBM MQ, consulte propriedades SSL na seçãoIBM MQ Usando Java do centro de informações do IBM MQ.

Nota: Existem quatro propriedades de conexão do IBM MQ que são usadas para configurar o adaptador de recursos do IBM MQ usado pelo provedor de sistemas de mensagens do IBM MQ. Essas propriedades afetam o conjunto de conexões usado pelas especificações de ativação:

maxConnections
connectionConcurrency (A configuração desta propriedade afeta somente nós do WebSphere Application Server 7. A propriedade não possui efeito para os nós do WebSphere Application Server Versão 8 ou posterior.)
reconnectionRetryCount
reconnectionRetryInterval

Para obter informações adicionais sobre essas quatro propriedades e como configurá-las, consulte Propriedades do Adaptador de Recursos.

URL da Tabela de Definições de Canal do Cliente

Uma URL que especifica o local de uma CCDT do IBM MQ.

Informações	Valor
Tipo de Dados	String

Gerenciador de Filas

Se a especificação de ativação especificada se baseia em uma CCDT, esta propriedade é usada para selecionar uma entrada na CCDT. Caso contrário, essa propriedade especifica o nome do gerenciador de filas ou o grupo de filas compartilhadas ao qual se conectar. Uma conexão é estabelecida com o recurso do IBM MQ especificado para receber mensagens.

Informações

Valor

Tipo de Dados

String

Intervalo

Se esta especificação de validação não for baseada em uma CCDT, o valor deverá ser um nome de gerenciador de filas válido.

Se esta especificação de ativação for baseada em uma CCDT, o valor deverá ser um dos seguintes:

um nome de gerenciador de filas válido
Um asterisco (*) seguido pelo nome de um grupo de gerenciadores de filas¹
Um asterisco (*)
Em branco¹

¹Quando você especifica o valor da propriedade Gerenciador de Filas dessa forma em combinação com uma CCDT, conexões individuais estabelecidas por meio do uso de especificação de ativação podem se conectar a diferentes gerenciadores de filas. A seleção de vários gerenciadores de filas ocorre quando a CCDT contém definições de canal de conexão do cliente múltiplas com um parâmetro queue manager name (QMNAME) correspondente, e essas definições de canal de conexão definem os detalhes da conexão de rede de diferentes gerenciadores de filas.

Se a connection factory especificada estiver baseada em uma CCDT e a CCDT puder selecionar entre mais de um gerenciador de filas, talvez você não consiga recuperar transações globais. Por isso, para connection factories que especificam uma CCDT, você tem duas alternativas:

Evitar qualquer ambiguidade no gerenciador de filas de destino ao especificar a propriedade do gerenciador de filas, o que significa que o valor especificado dessa propriedade não deve incluir um asterisco (*).
Evitar usar os recursos com aplicativos que estão inscritos nas transações globais.

Transporte

O tipo de transporte do IBM MQ para a conexão. O tipo de transporte é usado para determinar os mecanismos exatos para se conectar ao IBM MQ.

Informações	Valor
Tipo de Dados	Lista drop-down
Padrão	Ligações, depois cliente
Intervalo	Cliente Use uma conexão de rede baseada em TCP/IP para se comunicar com o gerenciador de filas do IBM MQ. Ligações, depois cliente Tente uma conexão no modo de ligações com o gerenciador de filas. Se isso não for possível, reverta para o transporte de cliente. Ligações Estabeleça uma conexão de memória cruzada com um gerenciador de filas que está executando no mesmo nó. As seguintes propriedades do Modo de Transporte do Cliente estão desativadas: Nome do Host Port Lista de Nomes de Conexões Canal de Conexão do Servidor Para obter mais informações sobre a configuração de um tipo de transporte de `Ligações, Depois Cliente` ou `Ligações`, consulte Configurando o Provedor de Sistema de Mensagens do IBM MQ com Informações de Bibliotecas Nativas.

Inserir Informações Separadas de Host e Porta no Formato de Valores de Host e Porta

Se este botão de opções estiver selecionado, significa que a conexão com o gerenciador de filas do IBM MQ será feita usando as informações fornecidas pelas propriedades de nome de host e porta.

Selecionar essa opção ativará as propriedades de nome de host e porta e desativará a propriedade da lista de nomes de conexões. Para inserir informações da lista de nomes de conexões, clique em Inserir Informações de Host e Porta no Formato de uma Lista de Nomes de Conexões.

Esse botão de opções estará disponível apenas se a propriedade do escopo especificar uma célula ou cluster, ou se a propriedade do escopo especificar um nó ou servidor e que esse nó ou servidor está executando o WebSphere Application Server Versão 8.0 ou posterior.

Informações	Valor
Tipo de Dados	Botão de Opções

Nome do Host

O nome do host, endereço IPv4 ou IPv6 do gerenciador de filas do IBM MQ ao qual se conectar.

Informações	Valor
Tipo de Dados	String

Port

O número de porta no qual o IBM MQ está atendendo.

Informações	Valor
Tipo de Dados	Número Inteiro
Padrão	1414
Intervalo	O valor deve estar no intervalo de 1 a 65536 (inclusive).

Inserir Informações de Host e Porta no Formato da Lista de Nomes de Conexões

Se este botão de opções estiver selecionado, significa que a conexão com o gerenciador de filas do IBM MQ será feita usando as informações fornecidas pela propriedade da lista de nomes de conexões.

As listas de nomes de conexões podem ser utilizadas para se conectar a um único gerenciador de filas ou a um gerenciador de filas com várias instâncias. Para obter mais informações sobre como usar um gerenciador de filas com várias instâncias, consulte o centro de informações do IBM MQ. Selecionar essa opção ativará a propriedade da lista de nomes de conexões e desativará as propriedades de nome de host e porta. Para inserir informações de host e porta separadas, clique em Inserir Informações Separadas de Host e Porta no Formato de Valores de Host e Porta.

Informações	Valor
Tipo de Dados	Botão de Opções

Lista de Nomes de Conexões

A lista de nomes de conexões que especifica detalhes do nome de host e porta quando você quiser que a especificação de ativação se conecte a um gerenciador de filas com várias instâncias.

Essa propriedade só deve ser usada para permitir a conexão com um gerenciador de filas com várias instâncias. Ela não deve ser usada para permitir conexões com gerenciadores de filas sem muitas instância, pois isso pode resultar em problemas de integridade da transação.

Informações

Valor

Tipo de Dados

String

Padrão

Desconfigurar

Intervalo

Este campo deve ser configurado para uma sequência no seguinte formato:

host[(port)][,host(port)]

As informações de porta são opcionais e, se não especificada, a porta será padronizada como 1414.

host deve ser um nome de host TCP/IP ou endereço IPv4 ou IPv6 válido.

port deve ser um valor de número inteiro no intervalo de 1 a 65536 (inclusive).

Por exemplo: localhost(1234),remotehost1(1234),remotehost2

Quando a propriedade da lista de nomes de conexões é especificada, as propriedades de nome de host ou porta são automaticamente configuradas para o número de porta e nome de host da primeira entrada na lista de nomes de conexões. Dessa forma, se você especificasse localhost(1234),remotehost1(1234),remotehost2, o nome de host seria configurado para o host local e a porta seria configurada como 1234.

Essa propriedade estará disponível apenas se a propriedade do escopo especificar uma célula ou cluster, ou se a propriedade do escopo especificar um nó ou servidor e que esse nó ou servidor está executando o WebSphere Application Server Versão 8.0 ou posterior.

Quando usado em um ambiente de célula mista, as informações da propriedade da lista de nomes, das especificações de ativação do cluster ou do escopo da célula, estarão disponíveis para os nós doWebSphere Application Server Versão 7.0. O comportamento exato depende do nível do fix pack do nó:

Para nós em execução em um nível de fix pack do WebSphere Application Server Versão 7.0 Fix Pack 7 ou posterior, a propriedade da lista de nomes de conexões poderá ser usada para se conectar a gerenciadores de filas com várias instâncias.
Para nós em execução em um nível de fix pack anterior ao Versão 7.0, a propriedade da lista de nomes de conexões não será reconhecida e uma mensagem de aviso semelhante ao seguinte exemplo será a saída:
```
[09/29/10 12:15:27:468 BST] 00000018 J2CUtilityCla W   
J2CA0008W: Classe com.ibm.mq.connector.inbound.ActivationSpecImpl usada pelo recurso 
cells/L3A3316Node01Cell/resources.xml#J2CResourceAdapter_1284547647859 não continha 
o método setConnectionNameList. Continuação do processamento.
```
Nesse caso, as informações nas propriedades de nome de host e porta serão usadas para se conectar a um gerenciador de filas.

Canal de Conexão do Servidor

O nome do canal de conexão do servidor IBM MQ usado ao se conectar ao IBM MQ.

Informações	Valor
Tipo de Dados	String
Padrão	SYSTEM.DEF.SVRCONN
Intervalo	O valor deve ser um canal de conexão do servidor definido para o gerenciador de filas do IBM MQ ao qual se está conectado.

Usar SSL para Proteger Comunicações com o IBM MQ

Esta opção determina se o protocolo SSL (Secure Sockets Layer) será usado para proteger as comunicações de rede com o gerenciador de filas ou grupo de filas compartilhadas do IBM MQ.

Ao utilizar uma especificação de ativação do provedor de sistemas de mensagens do IBM MQ no ambiente do servidor de aplicativos, o servidor de aplicativos gerenciará a configuração SSL. Para alterar parâmetros de configuração do SSL, utilize o console administrativo para navegar para o painel Segurança > Certificado SSL e Gerenciamento de Chaves.

Você só pode utilizar um conjunto de criptografia na configuração SSL para uma especificação de ativação do provedor de sistema de mensagens do IBM MQ. Se você especificar mais de um conjunto de criptografia, somente o primeiro será utilizado.

Informações	Valor
Tipo de Dados	Caixa de opção. Se esta caixa de opção estiver limpa, as seguintes propriedades SSL estão desativadas: Centralmente Gerenciado Configuração Específica Configuração do SSL

Centralmente Gerenciado

Quando o protocolo SSL for utilizado para a comunicação com o IBM MQ, selecione esse botão de opções para especificar que a configuração SSL será obtida da configuração SSL gerenciada centralmente pelo WebSphere Application Server.

Ao selecionar este botão de opções, o nome do host e os atributos de porta da especificação de ativação do provedor de sistema de mensagens do IBM MQ serão usados para selecionar uma configuração SSL apropriada. Se as informações de host e porta tiverem sido fornecidas para a especificação de ativação por uma lista de nomes de conexões, significa que as informações de nome de host e porta do primeiro elemento na lista serão usadas para selecionar uma configuração SSL adequada. Para fornecer a configuração SSL que será comparada com a especificação de ativação, consulte o tópico Definições de Configuração SSL de Terminal de Saída Dinâmica, listado na referência relacionada.

Informações	Valor
Tipo de Dados	Botão de Opções

Configuração Específica

Selecione este botão de opções quando desejar especificar uma configuração SSL específica para uso quando o SSL precisar ser usado para proteger as comunicações de rede com o gerenciador de filas ou grupo de filas compartilhadas do IBM MQ.

Informações	Valor
Tipo de Dados	Botão de Opções

Configuração do SSL

A configuração SSL a ser usada quando o SSL precisar ser usado para proteger as comunicações de rede com o gerenciador de filas ou grupo de filas compartilhadas do IBM MQ.

Essa propriedade será desativada se o botão de opções Gerenciado Centralmente for selecionado e o recurso do provedor de sistemas de mensagens do IBM MQ tiver sido explicitamente definido.

Essa propriedade estará sempre ativada se o recurso do provedor de sistemas de mensagens do IBM MQ estiver baseado em uma CCDT.

Se esse recurso do provedor de sistemas de mensagens do IBM MQ estiver baseado em uma CCDT, esse parâmetro será utilizado apenas se as entradas relevantes na CCDT tiverem sido configuradas para utilizar SSL.

Além disso, se uma configuração SSL none for selecionada, a configuração SSL padrão do WebSphere Application Server gerenciada centralmente para o provedor de sistemas de mensagens do IBM MQ será usada.

Informações	Valor
Tipo de Dados	Lista drop-down

Destino

Nota: A propriedade WAS_EndpointInitialState é uma propriedade customizada. Essa propriedade determinará se o consumo de mensagens iniciará ou não a partir do destino JMS assim que a especificação de ativação for usada para um bean acionado por mensagens para conexão com o destino. Para configurar propriedades customizadas, quando você tiver concluído suas mudanças nesta área de janela de conteúdo e tiver clicado em Aplicar para salvar a configuração, então clique no link Propriedades Customizadas na área de janela de conteúdo, em Propriedades Adicionais.

Nome de JNDI de Destino

O nome JNDI para o destino JMS para o qual as mensagens são consumidas para entrega a um bean acionado por mensagem (MDB) que está configurado para usar esta especificação de ativação.

Informações	Valor
Tipo de Dados	String

Seletor de Mensagens

Uma expressão do seletor de mensagem especificando quais mensagens serão entregues.

Informações	Valor
Tipo de Dados	String

Tipo de Destino

O tipo de destino (fila ou tópico) do qual consumir mensagens.

Informações	Valor
Tipo de Dados	Lista drop-down
Intervalo	O nome JNDI de Destino se refere a um destino JMS que é uma fila. Tópico O nome JNDI de Destino se refere a um destino JMS que é um tópico.

Assinatura Durável

Uma opção para especificar se uma assinatura durável ou não durável é usada para entregar mensagens a uma assinatura MDB para o tópico.

Informações	Valor
Tipo de Dados	Caixa de opção
Padrão	Desmarcado (não durável)
Intervalo	Não selecionado Não-durável. Selecionadas Durável.

Nome da assinatura

O nome de uma assinatura durável. Este está disponível somente quando a caixa de opção Assinatura durável é selecionada.

Informações	Valor
Tipo de Dados	String

Avançada

ID do Cliente

O identificador de cliente a ser especificado ao conectar-se ao provedor de sistemas de mensagens do IBM MQ.

Informações	Valor
Tipo de Dados	String

Permitir Assinaturas Duráveis Clonadas

Uma opção que determina se múltiplas instâncias de uma assinatura durável podem ser acessadas simultaneamente por diferentes servidores.

Informações	Valor
Tipo de Dados	Caixa de opção
Padrão	Não selecionado
Intervalo	Selecionadas Várias instâncias de uma assinatura durável podem ser acessadas simultaneamente por diferentes servidores. Não selecionado Várias instâncias de uma assinatura durável não podem ser acessadas simultaneamente por diferentes servidores.

Versão do Provedor

A versão do provedor de sistemas de mensagens do IBM MQ. Utilizada para determinar se deve ser feita uma conexão com uma versão específica de um gerenciador de filas. Ela também é utilizada para determinar o tipo de funções requeridas pelo cliente.

Informações

Valor

Tipo de Dados

String

Intervalo

O valor inserido deve ser uma cadeia vazia ou estar em um dos seguintes formatos:

n.n.n.n
n.n.n
n.n
n

em que n é um valor numérico maior ou igual a zero.

Por exemplo, 6.0.0.0.

Definições de Segurança

Alias de Autenticação

O nome de usuário e a senha que serão usados para se conectar ao IBM MQ.

Informações	Valor
Tipo de Dados	Lista drop-down
Padrão	(nenhum(a))
Intervalo	Todos os aliases de autenticação definidos para a célula e o valor "(nenhum)", que especifica que nenhuma credencial será transmitida ao IBM MQ.

Nome do arquivo: umj_pasm.html