[Version 5.1 and later]Definições da Fábrica de Conexão de Filas do WebSphere MQ

Utilize esse painel para exibir ou alterar as propriedades de configuração da fábrica de conexões de fila selecionada para ser utilizada com o provedor JMS do WebSphere MQ. Essas propriedades de configuração controlam como as conexões são criadas para o destino de fila JMS associado.

Uma fábrica de conexões de fila é utilizada para criar conexões JMS para destinos de fila. A fábrica de conexões de filas é criada pelo provedor JMS do WebSphere MQ. Uma fábrica de conexões de filas para o provedor JMS do WebSphere MQ possui as seguintes propriedades.

Nota:

Para visualizar essa página do console administrativo, clique em Recursos -> Provedor JMS do WebSphere MQ -> (no painel de conteúdo, em Propriedades Adicionais) Fábricas de Conexões de Filas do WebSphere MQ -> fábrica_de_conexão

Nome
O nome pelo qual esta fábrica de conexões de filas é conhecida para finalidades administrativas dentro do IBM WebSphere Application Server. O nome deve ser exclusivo dentro das fábricas de conexões JMS pelo Domínio Administrativo do WebSphere.
Tipo de Dados String
Nome de JNDI
O nome JNDI utilizado para ligar a fábrica de conexões ao espaço de nomes do servidor de aplicativos.

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

Este nome é utilizado para vincular as informações de ligação da plataforma. A ligação associa os recursos definidos pelo descritor de implementação do módulo para os recursos reais (físicos) vinculados ao JNDI pela plataforma.

Tipo de Dados String
Descrição
Uma descrição desta fábrica de conexões, para finalidades administrativas, dentro do IBM WebSphere Application Server.
Tipo de Dados String
Padrão Nulo
Categoria
Uma categoria utilizada para classificar ou agrupar esta fábrica de conexões para seus registros administrativos do IBM WebSphere Application Server.
Tipo de Dados String
Alias de Autenticação gerenciado por componentes
Esse alias especifica ID do usuário e senha para serem utilizados para autenticar a conexão com um provedor JMS para autenticação gerenciada pelo aplicativo.

Essa propriedade fornece uma lista dos aliases de entrada de dados de autenticação J2C que foram definidos para o WebSphere Application Server. Você pode selecionar um alias de entrada de dados para ser utilizado para autenticar a criação de uma nova conexão com o provedor JMS.

Se você tiver ativado a segurança global para o WebSphere Application Server, selecione o alias que especifica o ID do usuário e a senha utilizados para autenticar a criação de uma nova conexão com o provedor JMS. A utilização deste alias depende da definição de autenticação de recursos (res-auth) declarada na referência de recurso da fábrica de conexões dos descritores de implementação de um componente do aplicativo.

Nota:

  1. IDs de usuários com mais de 12 caracteres não podem ser utilizados para autenticação com o provedor JMS incorporado ao WebSphere. Por exemplo, o ID do usuário padrão do Windows NT, Administrador, não é válido para ser utilizado com o sistema de mensagens incorporado ao WebSphere, porque contém 13 caracteres. Portanto, um alias de autenticação para uma fábrica de conexões do provedor JMS do WebSphere deve especificar um ID do usuário com, no máximo, 12 caracteres.
  2. Para utilizar uma conexão JMS do Provedor JMS do WebSphere MQ ao utilizar o modo de transporte de Ligações, defina a propriedade Tipo de transporte=BINDINGS na Fábrica de Conexões de Filas do WebSphere MQ. É necessário escolher também uma das seguintes opções:
    • Para utilizar credenciais de segurança, verifique se o usuário especificado é o que efetuou logon atualmente no processo do WebSphere Application Server. Se o usuário especificado não for o usuário com logon atual para o processo do WebSphere Application Server, então a autenticação de Ligações JMS do WebSphere MQ emite o erro MQJMS2013 autenticação de segurança inválida fornecida para MQQueueManager.
    • Não especifique credenciais de segurança. Na Fábrica de Conexões do WebSphere MQ, verifique se as propriedades do Alias de Autenticação Gerenciado pelo Componente e do Alias de Autenticação Gerenciado pelo Contêiner não estão definidas.

Alias de Autenticação gerenciado por componentes
Esse alias especifica ID do usuário e senha para serem utilizados para autenticar a conexão com um provedor JMS para autenticação gerenciada pelo contêiner.

Essa propriedade fornece uma lista dos aliases de entrada de dados de autenticação J2C que foram definidos para o WebSphere Application Server. Você pode selecionar um alias de entrada de dados para ser utilizado para autenticar a criação de uma nova conexão com o provedor JMS.

