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