Configurações de connection factory do provedor de sistemas de mensagens IBM MQ

Use esse painel para visualizar ou mudar as propriedades de configuração do connection factory selecionado para uso com o provedor de sistemas de mensagens IBM MQ. Estas propriedades de configuração controlam como as conexões são criadas para as filas e tópicos JMS associados.

O provedor de sistemas de mensagens IBM MQ suporta interfaces independentes de domínio JMS 1.1, como o connection factory de JMS unificado. Um aplicativo independente de domínio pode utilizar a mesma interface para o sistema de mensagens de publicação/assinatura e ponto a ponto e pode suportar o sistema de mensagens de publicação/assinatura e ponto a ponto dentro da mesma transação. Com o JMS 1.1, recomenda-se utilizar os Connection Factories JMS unificados independentes de domínio para novos aplicativos. Uma interface específica de domínio estende o equivalente independente de domínio, assim um aplicativo que utiliza fila específica de domínio e connection factories de tópico podem optar por utilizar qualquer interface.

Para visualizar as configurações de connection factory do IBM MQ, use o console administrativo para concluir as seguintes etapas:
  1. Na área de janela de navegação, clique em Recursos > JMS->Connection Factories para exibir connection factories 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 estão definidos. Isso restringe o conjunto de connection factories exibidos.
  3. Selecione o nome do connection factory 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:
  • Propriedades avançadas para exibir ou mudar as propriedades avançadas do connection factory do IBM MQ.
  • Propriedades do broker para exibir ou mudar as propriedades do broker do connection factory do IBM MQ.
  • Propriedades customizadas para exibir ou mudar as propriedades customizadas do connection factory do IBM MQ.
  • Propriedades de transporte do cliente para exibir ou mudar as propriedades de transporte do cliente do connection factory do IBM MQ. Se o connection factory selecionado não foi criado usando uma Tabela de Definição de Canal de Cliente (CCDT), siga esse link para inserir todas as informações necessárias para conectar-se ao IBM MQ. Se o connection factory selecionado foi criado usando uma CCDT, não é necessário fornecer as propriedades de transporte do cliente e, assim, o link está ausente.
  • Conjuntos de conexões para exibir ou mudar os detalhes do conjunto de conexões do connection factory do IBM MQ.
  • Conjuntos de sessões para exibir ou mudar os detalhes dos conjuntos de sessões do connection factory do IBM MQ.

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.

É possível especificar as seguintes propriedades adicionais usando comandos administrativos do IBM MQ:
  • -localAddress
  • -clonedSubs
  • -componentAuthAlias
Para obter informações adicionais sobre essas propriedades, consulte Comando createWMQConnectionFactory.
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 informações adicionais sobre como configurar recursos JMS do IBM MQ, consulte as seções Usando Java e Administração do sistema IBM MQ do IBM MQ Knowledge center.

Se a funcionalidade do IBM MQ tiver sido desativada em um escopo que afete esse recurso do provedor de sistemas de mensagens do IBM MQ, em seguida, aparecerá uma mensagem informativa indicando que o IBM MQ foi desativado. Em um único ambiente do servidor, essa mensagem informativa será exibida somente quando o servidor for reiniciado após a funcionalidade do IBM MQ ter sido desativada. Em ambiente de implementação de rede, a mensagem informativa é exibida imediatamente.

Um connection factory unificado do IBM MQ tem as seguintes propriedades.

Administration

Escopo

O nível no qual esta definição do connection factory é 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 deseja procurar por, ou alterar, outros recursos em um escopo diferente, altere o escopo no painel de coleção de connection factory e, em seguida, clique em Aplicar antes de clicar no link para o tipo de recurso.

Informações Valor
Tipo de dados Sequência de Caracteres

Provedor

O provedor JMS designado quando o connection factory de fila é criado.

Para todos os connection factories que usam esse painel, o provedor é o provedor de sistemas de mensagens IBM MQ.

O provedor é exibido somente para informação.

Informações Valor
Tipo de dados Sequência

Nome

O nome pelo qual esta connection factory é conhecida para propósitos administrativos dentro do WebSphere Application Server.

Informações Valor
Tipo de dados String
Range O nome deve ser exclusivo no conjunto de connection factories definido para a célula.

Nome de JNDI

O nome JNDI que é utilizado para ligar o connection factory 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 Dado Sequência de Caracteres

Description

Uma descrição desta connection factory, para propósitos administrativos no WebSphere Application Server.

Informações Valor
Tipo de dados Sequência de Caracteres
Default Nulo

Connection

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 selecionado foi criado usando uma CCDT, somente as seguintes propriedades são exibidas:
  • URL da Tabela de Definições de Canal do Cliente
  • Queue manager
  • Configuração do SSL
Se o connection factory selecionado não foi criado 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
    • Porta
  • 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ê desmarcar a caixa de seleção para a propriedade Usar SSL para proteger a comunicação com o IBM MQ, as seguintes propriedades não poderão ser usadas:
    • Centralmente Gerenciado
    • Configuração Específica
    • Configuração do SSL

