A subárvore DestinationData faz parte da subárvore Destino no ambiente local. As árvores do ambiente local são criadas por nós de entrada quando eles recebem uma mensagem e, opcionalmente, pelos nós Compute. Quando criadas, as árvores estão vazias, mas é possível criar dados nelas usando instruções ESQL codificadas em qualquer um dos nós SQL.
A subárvore Destino consiste em subárvores para zero ou mais protocolos; por exemplo, WebSphere MQ e WebSphere MQ Everyplace, ou uma subárvore para destinos de roteamento (RouterList), ou ambos.
A árvore de protocolos possui dois filhos:
Estrutura em árvore do ambiente local 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 Padrões e DestinationData para o WebSphere MQ são mostrados na tabela a seguir. A Nó MQOutput descreve as propriedades do nó correspondentes.
Consulte Acessando a Árvore de 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 |
Quando você criar estes campos na pasta DestinationData, insira o tipo de dado e valor exatamente conforme mostrado na tabela. Se houver qualquer variação na ortografia ou letra for usada, estes campos ou valores serão ignorados nos registros DestinationData e o próximo valor disponível será usado.
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 estes destinos. No primeiro exemplo, o campo persistenceMode recebeu um valor igual a 'YES', que não é um dos valores válidos listados na tabela, e este valor será ignorado. No segundo exemplo, o campo denominado 'PersistenceMode' é especificado incorretamente e é ignorado. O valor de persistenceMode da pasta Padrões ou o valor do atributo associado no nó MQOutput será usado. Se este comportamento fizer com que um valor 'no' ou 'automatic' seja usado, uma mensagem persistente não será gravada.
Se uma pasta DestinationData estiver produzindo saída inesperada, verifique se você usou a letra e a ortografia corretas nos campos e valores.