Se você tiver ativado a segurança global para o WebSphere Application Server, selecione o alias que especifica o ID do usuário e a senha utilizados para autenticar a criação de uma nova conexão com o provedor JMS. A utilização deste alias depende da definição de autenticação de recursos (res-auth) declarada na referência de recurso da fábrica de conexões dos descritores de implementação de um componente do aplicativo.

Nota:

  1. IDs de usuários com mais de 12 caracteres não podem ser utilizados para autenticação com o provedor JMS incorporado ao WebSphere. Por exemplo, o ID do usuário padrão do Windows NT, Administrador, não é válido para ser utilizado com o sistema de mensagens incorporado ao WebSphere, porque contém 13 caracteres. Portanto, um alias de autenticação para uma fábrica de conexões do provedor JMS do WebSphere deve especificar um ID do usuário com, no máximo, 12 caracteres.
  2. Para utilizar uma conexão JMS do Provedor JMS do WebSphere MQ ao utilizar o modo de transporte de Ligações, defina a propriedade Tipo de transporte=BINDINGS na Fábrica de Conexões de Filas do WebSphere MQ. É necessário escolher também uma das seguintes opções:
    • Para utilizar credenciais de segurança, verifique se o usuário especificado é o que efetuou logon atualmente no processo do WebSphere Application Server. Se o usuário especificado não for o usuário com logon atual para o processo do WebSphere Application Server, então, a autenticação de Ligações JMS do WebSphere MQ emite o erro MQJMS2013 autenticação de segurança inválida fornecida para MQQueueManager.
    • Não especifique credenciais de segurança. Na Fábrica de Conexões do WebSphere MQ, verifique se as propriedades do Alias de Autenticação Gerenciado pelo Componente e do Alias de Autenticação Gerenciado pelo Contêiner não estão definidas.

Gerenciador de Filas
O nome do gerenciador de filas do WebSphere MQ para esta fábrica de conexões. Conexões criadas por essa fábrica de conexões para esse gerenciador de filas.
Tipo de Dados String
Padrão Nulo
Intervalo Um nome válido de gerenciador de filas do WebSphere MQ com 1 a 48 caracteres ASCII
Host
O nome do host no qual o gerenciador de filas do WebSphere MQ é executado, apenas para conexão de cliente.
Tipo de Dados String
Padrão Nulo
Intervalo Um nome do host de TCP/IP válido
Porta
O número da porta TCP/IP utilizada para conexão com o gerenciador de filas do WebSphere MQ, apenas para conexão de cliente.

Essa porta deve ser configurada no gerenciador de filas do WebSphere MQ.

Tipo de Dados Inteiro
Padrão Nulo
Intervalo Um número de porta TCP/IP válido configurado no gerenciador de filas do WebSphere MQ.
Canal
O nome do canal utilizado para conexão com o gerenciador de filas do WebSphere MQ, apenas para conexão de cliente.
Tipo de Dados String
Padrão Nulo
Intervalo 1 a 20 caracteres ASCII
Tipo de Transporte
Especifica se a conexão do cliente WebSphere MQ ou ligações JNI são utilizadas para conexão com o gerenciador de filas do WebSphere MQ. O provedor JMS externo controla os protocolos de comunicação entre os clientes e os servidores JMS. Ajuste o tipo de transporte quando estiver utilizando sistema de mensagens não-ASF, não-persistente, não-durável, não-transacional ou quando quiser atender a questões de segurança e o cliente for local para o nó do gerenciador de filas.
Tipo de Dados Enum
Unidades Não aplicável
Padrão BINDINGS
Intervalo
BINDINGS
As ligações JNI são utilizadas para conectar com o gerenciador de filas. BINDINGS é um protocolo de memória compartilhada e pode ser utilizado somente quando o gerenciador de filas estiver no mesmo nó que o cliente JMS e estiver com algum risco de segurança que deva ser abordado através da utilização de funções EJB.
CLIENT
A conexão do cliente WebSphere MQ é utilizada para conectar ao gerenciador de filas. CLIENT é um protocolo típico baseado em TCP.
Recomendado BINDINGS é mais rápido 30% ou mais, mas perde na segurança. Quando houver preocupação com a segurança, BINDINGS é mais desejável do que CLIENT.
Definição de Fila de Modelo
O nome da definição da fila de modelo que pode ser utilizado pelo gerenciador de filas para criar filas temporárias, se um pedido de fila ainda não existir.
Tipo de Dados String
Padrão Nulo
Intervalo 1 a 48 caracteres ASCII
ID do Cliente
O identificador do cliente JMS utilizado para conexões com o gerenciador de filas do WebSphere MQ.
Tipo de Dados String
Padrão Nulo
CCSID
O identificador do conjunto de caracteres codificado para ser utilizado com o gerenciador de filas do WebSphere MQ.

