Connection Factory da Fila do Provedor de Sistemas de Mensagens Padrão [Configurações]
Para visualizar esta página no console, clique em um dos seguintes caminhos:
Por padrão, conexões criadas usando este connection factory JMS nos contêineres do servidor (por exemplo, a partir de um enterprise bean) são reunidas usando o conjunto de conexões da Plataforma Java™, Enterprise Edition (Java EE) Connector Architecture (JCA). É possível modificar as configurações do conjunto de conexões para esse connection factory selecionando o link Propriedades do Conjunto de Conexões na seção Propriedades Adicionais do painel do console administrativo.
Guia Configuração
A guia Configuração mostra propriedades de configuração para esse objeto. Esses valores de propriedades são preservados, mesmo se o ambiente de tempo de execução estiver parado, em seguida, reiniciado. Consulte as descrições de tarefas do centro de informações para obter informações sobre como aplicar alterações na configuração no ambiente de tempo de execução.
Propriedades Gerais
Escopo
Especifica o nível topológico mais alto no qual os servidores de aplicativos podem utilizar este objeto de recurso.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Provedor
Especifica um provedor JMS, que ativa o sistema de mensagens assíncronas com base no JMS (Java Message Service). Ele fornece connection factories J2EE para criar conexões para destinos de fila ou tópico JMS específicos. Os objetos administrativos do provedor JMS são utilizados para gerenciar recursos de JMS do provedor JMS associado.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Nome
O nome de exibição necessário para o recurso.
Informações | Valor |
---|---|
Requerido | Sim |
Tipo de dados | Sequência de Caracteres |
Nome JNDI
O nome JNDI para o recurso.
Como convenção, utilize um nome JNDI no formato jms/Name, em que Name é o nome lógico do recurso. Para obter informações adicionais sobre o uso do JNDI e sua sintaxe, consulte o tópico de suporte ao JNDI em WebSphere Application Server.
Informações | Valor |
---|---|
Requerido | Sim |
Tipo de dados | Sequência de Caracteres |
Descrição
Uma descrição opcional para o recurso.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Área de Texto |
Categoria
Uma cadeia de categorias opcional a ser utilizada na classificação ou no agrupamento do recurso.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Nome do Barramento
Informações | Valor |
---|---|
Requerido | Sim |
Tipo de dados | Customizado |
Destino
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Tipo de destino
Isso indica o nome de um destino que será utilizado para determinar um ou mais mecanismos do sistema de mensagens para manipular o trabalho. O tipo de destino é indicado pela propriedade Tipo de destino
Conexões têm a carga equilibrada em todos os mecanismos do sistema de mensagens disponíveis que satisfaçam os critérios de seleção.
Se desejar que os aplicativos possam conectar-se a qualquer mecanismo do sistema de mensagens no barramento, não defina esta propriedade.
Para obter informações adicionais sobre o uso dessa propriedade com outras propriedades do connection factory para o gerenciamento de carga de trabalho das conexões, consulte o tópico Propriedades Administrativas das Conexões JMS para um Barramento.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Significado do Destino
Para obter informações adicionais sobre o uso dessa propriedade com outras propriedades do connection factory para o gerenciamento de carga de trabalho das conexões, consulte o tópico Propriedades Administrativas das Conexões JMS para um Barramento.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Cada de transporte de entrada de destino
Se o mecanismo do sistema de mensagens estiver no mesmo servidor que o aplicativo, será estabelecida uma conexão direta do processo interno e essa propriedade da cadeia de transporte será ignorada.
- InboundBasicMessaging
- Este é um protocolo orientado para conexão que utiliza uma conexão TCP/IP padrão (JFAP-TCP/IP). Inclui suporte para fluxos transacionais de duas fases (XA remoto), para que um produtor ou consumidor de mensagens, em execução em um sistema cliente ou servidor, possa participar de uma transação global gerenciada nesse sistema cliente ou servidor. O uso específico dos fluxos XA é para suportar o acesso a partir de um aplicativo em execução em um servidor para um mecanismo do sistema de mensagens no segundo servidor, talvez em razão do primeiro servidor não possuir um mecanismo do sistema de mensagens adequado. Se forem utilizados os fluxos de XA remoto, um coordenador de transação deverá estar disponível localmente no aplicativo.
- InboundSecureMessaging
- Este é o protocolo InboundBasicMessaging agrupado no SSL.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Terminais do Provedor
Você somente precisará modificar essa propriedade se tiver aplicativos clientes em execução fora de um servidor de aplicativos ou aplicativos em um servidor em outra célula que deseje usar esse connection factory para se conectar ao barramento de integração de serviços de destino especificado no connection factory.
Para utilizar destinos do JMS do fornecedor de sistema de mensagens padrão, um aplicativo conecta-se a um mecanismo do sistema de mensagens no barramento de integração de serviço de destino ao qual os destinos são designados. Por exemplo, uma fila JMS é designada para um destino de fila em um barramento de integração de serviço.
Os aplicativos cliente executados fora de um servidor de aplicativos, por exemplo, executados em um contêiner do cliente ou fora do ambiente do WebSphere Application Server, não conseguem localizar diretamente um mecanismo do sistema de mensagens adequado para conexão no barramento de destino. Da mesma forma, um aplicativo em execução em um servidor em uma célula para conectar-se a um barramento de destino em outra célula não pode localizar diretamente um mecanismo do sistema de mensagens para conectar-se ao barramento de destino.
Nesses cenários, os clientes (ou servidores no outro barramento) devem concluir um processo de autoinicialização por meio de um servidor de autoinicialização que é um membro do barramento de destino. Um servidor de autoinicialização é um servidor de aplicativos em execução no Serviço de SIB, mas não precisa estar executando mecanismos do sistema de mensagens. O servidor de autoinicialização seleciona um mecanismo do sistema de mensagens em execução em um servidor de aplicativos que suporte a cadeia de transporte de destino necessária. Para que o processo de auto-inicialização seja possível, você deve configurar um ou mais nós de extremidade do provedor na connection factory utilizada pelo cliente.
Um servidor de auto-inicialização utiliza uma porta específica e uma cadeia de transporte de auto-inicialização. A porta é o SIB_ENDPOINT_ADDRESS (ou SIB_ENDPOINT_SECURE_ADDRESS se a segurança estiver ativada) do mecanismo do sistema de mensagens que hospeda o terminal remoto do link. Juntamente com o nome do host, eles formam o endereço do nó de extremidade do servidor de autoinicialização.
- Se nenhuma credencial de segurança for fornecida, então, por padrão
- localhost será usado se host não for especificado
- porta 7276 será usada se port não for especificado
- cadeia de transporte de autoinicialização chamada BootstrapBasicMessaging será usada se a cadeia de canais de autoinicialização não for especificada
- Se as credenciais de segurança forem fornecidas, então, por padrão
- localhost será usado se host não for especificado
- porta 7286 será usada se port não for especificada
- cadeia de transporte de autoinicialização chamada BootstrapSecureMessaging será chamada se a cadeia de canais de autoinicialização não for especificada e se o número da porta for igual a ou maior que 7286
- cadeia de transporte de autoinicialização chamada BootstrapBasicMessaging será usada se a cadeia de canais de autoinicialização não for especificada e o número da porta estiver dentro do intervalo 7276 - 7285.
![[IBM i]](../images/iseries.gif)
Se desejar que um aplicativo use um servidor de autoinicialização com um endereço de terminal diferente, será necessário especificar o endereço de terminal necessário na propriedade Terminais do provedor dos connection factories de JMS que o aplicativo cliente usar. É possível especificar um ou mais endereços de nó de extremidade dos servidores de autoinicialização.
Os endereços de nó de extremidade para servidores de autoinicialização devem ser especificados em cada connection factory JMS que é utilizada por aplicativos fora de um servidor de aplicativos. Para não ter de especificar uma longa lista de servidores de autoinicialização, será possível fornecer alguns servidores altamente disponíveis como servidores de autoinicialização dedicados. Será necessário, então, especificar apenas uma lista curta de servidores de autoinicialização em cada connection factory.
boothost1:7278:BootstrapBasicMessaging
ou
boothost1:7278
e para uma porta 7289 segura designada ao servidor, no host boothost2, que usa a cadeia de transporte predefinida BootstrapTunneledSecureMessaging:boothost2:7289:BootstrapTunneledSecureMessaging
[ [host_name] [ ":" [port_number] [ ":" chain_name] ] ]
em que:- host_name
- É o nome do host no qual o servidor é executado. Ele pode ser um endereço IP. Para um endereço IPv6, coloque colchetes
([]) antes e depois de host_name conforme mostrado no exemplo abaixo:
. Se um valor não for especificado, o padrão será localhost.[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
Nota: Para a plataforma IBM i, você deve (ao menos) alterar o nome de host padrão de localhost para your.server.name.
- port_number
- quando especificado, é um dos seguintes endereços do mecanismo do sistema de mensagens que hospeda o terminal remoto do link:
- SIB_ENDPOINT_ADDRESS se a segurança não estiver ativada
- Para conexões seguras, SIB_ENDPOINT_SECURE_ADDRESS se a segurança estiver ativada.
Se port_number não for especificado, o padrão será 7276.
Para localizar qualquer um desses valores utilizando o console administrativo, clique em .
- chain_name
- é o nome de uma cadeia de transporte de auto-inicialização predefinida utilizada para conectar-se ao servidor de auto-inicialização. Se não estiver especificada, o padrão será BootstrapBasicMessaging.
São fornecidas as seguintes cadeias de transporte de auto-inicialização predefinidas:
- BootstrapBasicMessaging
- Corresponde à cadeia de transporte do servidor InboundBasicMessaging (JFAP-TCP/IP)
- BootstrapSecureMessaging
- Corresponde à cadeia de transporte do servidor InboundSecureMessaging (JFAP-SSL-TCP/IP)
- BootstrapTunneledMessaging
- Antes de poder utilizar essa cadeia de transporte de auto-inicialização, você deve definir uma cadeia de transporte do servidor correspondente no servidor de auto-inicialização. (Consulte ). Esta cadeia de transporte suporta JFAP e usa wrappers HTTP.
- BootstrapTunneledSecureMessaging
- Antes de poder utilizar essa cadeia de transporte de auto-inicialização, você deve definir uma cadeia de transporte do servidor correspondente no servidor de auto-inicialização. (Consulte ). Esta cadeia de transporte suporta JFAP e usa wrappers HTTP.
Especificar host_name : chain_name em vez de host_name : : chain_name (com dois pontos) é incorreto. É válido não inserir nada ou inserir qualquer um dos seguintes: "a", "a:", ":7276", "::chain" e assim por diante. O valor padrão será aplicado, se você não especificar um valor, mas dever separar os campos com ":".
boothost1:7278:BootstrapBasicMessaging,
boothost2:7289:BootstrapTunneledSecureMessaging,
[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Área de Texto |
Proximidade de Conexão
- Se um grupo de destino for especificado, conecte-se ao primeiro mecanismo do sistema de mensagens
que atenda às seguintes condições para o tipo de destino:
- Servidor Procure um mecanismo do sistema de mensagens no mesmo servidor.
- Cluster Procure um mecanismo do sistema de mensagens no mesmo servidor, em seguida, em outros servidores no mesmo cluster.
- Host Procure um mecanismo do sistema de mensagens no mesmo servidor, em seguida, em outros servidores no mesmo cluster, em seguida, em outros servidores no mesmo host.
- Barramento Procure um mecanismo do sistema de mensagens no mesmo servidor, em seguida, em outros servidores no mesmo cluster, em seguida, em outros servidores no mesmo host, em seguida, em qualquer outro mecanismo do sistema de mensagens no mesmo barramento.
- Se um grupo de destino não estiver especificado ou se um grupo de destino estiver especificado, mas
nenhum mecanismo do sistema de mensagens adequado for localizado e a importância do destino for Preferido, conecte-se com o primeiro mecanismo do sistema de mensagens
que atenda às seguintes condições para o tipo de destino:
- Servidor Procure um mecanismo do sistema de mensagens no mesmo servidor.
- Cluster A conexão falha.
- Host Procure um mecanismo do sistema de mensagens no mesmo servidor, em seguida, em outros servidores no mesmo host.
- Barramento Procure um mecanismo do sistema de mensagens no grupo de destino no mesmo servidor, em seguida, em outros servidores no mesmo host, em seguida, em qualquer outro mecanismo do sistema de mensagens no mesmo barramento.
Para obter informações adicionais sobre o uso dessa propriedade com outras propriedades do connection factory para o gerenciamento de carga de trabalho das conexões, consulte o tópico Propriedades Administrativas das Conexões JMS para um Barramento.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Confiabilidade de Mensagem Não Persistente
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Confiabilidade de Mensagem Persistente
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Leitura Antecipada
As mensagens que são designadas a um consumidor são bloqueadas no servidor e não podem ser consumidas por outros consumidores para esse destino. As mensagens que são designadas a um consumidor, mas não são consumidas antes do fechamento desse consumidor, são subseqüentemente desbloqueadas no servidor e, em seguida, disponibilizadas para recebimento por outros consumidores.
É possível substituir esta propriedade para destinos JMS individuais, definindo a propriedade Leitura Antecipada no destino JMS.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Prefixo do nome da fila temporária
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Transmitir Carga Útil da Mensagem por Referência
Quando grandes mensagens de objetos ou mensagens de bytes são enviadas, o custo no uso da memória e do processador de serialização, desserialização e cópia da carga útil da mensagem pode ser expressivo. Se você ativar as propriedades transmitir carga útil de mensagem por referência em um connection factory ou uma especificação de ativação, informará ao provedor do sistema de mensagens padrão para substituir a especificação do JMS 1.1 e reduzir ou ignorar potencialmente essa cópia de dados.
Aplicativos que utilizam essa connection factory para enviar mensagens devem obedecer as seguintes regras:
- O aplicativo não modifica o objeto de dados contido em uma mensagem de objeto JMS.
- O aplicativo preenche uma mensagem de bytes de JMS usando uma chamada simples para writeBytes(byte[]) e não modifica a matriz de bytes depois de ser configurado na mensagem.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Booleano |
Aplicativos que utilizam essa connection factory para receber mensagens devem obedecer a seguintes regra:
- O aplicativo não modifica o objeto de dados obtido a partir de uma mensagem de objeto JMS. O objeto de dados é tratado como de leitura.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Booleano |
Contextos de Transações Faltando no Log
Selecione esta propriedade para registrar conexões que estão sendo criadas sem um contexto de transação.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Booleano |
Gerenciar Manipulações Armazenadas em Cache
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Booleano |
Alias de autenticação de recuperação XA
Essa propriedade fornece uma lista dos aliases de entrada de dados de autenticação JCA que foram definidos para o WebSphere Application Server. É possível selecionar um alias de entrada de dados para ser utilizado para autenticação durante um processamento de recuperação XA.
Se você ativou a segurança para o barramento de integração de serviços associado, selecione o alias que especifica o ID do usuário e a senha usados para recuperação do XA válido no registro do usuário do WebSphere Application Server. Essa propriedade deve ser configurada se a segurança do barramento estiver ativada e as transações XA tiverem de ser utilizadas.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Alias de Configuração de Mapeamento
Especifica o alias de configuração do mapeamento para a configuração de mapeamento Java Authentication and Authorization Service (JAAS) que é usada por este connection factory.
Esse campo será utilizado apenas na ausência de um loginConfiguration na referência de recurso do componente. A especificação de uma configuração de login e propriedades associadas na referência de recursos do componente determina a estratégia de autenticação gerenciada por contêiner quando o valor res-auth for Container.Se a configuração de login DefaultPrincipalMapping estiver especificada, a propriedade associada será um alias de entrada de dados de autenticação de JAAS - J2C. Consulte a entrada de dados de autenticação de JAAS - J2C do item relacionado para definir um novo alias.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Alias de Autenticação Gerenciado por Contêiner
Esse alias especifica um ID de usuário e senha a serem usados para autenticar conexões com o provedor JMS para autenticação gerenciada pelo contêiner. Essa configuração só é usada quando o valor res-auth é contêiner e o alias de autenticação não foi configurado quando o aplicativo foi implementado.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Propriedades Adicionais
- Propriedades do conjunto de conexões
- Um conjunto opcional de configurações de conjuntos de conexões.