Definições de fábrica de conexão de tópicos do WebSphere

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

Uma fábrica de conexões de tópicos é utilizada para criar conexões JMS para destinos de tópicos. A fábrica de conexão de tópicos é criada pelo provedor JMS associado. Uma fábrica de conexões de tópicos do provedor JMS incorporado ao WebSphere possui as seguintes propriedades.

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

Nome de JNDI
O nome de JNDI utilizado para ligar a fábrica de conexões de tópicos 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

Guia Configuração

Escopo
Especifique o nível no qual esta definição de recurso é visível -- célula, nó ou nível de servidor.

Recursos como Provedores JMS, ligações de Espaço de nomes ou bibliotecas compartilhadas podem ser definidos em vários escopos, com os recursos definidos em escopos mais específicos, substituindo duplicatas definidas em escopos mais gerais.

Observe que independentemente do escopo de um recurso definido, as propriedades do recurso aplicam-se apenas a um nível de servidor individual. Por exemplo, se o escopo de uma origem de dados for definido no nível Célula, todos os usuários daquela Célula poderão consultar e utilizar a origem de dados, que é exclusiva naquela Célula. Entretanto, as definições de propriedade de recursos são locais para cada servidor na Célula. Por exemplo, se você definir Máximo de Conexões para 10, então cada servidor naquela Célula poderá ter 10 conexões.

Célula
O escopo mais geral. Os recursos definidos no escopo Célula são visíveis a partir de todos os Nós e servidores, a menos que sejam substituídos. Para exibir recursos definidos no escopo célula, não especifique um nome de servidor ou nó no formulário de seleção de escopo.
O escopo padrão para a maioria dos tipos de recursos. Os recursos definidos no escopo Nó substituem todas as duplicatas definidas no escopo Célula e ficam visíveis para todos os servidores no mesmo nó, a menos que sejam substituídos em um escopo do servidor naquele nó. Para exibir recursos definidos no escopo nó, não especifique um servidor, mas selecione um nome de nó no formulário de seleção de escopo.
Servidor
O escopo mais específico para definir recursos. Os recursos definidos no escopo Servidor substituem todas as definições de recurso em duplicata definidas no escopo Célula ou escopo Nó pai e ficam visíveis somente para um servidor específico. Para exibir recursos definidos em um escopo de servidor, especifique um nome do servidor bem como um nome de nó no formulário de seleção de escopo.

Quando os recursos forem criados, eles serão sempre criados no escopo atual selecionado no painel. Para exibir recursos em outros escopos, especifique um nó ou servidor diferente no formulário de seleção de escopo.

Tipo de Dados String
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
Padrão Nulo
Descrição
Uma descrição da fábrica de conexões de tópicos, 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 de tópicos para seus registros administrativos do IBM WebSphere Application Server.
Tipo de Dados String
O nome do nó administrativo do WebSphere no qual o servidor JMS é executado para esta fábrica de conexões. As conexões criadas por essa fábrica conectam-se a esse servidor JMS.
Tipo de Dados Enum
Padrão Nulo
Intervalo Uma lista pull-down de nós no domínio administrativo do WebSphere.
Porta
Qual das duas portas as conexões utilizam para conexão ao Servidor JMS. A porta QUEUED é para suporte de publicação/assinatura do JMS de função completa, a porta DIRECT é apenas para assinaturas não persistentes, não transacionais e não duráveis.

Nota: Os beans orientados por mensagens não podem utilizar a porta direta do atendente para suporte a publicação/assinatura. Portanto, qualquer fábrica de conexões de tópicos configurada com Porta definida para Direct não pode ser utilizada com beans orientados por mensagens.

Tipo de Dados Enum
Unidades Não aplicável
Padrão QUEUED
Intervalo
QUEUED
A porta atendente utilizada para suporte de publicação/assinatura compatível com JMS de função completa.
DIRECT
A porta atendente utilizada para conexão TCP/IP direta (somente assinaturas não-transacionais, não-persistentes e não-duráveis) para suporte de publicação/assinatura.

Os números da porta TCP/IP dessas portas são definidos no servidor JMS interno do WebSphere.

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: 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.

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: 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.

Alias de Configuração do Mapeamento
Permite aos usuários selecionar a partir da lista Segurança > Configuração JAAS > Configuração de Logins de Aplicativos.

A configuração JAAS de DefaultPrincipalMapping mapeia o alias de autenticação para o ID do usuário e a senha. Você pode definir e utilizar outras configurações de mapeamento.Para obter informações adicionais sobre as configurações de mapeamento, consulte Definições de Entrada da Configuração do Java Authentication and Authorization Service.

Tipo de Dados Lista de seleção
Suporte de Clone
Selecione essa caixa de opções para ativar o suporte a clone para permitir a mesma assinatura durável pelos clones de tópicos.
Tipo de Dados Enum
Padrão Não selecionada
Intervalo
Selecionadas
O suporte a clone está ativado.
Não selecionada
O suporte a clone está desativado.

Se essa propriedade for selecionada, um valor também deverá ser especificado para a propriedade ID do Cliente.

ID do Cliente
O identificador do cliente JMS utilizado para conexões ao gerenciador de filas.
Tipo de Dados String
Intervalo Um ID de cliente JMS válido
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 você limpar essa propriedade de caixa de opções (para coordenação não-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.

Para uma Fábrica de Conexões de Tópicos do WebSphere com a propriedade Port definida como DIRECT, essa propriedade não se aplica e sempre adota coordenação não-XA.

Tipo de Dados Caixa de opção
Padrão Selecionada (ativada para coordenação XA)
Intervalo
Selecionadas
A fábrica de conexões está ativada para a coordenação XA de mensagens
Não selecionada
A fábrica de conexões não está ativada para a coordenação XA de mensagens
Recomendado Não ative a coordenação XA quando a fila de mensagens ou o tópico recebido for o único recurso na transação. Ative a coordenação XA quando outros recursos, inclusive 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. É 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 é defino numa base por fila ou por tópico. Consulte a tabela a seguir para obter detalhes.

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. É 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.

Informações relacionadas

Botões do console administrativo
Definições de escopos do console administrativo
Definições do conjunto de conexões
Definições de Conjunto da Sessão
Definições de entradas de dados de autenticação do Java 2