Propriedades do Destino

É possível visualizar e configurar propriedades de destino no diálogo Propriedades de destino. As propriedades que estão disponíveis no diálogo dependem do tipo de destino.

As tabelas a seguir listam todas as propriedades que podem ser configuradas para os destinos:

Para cada propriedade, há uma descrição resumida de quando pode ser necessário configurá-la. As tabelas também fornecem os nomes longo e abreviado equivalentes a serem usados na ferramenta da linha de comandos de Administração JMS. As propriedades disponíveis no diálogo Propriedades dependem do tipo de destino; os destinos de filas possuem algumas propriedades diferentes dos destinos de tópicos. Para obter mais informações, consulte Configurando objetos JMS usando a ferramenta de administração na IBM® Knowledge Center.

Página Geral

A tabela a seguir lista as propriedades que podem ser configuradas na página Geral do diálogo de propriedades Destino.

Tabela 1. . Propriedades da página Geral
Propriedade Significado Nome longo Nome abreviado
Nome Mostra o nome do objeto. NAME  
Descrição Digite uma descrição do objeto. DESCRIPTION DESC
Nome da classe Mostra o nome da classe implementado pelo destino.    
Provedor de sistemas de mensagens Mostra o transporte que é suportado pelo objeto de destino e pode ser IBM MQ ou transporte em tempo real. O transporte em tempo real não está disponível no IBM MQ 8.0. Se estiver usando o IBM MQ 8.0, você poderá definir o transporte em tempo real, mas ele falha quando é feita uma tentativa para criar uma conexão.    
Gerenciador de filas Selecione ou digite o nome do gerenciador de filas que hospeda a fila de destino. QMANAGER QMGR
Fila Selecione o nome da fila representada pelo destino. QUEUE QU
Tópico Digite o nome do tópico representado pelo destino. TOPIC TOP

Página Manipulação de Mensagens

A tabela a seguir lista as propriedades que podem ser configuradas na página Manipulação de Mensagens do diálogo de propriedades Destino. Edite as propriedades na página Manipulação de Mensagens para configurar o que acontecerá às mensagens enviadas ao destino.

Tabela 2. . Propriedades da página Manipulação de Mensagem
Propriedade Significado Nome longo Nome abreviado
Expiração Especifique o período após o qual as mensagens no destino expirarão. Para especificar que a expiração pode ser definida pelo aplicativo cliente JMS, clique em Aplicativo. Para especificar que não ocorrerá expiração, clique em Ilimitado. Caso contrário, digite o número de milissegundos antes da expiração da mensagem. EXPIRY EXP
Persistência Especifique a persistência de mensagens que são enviadas ao destino. Para especificar que a persistência seja definida pelo aplicativo JMS, clique em Aplicativo. Para especificar que a persistência utilize o valor do padrão da fila, clique em Padrão da fila. Para especificar que as mensagens sejam persistentes, clique em Persistente. Para especificar que as mensagens não sejam persistentes, clique em Não persistente. Para especificar que as mensagens não persistentes na fila não sejam descartadas quando o gerenciador de filas reiniciar depois de um encerramento com quiesce ou imediato, clique em Alto (as mensagens não persistentes poderão ser descartadas, no entanto, depois de um encerramento preemptivo ou de uma falha). PERSISTENCE PER
Prioridade Especifique a prioridade de mensagens que são enviadas ao destino. Para especificar que a prioridade seja definida pelo aplicativo cliente JMS, clique em Aplicativo. Para especificar que a prioridade utilize o valor do padrão da fila, clique em Padrão da fila. Caso contrário, digite a prioridade, de 0 a 9. PRIORITY PRI
Contexto da Mensagem do MQMD Especifique o contexto ao enviar mensagens para um destino. Há três opções para escolha:

Padrão: A chamada de API MQOPEN e a estrutura MQPMO não especificam nenhuma opção de contexto de mensagem explícita. Esse é o valor padrão.

Configurar Todos os Contextos: A chamada de API do MQOPEN especifica a opção de contexto de mensagem MQOO_SET_ALL_CONTEXT e a estrutura MQPMO especifica MQPMO_SET_ALL_CONTEXT.

Configurar Contexto de Identidade: A chamada de API do MQOPEN especifica a opção de contexto de mensagem MQOO_SET_IDENTITY_CONTEXT e a estrutura MQPMO especifica MQPMO_SET_IDENTITY_CONTEXT.

MDMSGCTX MDCTX
Gravação de MQMD Ativada Especifique se um aplicativo JMS pode definir os valores dos campos MQMD. Há duas opções para escolha:

