A árvore Properties possui seu próprio nome de correlação, Properties, e é necessário utilizá-lo em todas as instruções ESQL que fazem referência ou definem o conteúdo dessa árvore.
Os campos na árvore Properties contêm valores que definem as características da mensagem. Por exemplo, a árvore Properties contém um campo para o domínio da mensagem e campos para a codificação e CCSID em que os dados da mensagem são codificados. Para obter uma lista completa de campos nesta árvore, consulte Tipos de dados para elementos na subárvore de Propriedades.
Você pode interrogar e atualizar esses campos utilizando as instruções ESQL apropriadas. Se você criar uma nova mensagem de saída no nó Compute, deverá definir valores para as propriedades da mensagem.
Se você utilizar o nó Compute para gerar uma nova mensagem de saída, deverá definir suas propriedades na árvore Propriedades. As propriedades da mensagem de saída não precisam ser iguais às propriedades da mensagem de entrada.
Por exemplo, para definir as propriedades da mensagem de saída para uma mensagem de saída MRM, é necessário definir as seguintes propriedades:
Propriedade | Value |
---|---|
Domínio de Mensagens | MRM |
Conjunto de Mensagens | Identificador do Conjunto de Mensagens |
Tipo de Mensagem | Nome¹ da Mensagem |
Formato de Mensagem | Nome² do Formato Físico |
Este procedimento de ESQL configura propriedades da mensagem como valores transmitidos pela instrução de chamada. Você pode achar que é necessário desempenhar esta tarefa com freqüência e pode utilizar um procedimento como este em muitos nós e fluxos de mensagens diferentes. Se preferir, você pode codificar o ESQL que configura valores específicos.
CREATE PROCEDURE setMessageProperties(IN OutputRoot REFERENCE, IN setName char, IN typeName char, IN formatName char) BEGIN /**************************************************************************** * Um procedimento que configura as propriedades de mensagem ****************************************************************************/ set OutputRoot.Properties.MessageSet = setName; set OutputRoot.Properties.MessageType = typeName; set OutputRoot.Properties.MessageFormat = formatName; END;
Para configurar o domínio da mensagem de saída, é possível configurar a propriedade de mensagem ou codificar as instruções ESQL que se referem ao domínio requerido no segundo qualificador da instrução SET, o campo do analisador. Por exemplo, a instrução ESQL configura o domínio como MRM:
SET OutputRoot.MRM.Field1 = 'field1 data';
Esta instrução ESQL configura o domínio como XML:
SET OutputRoot.XML.Field1 = 'field1 data';
Não especifique mais de um domínio no ESQL para nenhuma mensagem única. No entanto, se você utilizar instruções PROPAGATE para gerar várias mensagens de saída, será possível definir um domínio diferente para cada mensagem.
Para obter informações sobre a lista completa de elementos na árvore Propriedades, consulte Tipos de dados para elementos na subárvore de Propriedades.