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

Utilize esse 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 WebSphere 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 WebSphere MQ, utilize o console administrativo para concluir as seguintes etapas:
  1. Na área de janela de navegação, clique em Recursos > JMS > Especificações de Ativação para exibir especificações de ativação existentes.
  2. 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.
  3. Selecione o nome da especificação de ativação com a qual deseja trabalhar.
Em Propriedades Gerais, há cinco grupos de propriedades:
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:

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 os Comandos Administrativos do WebSphere MQ . Para obter informações adicionais sobre essa propriedade, consulte Comando createWMQActivationSpec.

Nota: Ao especificar propriedades do WebSphere MQ, as seguintes restrições são aplicadas:

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

Administração
Escopo

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

Os recursos como fornecedores de sistemas de mensagens, ligações de espaços de nomes 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 informativo e não pode ser alterado neste painel. Se você quiser procurar ou alterar esse recurso (ou outros recursos) em um escopo diferente, altere o escopo no painel de coleta de especificação de ativação do WebSphere MQ; em seguida, clique em Aplicar, antes de clicar no link para o tipo de recurso.

Tipo de Dados Cadeia
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 é o de sistemas de mensagens do WebSphere MQ.

O provedor é exibido somente para informação.

Tipo de Dados Cadeia
Nome

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

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

O nome JNDI que é utilizado para ligar a especificação de ativação ao espaço de nomes 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.

Tipo de Dados Cadeia
Descrição

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

Tipo de Dados Cadeia
Padrão Nulo
Conexão

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 de 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
  • Nome do Host
  • Porta
  • 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 Websphere MQ, as seguintes propriedades não podem ser usadas:
    • Gerenciado Centralmente
    • Configuração Específica
    • Configuração de SSL

Para obter mais informações sobre como configurar as propriedades SSL para o WebSphere MQ, consulte a seção SSL properties no manual WebSphere MQ Using Java.

Nota: Há outras quatro propriedades de conexão do WebSphere MQ que afetam a especificação de ativação:
  • maxConnections
  • connectionConcurrency
  • reconnectionRetryCount
  • reconnectionRetryInterval
Embora essas propriedades controlam o comportamento da especificação de ativação do WebSphere MQ, elas são configuradas como propriedades customizadas do provedor de sistemas de mensagens do WebSphere MQ. Para obter mais informações sobre essas quatro propriedades de conexão e sobre como configurá-las, consulte Configurando propriedades customizadas para o provedor de sistema de mensagens WebSphere MQ.
URL da Tabela de Definições de Canal do Cliente

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

Tipo de Dados Cadeia
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 especificará o nome do gerenciador de filas ou do grupo de filas compartilhadas a ser conectado. Uma conexão é estabelecida com este recurso especificado do WebSphere MQ para receber mensagens.

Tipo de Dados Cadeia
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 do grupo de gerenciador de filas 1
  • Um asterisco (*)
  • Em branco 1
1Quando especificar o valor da propriedade do Gerenciador de Filas nesse formato em combinação com um CCDT, conexões individuais estabelecidas usando essa especificação de ativação podem ser feitas com gerenciadores de filas diferentes. A seleção de vários gerenciadores de filas ocorre quando um CCDT contiver várias definições de canal de conexão do cliente com um parâmetro queue manager name (QMNAME) correspondente e essas definições de canal de conexão especificam os detalhes de conexão de rede de gerenciadores de filas diferentes.

As transações globais não devem ser usadas com uma especificação de ativação que esteja configurada para selecionar a partir de vários gerenciadores de filas usando um CCDT, porque o gerenciador de transação pode não conseguir recuperar transações globais após uma falha.

Transporte

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

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 WebSphere 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
  • Porta
  • Canal de Conexão do Servidor
Para obter informações adicionais 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 WebSphere MQ com Informações de Bibliotecas Nativas e Dimensionando Conjuntos de Encadeamentos Utilizados pelo Provedor de Sistemas de Mensagens do WebSphere MQ.

As informações sobre o dimensionamento dos conjuntos de encadeamentos utilizados pelo provedor de sistemas de mensagens do WebSphere MQ não são relevantes para o Fix Pack 5 ou mais recente porque o conjunto de encadeamentos WMQCommonServices não é mais usado.