Não: Todas as propriedades JMS_IBM_MQMD* são ignoradas e seus valores não são copiados para a estrutura MQMD subjacente. Esse é o valor padrão.

Sim: Todas as propriedades JMS_IBM_MQMD* são processadas. Seus valores são copiados para a estrutura MQMD subjacente.
MDWRITE MDW
Leitura de MQMD Ativada Especifique se um aplicativo JMS pode extrair os valores dos campos MQMD. Há duas opções para escolha:

Não: Ao enviar mensagens, as propriedades JMS_IBM_MQMD* em uma mensagem enviada não são atualizadas para refletir os valores de campos atualizados no MQMD. Ao receber mensagens, nenhuma das propriedades JMS_IBM_MQMD* está disponível em uma mensagem recebida, mesmo que o emissor tenha configurado algumas ou todas elas. Esse é o valor padrão.

Sim: Ao enviar mensagens, todas as propriedades JMS_IBM_MQMD* em uma mensagem enviada são atualizadas para refletir os valores de campos atualizados no MQMD, incluindo as propriedades que o emissor não configurou explicitamente. Ao receber mensagens, todas as propriedades JMS_IBM_MQMD* estão disponíveis em uma mensagem recebida, incluindo as propriedades que o emissor não configurou explicitamente.
MDREAD MDR
Corpo da Mensagem Especifique se um aplicativo JMS processa o MQRFH2 de uma mensagem do IBM MQ como parte do corpo da mensagem JMS. Há três opções para escolha:

Não Especificado: Ao enviar mensagens; as classes do IBM MQ para JMS geram e incluem, ou não, um cabeçalho MQRFH2, dependendo do valor de WMQ_TARGET_CLIENT. Ao receber mensagens, ele atua como se o valor estivesse configurado como JMS. Esse é o valor padrão.

JMS: ao enviar mensagens; as classes do IBM MQ para o JMS geram automaticamente um cabeçalho MQRFH2 e o incluem na mensagem do IBM MQ. Ao receber mensagens; as classes do IBM MQ para JMS configuram as propriedades de mensagens JMS de acordo com os valores no MQRFH2 (se presente); ele não apresenta o MQRFH2 como parte do corpo da mensagem JMS.

MQ: ao enviar mensagens; as classes do IBM MQ para JMS não geram um MQRFH2. Ao receber mensagens; as classes do IBM MQ para JMS apresentam o MQRFH2 como parte do corpo da mensagem JMS.

MSGBODY MBODY
Receber Conversão Configura o uso da opção MQGMO_CONVERT. Ao solicitar mensagens, seleciona se a conversão deve ser executada no gerenciador de filas especificando MQGMO_CONVERT no MQGET ou no aplicativo cliente. RECEIVECONVERSION RCNV
Receber CCSID Solicitado CCSID para converter a mensagem. Usado quando as classes para JMS do IBM MQ estão solicitando que o gerenciador de filas execute a conversão (por exemplo, especificando WMQ_RECEIVE_CONVERSION_QMGR como o argumento para setReceiveConversion). O valor desta propriedade é o CCSID no qual foi solicitado que o gerenciador de filas converta a mensagem. O valor padrão é CCSID 1208. RECEIVECCSID RCCS

Página Intermediário

A tabela a seguir lista as propriedades que podem ser configuradas na página Intermediário do diálogo de propriedades Destino. Edite as propriedades na página Intermediário para fornecer detalhes do intermediário de publicação/assinatura.

Tabela 3. . Propriedades da página Broker
Propriedade Significado Nome longo Nome abreviado
Fila de assinatura durável do intermediário Essa propriedade pode ser usada em um cliente JMS do IBM WebSphere MQ 7.0 ou mais recente, mas não tem efeito em um gerenciador de filas do IBM WebSphere MQ 7.0 ou mais recente.

Se o gerenciador de filas ao qual o cliente JMS está sendo conectado for o mesmo utilizado pelo intermediário de publicação/assinatura, você poderá selecionar uma fila no gerenciador de filas do intermediário. O gerenciador de filas selecionado deverá estar em execução.

Se este não for o caso, digite o nome da fila a partir da qual as mensagens de assinatura durável são recuperadas. A fila padrão é SYSTEM.JMS.D.SUBSCRIBER.QUEUE.
BROKERDURSUBQ BDSUB
Fila de mensagens de assinatura durável CC do intermediário Essa propriedade pode ser usada em um cliente JMS do IBM WebSphere MQ 7.0 ou mais recente, mas não tem efeito em um gerenciador de filas do IBM WebSphere MQ 7.0 ou mais recente

