Tipos de Dados para Elementos na Subárvore Dados de Destino

A subárvore DestinationData é parte da subárvore Destination no LocalEnvironment. As árvores LocalEnvironment são criadas pelos nós de entrada ao receber uma mensagem e, opcionalmente, pelos nós Compute. Após criadas, elas estão vazias, mas é possível criar dados nelas utilizando instruções ESQL, codificadas em qualquer um dos nós SQL.

A subárvore Destination consiste em subárvores para zero ou mais protocolos, por exemplo WebSphere MQ e WebSphere MQ Everyplace, ou uma subárvore para destinações de roteamento (RouterList), ou ambas.

A árvore de protocolos possui dois filhos:

Estrutura em Árvore LocalEnvironment inclui uma imagem de uma árvore típica, mostrando uma árvore Destination que possui subárvores de protocolo e RouterList.

A estrutura de dados na pasta DestinationData é a mesma da encontrada em Defaults para o mesmo protocolo e pode ser utilizada para substituir os valores padrão em Defaults. Portanto, você pode configurar Padrões para conter valores que são comuns a todos os destinos e definir apenas os valores exclusivos em cada subárvore Dados de Destino. Se um valor não estiver definido em DestinationData e nem em Defaults, será utilizado o valor definido para a propriedade do nó correspondente.

Os campos, tipo de dados e valores válidos para cada elemento das subárvores Defaults e DestinationData para WebSphere MQ são mostrados na tabela a seguir. O Nó MQOutput descrevem as propriedades do nó correspondente.

Consulte Acessando a Árvore Ambiente Local para obter informações sobre com utilizar DestinationData.

Tipo de dados do elemento Representado como Propriedade do Nó Correspondente Valores Válidos
queueManagerName CHARACTER Nome do Gerenciador de Fila  
queueName CHARACTER Nome da Fila  
transactionMode CHARACTER Modo de Transação não, sim, automático
persistenceMode CHARACTER Modo de Persistência não, sim, automático, asQdef
newMsgId CHARACTER Novo ID da Mensagem não, sim
newCorrelId CHARACTER Novo ID de Correlação não, sim
segmentationAllowed CHARACTER Segmentação Permitida não, sim
alternateUserAuthority CHARACTER Autoridade de Usuário Alternativa não, sim
replyToQMgr CHARACTER Gerenciador de Filas Responder para  
replyToQ CHARACTER Fila Responder para  

Distinção entre Maiúsculas e Minúsculas para Tipos e Valores de Dados

Ao criar esses campos na pasta DestinationData, é necessário digitar o tipo de dados e valor exatamente como mostrados na tabela. Se forem utilizadas variações de ortografia ou tipo, então, esses campos ou valores são ignorados nos registros de DestinationData e o próximo valor disponível é utilizado.

Por exemplo, as seguintes amostras ESQL podem resultar em saída inesperada:

SET
OutputLocalEnvironment.Destination.MQ.DestinationData[1].persistenceMode
= 'YES';
SET
OutputLocalEnvironment.Destination.MQ.DestinationData[2].PersistenceMode
= 'yes';

Em cada caso, a pasta DestinationData pode não gravar uma mensagem persistente para esses destinos. No primeiro exemplo, foi fornecido ao campo persistenceMode um valor de 'YES', que não é um dos valores válidos listados na tabela acima e esse valor é ignorado. No segundo exemplo, o campo denominado 'PersistenceMode' é especificado incorretamente e é ignorado. O valor de persistenceMode da pasta Defaults ou o valor do atributo associado no nó MQOutput será utilizado. Se isso fizer que um valor 'não' ou 'automático' seja utilizado, uma mensagem persistente não será gravada.

Se uma pasta DestinationData estiver produzindo saída inesperada, você deve verificar se utilizou o tipo e a ortografia corretos nos campos e valores utilizados.

Conceitos relacionados
Visão Geral de Fluxos de Mensagens
Estrutura em Árvore LocalEnvironment
Tarefas relacionadas
Criando Listas de Destino
Acessando a Árvore Ambiente Local
Referências relacionadas
Definições de Elementos para Analisadores de Mensagens
Tipos de Dados de Campos e Elementos
Tipos de Dados dos Campos nos Cabeçalhos do WebSphere MQ
Tipos de dados para elementos na subárvore de Propriedades
Tipos de Dados para Elementos em uma Mensagem MRM
Tipos de Dados para uma Mensagem Não estruturada (BLOB)
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ad09630_