El subárbol de datos de destino forma parte del subárbol de destino que forma parte del árbol de entorno local. Los árboles de entorno local los crean los nodos de entrada cuando reciben un mensaje y, opcionalmente los nodos Compute. Cuando se crean están vacíos pero puede crear datos en los mismos utilizando las sentencias ESQL codificadas de cualquiera de los nodos SQL.
El subárbol de destino consta de subárboles de cero o más protocolos, por ejemplo WebSphere MQ y WebSphere MQ Everyplace y/o un subárbol para destinos de direccionamiento (RouterList).
El árbol de protocolos tiene dos elementos hijo:
El apartado Estructura del árbol de Entorno local incluye una imagen de un árbol típico, que muestra un árbol de destino (Destination) que tiene ambos subárboles de protocolo y RouterList.
La estructura de los datos en la carpeta DestinationData es la misma que en Defaults para el mismo protocolo y se puede utilizar para alterar temporalmente los valores por omisión en Defaults. Por consiguiente, puede configurar Defaults para que contenga valores que sean comunes a todos los destinos y establecer sólo los valores exclusivos en cada subárbol DestinationData. Si un valor no se establece en DestinationData ni en Defaults, se utiliza el valor que ha establecido para la propiedad de nodo correspondiente.
En la tabla siguiente se muestran los campos, el tipo de datos y los valores válidos para cada elemento de los subárboles Defaults y DestinationData para WebSphere MQ . Nodo MQOutput describen las propiedades de nodo correspondientes.
Consulte el apartado Acceder al árbol LocalEnvironment para obtener más información sobre la utilización de DestinationData.
Tipo de datos del elemento | Representado como | Propiedad de nodo correspondiente | Valores válidos |
---|---|---|---|
queueManagerName | CHARACTER | Nombre del gestor de colas | |
queueName | CHARACTER | Nombre de cola | |
transactionMode | CHARACTER | Modalidad de transacción | no, sí, automático |
persistenceMode | CHARACTER | Modalidad de persistencia | no, sí, automático, asQdef |
newMsgId | CHARACTER | Nuevo ID de mensaje | no, sí |
newCorrelId | CHARACTER | Nuevo ID correlación | no, sí |
segmentationAllowed | CHARACTER | Segmentación permitida | no, sí |
alternateUserAuthority | CHARACTER | Autorización de usuario alternativo | no, sí |
replyToQMgr | CHARACTER | Gestor de cola de respuestas | |
replyToQ | CHARACTER | Cola de respuestas |
Cuando crea estos campos en la carpeta DestinationData, debe entrar el tipo de datos y el valor tal y como se muestra en la tabla. Si se utiliza cualquier variación ortográfica o de mayúsculas o minúsculas, se ignoran estos campos o valores en los registros de DestinationData y se utiliza el siguiente valor disponible.
Por ejemplo, los siguientes ejemplos ESQL pueden dar como resultado una salida imprevista:
SET OutputLocalEnvironment.Destination.MQ.DestinationData[1].persistenceMode = 'YES';
SET OutputLocalEnvironment.Destination.MQ.DestinationData[2].PersistenceMode = 'yes';
En cada caso, es posible que la carpeta DestinationData no escriba un mensaje permanente para estos destinos. En el primer ejemplo, se ha dado al campo persistenceMode un valor de "YES", que no es uno de los valores válidos listados en la tabla anterior y se ignora este valor. En el segundo ejemplo, el campo "PersistenceMode" se ha especificado incorrectamente y se ignora. Se utilizarán tanto el valor persistenceMode de la carpeta Defaults como el valor del atributo asociado del nodo MQOutput. Si eso hace que se utilice un valor "no" o un valor "automático", no se grabará un mensaje permanente.
Si la carpeta DestinationData genera salida imprevista, debe comprobar si ha utilizado las mayúsculas y minúsculas correctas y la misma ortografía para lo campos y valores.