Se o gerenciador de filas ao qual o cliente JMS está sendo conectado for o mesmo utilizado pelo intermediário de publicação/assinatura, você poderá selecionar uma fila no gerenciador de filas do intermediário. O gerenciador de filas selecionado deverá estar em execução.

Se este não for o caso, digite o nome da fila a partir da qual as mensagens de assinatura durável são recuperadas para um ConnectionConsumer. A fila padrão é SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE.
BROKERCCDURSUBQ CCDSUB
Fluxo de publicações Essa propriedade pode ser usada em um cliente JMS do IBM WebSphere MQ 7.0 ou mais recente, mas não tem efeito em um gerenciador de filas do IBM WebSphere MQ 7.0 ou mais recente.

Selecione ou digite o nome da fila para a qual as mensagens publicadas são enviadas (a fila de fluxo). A fila padrão é SYSTEM.BROKER.DEFAULT.STREAM. Para usar Selecionar para inserir o nome, você já deverá ter selecionado um valor para a propriedade Gerenciador de Filas de Publicação do Intermediário e o gerenciador de filas selecionado deve estar em execução.

BROKERPUBQ BPUB
Gerenciador de filas de publicação do intermediário Selecione ou digite o nome do gerenciador de filas que possui a fila para a qual as mensagens publicadas no tópico são enviadas. BROKERPUBQMGR BPQM
Versão do intermediário Essa propriedade pode ser usada em um cliente JMS do IBM WebSphere MQ 7.0 ou mais recente, mas não tem efeito em um gerenciador de filas do IBM WebSphere MQ 7.0 ou mais recente.

Selecione a versão do intermediário que está sendo utilizada. Clique em V1 para usar um broker de publicação/assinatura do IBM MQ ou o IBM Integration Bus no modo de compatibilidade. Este será o valor padrão se a propriedade Transport estiver configurada para Bindings ou Client. Clique em V2 para usar um broker do IBM Integration Bus no modo nativo; esse será o valor padrão se a propriedade Transporte for configurada como Direto ou DirectHTTP.

BROKERVER BVER

Página Produtores

A tabela a seguir lista as propriedades que podem ser configuradas na página Produtores do diálogo de propriedades Destino. Edite as propriedades na página Produtores para alterar outras propriedades do objeto de destino.

Tabela 4. . Propriedades da página Produtores
Propriedade Significado Nome longo Nome abreviado
Permitir colocações assíncronas Especifique se os produtores de mensagens terão permissão para utilizar colocações assíncronas para enviar mensagens para este destino. Para determinar se os produtores de mensagens terão permissão ao consultar a definição da fila ou do tópico, clique em Como destino (padrão). Para permitir colocações assíncronas, clique em Ativado; para rejeitar colocações assíncronas, clique em Desativado. PUTASYNCALLOWED PAA

Página Consumidores

A tabela a seguir lista as propriedades que podem ser configuradas na página Consumidores do diálogo de propriedades Destino. Edite as propriedades na página Consumidores para alterar outras propriedades do objeto de destino.

Tabela 5. . Propriedades da página Consumidores
Propriedade Significado Nome longo Nome abreviado
Permitir leitura antecipada Especifique se os consumidores de mensagens e os navegadores de filas terão permissão para utilizar a leitura antecipada para obter mensagens não persistentes desse destino em um buffer do cliente antes de recebê-las. Para determinar se a leitura antecipada terá permissão ao consultar a definição da fila ou do tópico, clique em Como destino (padrão). Para permitir leituras antecipadas, clique em Ativado; para rejeitar leituras antecipadas, clique em Desativado. READAHEADALLOWED RAA
Política de fechamento de leitura antecipada Para mensagens entregues a um listener de mensagens assíncronas, especifique o que deve acontecer às mensagens na fila proxy do cliente quando o consumidor de mensagens for fechado. Para especificar que todas as mensagens na fila proxy do cliente sejam entregues ao MessageListener do aplicativo antes de retornar, clique em Entregar todas (padrão). Para especificar que a chamada MessageListener atual seja concluída somente antes de retornar, deixando que outras mensagens na fila proxy do cliente sejam descartadas, clique em Entregar atual. READAHEADCLOSEPOLICY RACP
Formato de curinga Especifique qual versão da sintaxe de curinga será utilizada.

Clique em Somente curingas para utilizar apenas curingas (para consistência com aplicativos que utilizavam anteriormente o Broker Versão 1; consulte a propriedade da versão do intermediário).

Clique em Somente curingas de tópico para utilizar apenas curingas no nível de tópico, utilizados no Broker Versão 2.
WILDCARDFORMAT WCFMT