Para obter informações adicionais sobre como configurar as propriedades de SSL para o IBM MQ, consulte Propriedades de SSL na seção Usando Java do centro de informações do IBM MQ.

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 Sequência de Caracteres

Gerenciador de Filas

Se o connection factory especificado 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 especificado do IBM MQ para enviar ou receber mensagens.

Informações Valor
Tipo de Dado Sequência
Range Se esta connection factory não for baseada em uma CCDT, o valor deverá ser um nome de gerenciador de filas válido.
Se esta connection factory 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 filas1
  • Um asterisco (*)
  • Em branco1
1Quando 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 da connection factory 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 suspensa
Default 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 informações adicionais sobre a configuração de um tipo de transporte de Ligações, em seguida, cliente ou Ligações, consulte Configurando o provedor de sistemas de mensagens 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 Sequência de Caracteres

Port

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

Informações Valor
Tipo de dados Número Inteiro
Default 1414
Range 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.

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

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 connection factory 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
Default Desconfigurar
Range 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 usada em um ambiente de célula combinada, as informações na propriedade de lista de nomes de conexão não estão disponíveis para as versões do WebSphere Application Server anteriores à Versão 8.0. Nesse caso, as informações nos campos de nome de host e nome de porta, baseadas no primeiro elemento da lista de nomes de conexões, serão usadas.

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 Sequência de Caracteres
Default SYSTEM.DEF.SVRCONN
Range 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 as 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 usar um connection factory do provedor de sistemas de mensagens IBM 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 > Certificado SSL e Gerenciamento de Chaves.

Ao usar um connection factory do provedor de sistemas de mensagens IBM MQ no ambiente do cliente, o cliente usa 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.

É possível usar apenas um conjunto de cifras na configuração SSL para um connection factory do provedor de sistemas de mensagens 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 de SSL

Centralmente Gerenciado

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

Ao selecionar este botão de opções, o nome do host e os atributos de porta da connection factory 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 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 o connection factory, 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 de 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 de none for selecionada, a configuração SSL do WebSphere Application Server padrão gerenciada centralmente para o provedor de sistemas de mensagens IBM MQ será usada.

Informações Valor
Tipo de dados Lista suspensa

Avançada

ID do Cliente

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

A identidade do cliente não é um ID de usuário no sentido convencional e não está relacionado à segurança. Ele é usado por assinaturas duráveis no sistema de mensagens de publicação-assinatura. Uma assinatura durável continua coletando mensagens enquanto o assinante está "fora" (por exemplo, não está em execução ou falhou) e entrega essas mensagens quando ele se reconecta. A identidade do cliente é o token que informa qual assinante você é ao se reconectar, para que você obtenha as mensagens que foram salvas em sua ausência.

Informações Valor
Tipo de dados Sequência de Caracteres

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
Default Não selecionada
Range
Selecionadas
Várias instâncias de uma assinatura durável podem ser acessadas simultaneamente por diferentes servidores.
Desativado
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. Esse valor é usado para determinar se será feita uma conexão com uma determinada versão 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 Sequência de Caracteres
Range 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.

Suportar Protocolo Two-Phase Commit Distribuído

Uma opção que especifica se o connection factory suporta a coordenação XA de transações de sistema de mensagens. Ative essa opção se vários recursos, incluindo esse connection factory, 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, somente um único recurso poderá ser inscrito 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.

Informações Valor
Tipo de Dado Caixa de opção
Padrão Selecionadas
Intervalo
Selecionadas
O connection factory suporta o uso de protocolos two-phase commit distribuídos para a coordenação de trabalho transacionado.
Não selecionada
O connection factory 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. Limpe essa opção apenas quando estiver certo de que o gerenciador de filas que é o destino para essa factory de conexão da fila é o único recurso na transação.

Definições de Segurança

Alias de Autenticação para Recuperação XA

O nome do usuário e senha a serem usados ao conectar-se ao IBM MQ durante a recuperação XA.

Informações Valor
Tipo de dados Lista suspensa
Default (nenhum(a))
Range Todos os aliases de autenticação definidos para a célula e o valor "(none)", que especifica que nenhuma credencial é transmitida para o IBM MQ durante a recuperação XA.

Alias de Configuração de Mapeamento

Este campo é 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, sob Itens Relacionados, clique em Dados de autenticação JAAS - J2C .

Informações Valor
Tipo de dados Lista suspensa
Default (nenhum(a))
Range As seguintes opções estão disponíveis:
  • 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 senha a serem usados ao conectar-se ao provedor de sistemas de mensagens IBM MQ.

Informações Valor
Tipo de dados Lista suspensa
Default (nenhum(a))
Range 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.

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=umj_pjcfm
Nome do arquivo: umj_pjcfm.html