Este CCSID (coded character set identifier) deve ser um dos CCSIDs suportados pelo WebSphere MQ.

Tipo de Dados String
Unidades Inteiro
Padrão Nulo
Intervalo 1 a 65535

Para obter informações adicionais sobre CCSIDs suportados e sobre a conversão de dados de mensagens de um conjunto de caracteres codificados para outro, consulte os manuais WebSphere MQ System Administration e WebSphere MQ Application Programming Reference. Eles estão disponíveis nas páginas da Web de manuais multiplataforma e de plataforma específica do sistema de mensagens do WebSphere MQ O destino pode ser acessado apenas quando este tópico está ligado à World Wide Web   http://www-3.ibm.com/software/ts/mqseries/library/manualsa/manuals/platspecific.html , O destino pode ser acessado apenas quando este tópico está ligado à World Wide Web   IBM Publications Center ou no kit do conjunto do WebSphere MQ, SK2T-0730.

Retenção de Mensagens
Selecione essa caixa de opções para especificar que mensagens indesejadas devem ser deixadas na fila. Caso contrário, as mensagens não desejadas são tratadas de acordo com suas opções de disposição.
Tipo de Dados Enum
Unidades Não aplicável
Padrão Não selecionada
Intervalo
Selecionadas
Mensagens não desejadas são deixadas na fila.
Não selecionada
Mensagens não desejadas são tratadas de acordo com suas opções de disposição.
Ativado para XA
Especifica se a fábrica de conexões é para uma coordenação de mensagens XA ou não-XA e controla se o servidor de aplicativos utiliza XA QCF/TCF. Ative XA se vários recursos não forem utilizados na mesma transação.

Se essa propriedade for definida como NON_XA, a sessão JMS ainda estará inscrita em uma transação, mas utilizará as chamadas de transações locais do gerenciador de recursos (session.commit e session.rollback) em vez de chamadas XA. Isso pode levar a uma melhoria de desempenho. No entanto, isso significa que apenas um recurso pode ser inscrito em uma transação no WebSphere Application Server.

[Version 5.1 and later]No WBI Server Foundation, o suporte ao último participante permite alistar um recurso não XA com outros recursos com capacidade XA.

Tipo de Dados Enum
Unidades Não aplicável
Padrão Ativado para XA
Intervalo
XA
A fábrica de conexões é para a coordenação XA das mensagens
NON_XA
A fábrica de conexões é para a coordenação não-XA das mensagens
Recomendado Não ative XA quando a fila de mensagens recebidas for o único recurso na transação. Ative XA quando outros recursos, incluindo outras filas ou tópicos, estiverem envolvidos.
Conjunto de Conexões
Especifica um conjunto opcional de definições do conjunto de conexões.

As propriedades do conjunto de conexões são comuns a todos os conectores J2C.

O servidor de aplicativos une as conexões e as sessões em conjuntos com o provedor JMS para melhorar o desempenho. Isso é independente de qualquer conjunto de conexões do WebSphere MQ. É necessário configurar as propriedades do conjunto de conexões e sessões corretamente para os aplicativos, caso contrário, você pode não obter o comportamento desejado da conexão e da sessão.

Altere o tamanho do conjunto de conexões se o acesso simultâneo do lado do servidor ao recurso JMS exceder o valor padrão. O tamanho do conjunto de conexões é definido por fila ou por tópico.

Conjunto de Sessões
Um conjunto opcional de definições do conjunto de sessões.

Esse link fornece um painel de propriedades opcionais do conjunto de conexões, comum para todos os conectores J2C.

O servidor de aplicativos une as conexões e as sessões em conjuntos com o provedor JMS para melhorar o desempenho. Isso é independente de qualquer conjunto de conexões do WebSphere MQ. É necessário configurar as propriedades do conjunto de conexões e sessões corretamente para os aplicativos, caso contrário, você pode não obter o comportamento desejado da conexão e da sessão.

Propriedades Personalizadas
Um conjunto opcional de pares nome-valor para propriedades personalizadas transmitidas para o WebSphere MQ.

A página de propriedades personalizadas pode ser utilizada para definir as seguintes propriedades SSL (Secure Sockets Layer) do WebSphere MQ. Essas propriedades são válidas somente se a propriedade Tipo de transporte=CLIENT for definida.

Para obter informações adicionais sobre como definir essas propriedades, consulte a seção SSL Properties no manual WebSphere MQ Using Java.

Informações relacionadas

Propriedades Personalizadas da Fábrica de Conexões de Filas do WebSphere MQ