Configurações de Connection Factory de Fila do Provedor de Sistemas de Mensagens do WebSphere MQ

Utilize esse painel para visualizar ou alterar as propriedades de configuração do connection factory de fila selecionado 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 os destinos de fila JMS associados.

Um connection factory de fila do WebSphere MQ é utilizado para criar conexões JMS com filas fornecidas pelo WebSphere MQ para o sistema de mensagens ponto a ponto.

Para visualizar as configurações de connection factory de fila do WebSphere MQ, utilize o console administrativo para concluir as seguintes etapas:
  1. Na área de janela de navegação, clique emRecursos > JMS > Connection factories de fila para exibir os connection factories de fila existentes.
  2. Se apropriado, na área de janela de conteúdo, altere a configuração Escopo para o nível no qual os connection factories de fila estão definidos. Isso restringe o conjunto de connection factories de fila exibidos.
  3. Selecione o nome do connection factory de fila com o qual deseja trabalhar.
Em Propriedades Gerais, há quatro grupos de propriedades:

Faça todas as alterações necessárias nos grupos de propriedades das configurações de Administração, Conexão, 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 o connection factory de fila.

É possível especificar as seguintes propriedades adicionais usando os Comandos Administrativos do WebSphere MQ: Para obter informações adicionais sobre essas propriedades, consulte Comando createWMQConnectionFactory.
Nota: Ao especificar propriedades do WebSphere MQ, as seguintes restrições são aplicadas:

Um connection factory de fila 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 provedores 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 connection factory de fila 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 o connection factory de fila é criado.

Para todos os connection factories de fila criados 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 esse connection factory de fila é conhecido para propósitos administrativos no WebSphere Application Server.

Tipo de Dados Cadeia
Intervalo O nome deve ser exclusivo no conjunto de connection factories de fila definido para a célula.
Nome JNDI

O nome JNDI que é utilizado para ligar o factory de conexão da fila ao espaço de nomes.

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 desse connection factory de fila 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 do factory de conexão da fila selecionado ter sido criado usando uma Client Channel Definition Table (CCDT).

Se o connection factory de fila selecionado foi criado 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 o connection factory de fila selecionado não foi criado usando uma CCDT, 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.

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 o connection factory de fila especificado 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 enviar ou receber mensagens.

Tipo de Dados Cadeia
Intervalo Se este factory de conexão da fila não for baseado em uma CCDT, o valor deverá ser um nome de gerenciador de filas válido.
Se esta connection factory de fila 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 esse connection factory de fila 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 um connection factory de fila que esteja configurado 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 um connection factory de fila 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.

Ao utilizar um connection factory de fila do provedor de sistemas de mensagens do WebSphere MQ no ambiente do cliente, o cliente obtém as informações de configuração SSL do arquivo ssl.client.props. O uso desse arquivo é detalhado nas informações de referência relacionada deste tópico.

Você só pode utilizar um conjunto de criptografia na configuração SSL para um connection factory de fila do provedor de sistemas 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 do connection factory de fila 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 corresponderá ao connection factory de fila, 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.

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
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
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 connection factory 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 de 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 ele se conecta.

Para o Fix Pack 5 ou mais recente, se esse connection factory for usado 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.

Suportar Protocolo Two-Phase Commit Distribuído

Uma opção que especifica se o connection factory de fila suporta a coordenação XA de transações de sistema de mensagens. Ative essa opção se vários recursos, incluindo esse connection factory de fila, tiverem de ser utilizados na mesma transação.

Se limpar esta propriedade, você desativa o suporte para o protocolo two-phase commit distribuído. A sessão JMS ainda pode ser incluída em uma transação, mas ela usa as chamadas da transação local do gerenciador de recursossession.commit e session.rollback, em vez de chamadas XA. Isso pode levar a uma melhoria de desempenho. Entretanto, um único recurso apenas poderá ser registrado em uma transação no WebSphere Application Server.

O suporte ao último participante permite que você inscreva um recurso não-XA a outros recursos qualificados para XA.

Tipo de Dados Caixa de Opção
Padrão Selecionado
Intervalo
Selecionado
O connection factory de fila suporta o uso de protocolos two-phase commit distribuídos para a coordenação de trabalho transacionado.
Desmarcado
O connection factory de fila não suporta o uso de protocolos two-phase commit distribuídos para a coordenação de trabalho transacionado.

Mantenha essa opção selecionada se as transações envolverem outros recursos, incluindo outras filas ou tópicos. Desmarque essa opção apenas quando tiver certeza de que o gerenciador de filas que é o destino desse connection factory de fila for o único recurso na transação.

Definições de Segurança
Alias de Autenticação para Recuperação XA

O nome e senha de usuário a usar para se conectar ao WebSphere MQ durante recuperação XA.

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 durante a recuperação XA.
Alias de Configuração de Mapeamento

Este campo será utilizado apenas na ausência de uma configuração de login na referência de recurso do componente.

Quando o valor de autoridade do recurso é "container", a maneira preferida para definir a estratégia de autenticação é especificando uma configuração de login e as propriedades associadas na referência de recurso do componente.

Se a configuração de login DefaultPrincipalMapping for especificada, a propriedade associada será um alias de entrada de dados de autenticação JAAS - J2C. Para configurar as informações de autenticação para usar com o connection factory de fila, sob Itens Relacionados, clique em Dados de autenticação JAAS - J2C .

Tipo de Dados Lista drop-down
Padrão (nenhum(a))
Intervalo
ClientContainer
WSLogin
WSKRB5Login
DefaultPrincipalMapping
TrustedConnectionMapping
KerberosMapping
Alias de Autenticação Gerenciado por Contêiner

O alias de autenticação que especifica o nome do usuário e a senha a serem utilizados na conexão com o provedor de sistemas de mensagens do 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
Página da Web da biblioteca do WebSphere MQ em http://www.ibm.com/software/ts/mqseries/library (on-line)
Coleta de Connection factory de fila
Biblioteca do WebSphere MQ (on-line)


Nome do arquivo: umj_pqcfm.html