Página Estendido

A tabela a seguir lista as propriedades que podem ser configuradas na página Estendido do diálogo de propriedades Destino. Edite as propriedades na página Estendido para alterar outras propriedades do objeto de destino.

Tabela 6. . Propriedades da página Estendido
Propriedade Significado Nome longo Nome abreviado
ID do conjunto de caracteres codificados Digite o CCSID (ID do conjunto de caracteres codificados) a ser utilizado nos destinos. CCSID CCS
Codificação Selecione o esquema de codificação utilizado para este destino. Para obter mais informações, consulte Configurando objetos JMS usando a ferramenta de administração na IBM Knowledge Center. ENCODING ENC
Falha se ocorrer quiesce Especifique se as chamadas a determinados métodos falharão se o gerenciador de filas estiver em um estado de quiesce. Para especificar que as chamadas a determinados métodos falhem se o gerenciador de filas estiver em um estado de quiesce, clique em Sim. Isso significa que, se um aplicativo detectar que o gerenciador de filas está em estado de quiesce, ele poderá concluir sua tarefa imediata e fechar a conexão, permitindo a parada do gerenciador de filas. Para especificar que nenhuma chamada de método falhará por causa do estado de quiesce do gerenciador de filas, clique em Não. Isso significa que um aplicativo não poderá detectar que o gerenciador de filas está em estado de quiesce, portanto, ele poderá continuar a executar operações no gerenciador de filas e, assim, evitar sua parada. FAILIFQUIESCE FIQ
Multicast Especifique se as mensagens são entregues a consumidores de mensagens que estão usando o transporte multicast. O transporte multicast é aplicável somente a destinos de tópico e pode ser utilizado apenas quando o connection factory utiliza o transporte IP Direto. O transporte IP direto não está disponível no IBM MQ 8.0. Se estiver usando o IBM MQ 8.0, você poderá definir o transporte IP Direto, mas ele falha quando é feita uma tentativa para criar uma conexão.

O valor padrão é Como Connection Factory, o que significa que o valor da propriedade Multicast do connection factory será utilizado.

Clique em Ativado para entregar mensagens ao consumidor de mensagens que está usando o transporte multicast. O tópico deve ser configurado para multicast confiável no intermediário; uma qualidade de serviço confiável será utilizada se o tópico estiver configurado para multicast confiável.

MULTICAST MCAST
Multicast (continuado)

Clique em Confiável para entregar mensagens ao consumidor de mensagens que está usando o transporte multicast com uma qualidade de serviço confiável. O tópico deve ser configurado para multicast confiável no intermediário; se não estiver configurado assim, não será possível criar um consumidor de mensagens para o tópico.

Clique em Não confiável para entregar mensagens ao consumidor de mensagens que está usando o transporte multicast, mas sem usar uma qualidade de serviço confiável. O tópico deve ser configurado para multicast no intermediário; uma qualidade de serviço confiável não será utilizada, mesmo se o tópico estiver configurado para multicast confiável.
MULTICAST MCAST
Cliente de destino

Clique em JMS para especificar que o destino da mensagem é um aplicativo JMS.

Clique em MQ para especificar que o destino da mensagem é um aplicativo IBM MQ não JMS.

TARGCLIENT TC
Estilo de destino ReplyTo

Especifique o formato do campo JMSReplyTo.

Clique em Padrão para usar o valor padrão. O valor padrão é equivalente às informações no RFH2, a menos que a propriedade de sistema JVM tenha sido configurada.

Clique em MQMD para usar o valor fornecido no MQMD. Isso preencherá o campo de gerenciador de filas com o valor do MQMD.

Clique em RFH2 para usar o valor fornecido no cabeçalho RFH2. Se o aplicativo de envio configurou um valor JMSReplyTo, esse valor será usado.

REPLYTOSTYLE RTOST
Receber Conversão Configura o uso da opção MQGMO_CONVERT. Ao solicitar mensagens, seleciona se a conversão deve ser executada no gerenciador de filas especificando MQGMO_CONVERT no MQGET ou no aplicativo cliente. RECEIVECONVERSION RCNV
Receber CCSID CCSID solicitado para converter a mensagem para Usado quando as classes para JMS do IBM MQ estão solicitando que o gerenciador de filas execute a conversão (por exemplo, especificando WMQ_RECEIVE_CONVERSION_QMGR como o argumento para setReceiveConversion). O valor desta propriedade é o CCSID no qual foi solicitado que o gerenciador de filas converta a mensagem. O valor padrão é CCSID 1208. RECEIVECCSID RCCS