Nome do Host

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

Tipo de Dados Cadeia
Porta

O número da porta no qual o WebSphere MQ está atendendo.

Tipo de Dados Inteiro
Padrão 1414
Intervalo O valor deve estar no intervalo de 1 a 65536 (inclusive).
Canal de Conexão do Servidor

O nome do canal de conexão do servidor WebSphere MQ utilizado ao conectar-se com o WebSphere MQ.

Tipo de Dados Cadeia
Padrão SYSTEM.DEF.SVRCONN
Intervalo O valor deve ser um canal de conexão do servidor definido para o gerenciador de filas do WebSphere MQ ao qual se está conectando.
Utilizar SSL para Comunicação Segurança com o WebSphere MQ

Esta opção determina se o protocolo SSL (Secure Sockets Layer) é usado para garantir as comunicações de rede com o gerenciador de filas ou grupo de filhas compartilhadas WebSphere MQ.

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

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 WebSphere MQ. Se você especificar mais de um conjunto de criptografia, somente o primeiro será utilizado.

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

Quando o protocolo SSL é utilizado para a comunicação com o WebSphere MQ, selecione esse botão de opção para especificar que a configuração do SSL é obtida a partir da configuração do SSL gerenciada centralmente do 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 WebSphere MQ são usados para selecionar uma configuração SSL apropriada. 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.

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 particular para uso quando o SSL deve ser usado para garantir as comunicações de rede com o gerenciador de filas ou grupo de filas compartilhadas do WebSphere MQ.

Tipo de Dados Botão de Opções
Configuração de SSL

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

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

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

Se esse recurso do provedor de sistemas de mensagens do WebSphere MQ for baseado em uma CCDT, este 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 de nenhum está selecionada, a configuração SSL padrão do WebSphere Application Server gerenciada centralmente para o provedor de sistema de mensagens do WebSphere MQ é usada.

Tipo de Dados Lista drop-down
Destino
Nome 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.

Tipo de Dados Cadeia
Seletor de Mensagens

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

Tipo de Dados Cadeia
Tipo de Destino

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

Tipo de Dados Lista drop-down
Intervalo
Fila
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.

Tipo de Dados Caixa de Opção
Padrão Desmarcado (não durável)
Intervalo
Desmarcado
Não-durável.
Selecionado
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.

Tipo de Dados Cadeia
Avançada
ID do Cliente

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

Tipo de Dados Cadeia
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.

Tipo de Dados Caixa de Opção
Padrão Desmarcado
Intervalo
Selecionado
Várias instâncias de uma assinatura durável podem ser acessadas simultaneamente por diferentes servidores.
Desmarcado
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 WebSphere 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 deve ser usada para determinar o tipo de funções necessário pelo cliente.

Nota: Antes do Fix Pack 5, se essa especificação de ativação for usada para conectar a um gerenciador de filas ou ao grupo de compartilhamento de filas em um sistema WebSphere MQ for z/OS, insira o valor 6.0.0.0 na propriedade Versão do Provedor. Esse connection factory deve usar esse valor de versão do provedor independente da versão do WebSphere MQ for z/OS para o qual ela se conecta.

Para o Fix Pack 5 ou mais recente, se essa especificação de ativação for usada para conectar a um gerenciador de filas ou ao grupo de compartilhamento de filas em um sistema WebSphere MQ for z/OS Versão 7, insira o valor 6.0.0.0 na propriedade Versão do Provedor.

Para o Fix Pack 7 ou mais recente, a restrição da versão do provedor é aumentada.

Tipo de Dados Cadeia
Intervalo O valor inserido deve ser uma cadeia vazia ou deve 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 ou senha de usuário a usar para se conectar ao WebSphere MQ.

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 é transmitida ao WebSphere MQ.



Links marcados (on-line) requerem acesso à Internet.

Conceitos relacionados
Tarefas relacionadas
Referências relacionadas
Coleta de Especificação de Ativação
Biblioteca do WebSphere MQ (on-line)


Nome do arquivo: umj_pasm.html