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 em IBM® Documentation.
Página Geral
A tabela a seguir lista as propriedades que podem ser configuradas na página Geral do diálogo de propriedades Destino.
Propriedade | Significado | Nome longo | Nome abreviado |
---|---|---|---|
Nome | Mostra o nome do objeto. | NAME | |
Descrição | Digite uma descrição do objeto. | DESCRIÇÃO | DESC |
Nome da Classe | Mostra o nome da classe implementado pelo destino. | ||
Fornecedor de Sistema de Mensagens | Isso mostra o transporte que é suportado pelo objeto de destino e pode ser de IBM MQ ou transporte Real-time. O transporte em tempo real não está disponível em IBM MQ 8.0. Se você estiver usando IBM MQ 8.0 você pode definir o transporte Real-time, mas ele falha quando uma tentativa é feita 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. | FILA | QU |
Tópico | Digite o nome do tópico representado pelo destino. | t¢pico | 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.
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 |
Persistence | 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 |
Priority | 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 do MQMD Permitida | 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 serão copiados para a estrutura do MQMD subjacente. |
MDWRITE | MDW |
Leitura do MQMD Permitida | 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; IBM MQ classes para JMS o faz ou não gera e inclui 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; IBM MQ as classes para JMS geram automaticamente um cabeçalho MQRFH2 e inclui-o na mensagem IBM MQ . Ao receber mensagens; IBM MQ classes para JMS configuram as propriedades da mensagem JMS de acordo com valores no MQRFH2 (se presente); ele não apresenta o MQRFH2 como parte do corpo de mensagens JMS.MQ: Ao enviar mensagens; IBM MQ as classes para JMS não geram um MQRFH2. Ao receber mensagens; IBM MQ classes para JMS apresenta o MQRFH2 como parte do corpo de mensagens 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 IBM MQ para JMS estão solicitando que o gerenciador de filas execute a conversão (por exemplo, especificando WMQ_RECEIVE_CONVERSION_QMGR como o argumento para a conversão setReceive). 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.
Propriedade | Significado | Nome longo | Nome abreviado |
---|---|---|---|
Fila de assinaturas duráveis do intermediário | 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 | 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ção | 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 Select para inserir o nome, você já deve ter selecionado um valor para a propriedade |
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 | Selecione
a versão do intermediário que está sendo utilizada. Clique em |
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.
Propriedade | Significado | Nome longo | Nome abreviado |
---|---|---|---|
Permitir entradas 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.
Propriedade | Significado | Nome longo | Nome abreviado |
---|---|---|---|
Permitir leitura antes | 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 ® |
Ler política de encerramento antes | 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 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.
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 em IBM Documentation. | 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 falhe porque o gerenciador de filas está em um estado quiesce, clique em Não. Isso significa que um aplicativo não pode detectar que o gerenciador de filas está em quiesce, assim o aplicativo pode continuar a executar operações com relação ao gerenciador de filas e, portanto, evitar que ele seja interrompido. | 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 em IBM MQ 8.0. Se você estiver usando IBM MQ 8.0 você pode definir o transporte IP Direto, mas ele falha quando uma tentativa é feita 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 não JMS IBM MQ . |
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 do 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 configurar um valor JMSReplyTo, esse valor será usado. |
REPLYTOSTYLE | RTOST |
Receber conversão | Configura 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 | O CCSID solicitado para o qual a mensagem será convertida. Usado quando as classes IBM MQ para JMS estão solicitando que o gerenciador de filas execute a conversão (por exemplo, especificando WMQ_RECEIVE_CONVERSION_QMGR como o argumento para a conversão setReceive). 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 |