Quando você pede suporte para a origem da
contabilidade para a coleta da contabilidade do fluxo de mensagens e
de dados estatísticos no comando
mqsichangeflowstats,
você deve configurar também os fluxos de mensagens para fornecer os
valores de identificação corretos que indicam a que dados estão
associados.
Os dados de contabilidade e estatísticas estão associados a uma
origem de contabilidade. Para obter informações adicionais, consulte Estatísticas e Dados Contábeis do Fluxo de Mensagens e Origem da Contabilidade de Fluxo de Mensagens e da Contabilidade de Estatísticas.
Você pode definir um valor diferente para cada fluxo de mensagens
para o qual a coleta de dados está ativa ou o mesmo valor para um
grupo de fluxos de mensagens (por exemplo, os existentes em um único
grupo de execução ou associados a um determinado cliente,
departamento ou conjunto de aplicativos).
A definição de origem da contabilidade não será
utilizada até que você implemente o(s) fluxo(s) de mensagens nos
brokers nos quais devem ser executados. Você pode
ativar a coleta de dados ou modificá-la para o suporte da origem de
contabilidade antes ou depois de implementar o fluxo de mensagens. Não é necessário parar a coleta de dados quando é implementado um
fluxo de mensagens que altera a origem da contabilidade.
Para
configurar um fluxo de mensagens para especificar uma determinada origem de contabilidade,
conclua as etapas a seguir.
- Abra o fluxo de mensagens com o qual você deseja trabalhar.
- Clique em Seleção acima da paleta de nós.
- Clique com o botão direito do mouse em um nó Compute, Banco de Dados ou Filter na visualização do editor
e, em seguida, clique em Abrir ESQL. O arquivo ESQL associado
é aberto na visualização do editor e o cursor é posicionado no início do
módulo correto. Você pode incluir o ESQL requerido em qualquer um
desses nós, portanto, deverá decidir qual nó em cada fluxo de
mensagens é o mais adequado para essa ação.
Para aproveitar o
suporte de origem de contabilidade, inclua um desses nós em cada fluxo de
mensagens para o qual deseja configurar uma origem específica. Se você não configurou um desses três nós no fluxo de mensagens,
deverá incluir um num momento adequado (por exemplo, imediatamente
após o nó input) e conectá-lo a outros nós no fluxo.
- Atualize o ESQL no módulo do nó para configurar uma origem de
contabilidade. O intermediário utiliza o identificador de
origem definido na árvore Ambiente. Você deve definir um valor no
campo com nome de correlação
Environment.Broker.Accounting.Origin .
Esse campo não é
criado automaticamente na árvore Ambiente quando a mensagem é
recebida pela primeira vez no intermediário. Ele é criado
apenas quando você o configura em um módulo ESQL associado a um nó
no fluxo de mensagens.
Se você não definir um valor no fluxo de mensagens, o valor padrão
Anônimo será utilizado para todas as saídas.
Se você
definir um valor em mais de um local no fluxo de mensagens, o valor
definido imediatamente antes do fluxo de mensagens terminar será
utilizado nos dados de saída.
O código que deve ser incluído tem o
seguinte formato:
SET Environment.Broker.Accounting.Origin
= "value";
É
possível configurar o identificador com um valor fixo (conforme mostrado anteriormente) ou você pode determinar seu valor com base em um valor dinâmico que é conhecido apenas no tempo de execução. O valor deve ser dados de caracteres e pode ter no
máximo 32 bytes. Por exemplo, você pode configurar seu valor com o conteúdo
de um determinado campo na mensagem que está sendo processada (se
estiver codificando o ESQL para um nó Compute,
deverá usar o nome de correlação InputBody no lugar de Corpo no exemplo
a seguir):
IF Body.DepartmentName <> NULL THEN
SET Environment.Broker.Accounting.Origin = Body.DepartmentName;
END IF;
- Salve o módulo ESQL e verifique se você não introduziu nenhum erro.
- Salve o fluxo de mensagens e verifique novamente a existência de
erros.
Agora você está pronto para implementar o fluxo de
mensagens atualizado; para obter mais informações, consulte
Implementando Recursos.
Os registros de dados de contabilidade e estatísticas coletados após a
implementação do fluxo de mensagens incluirão o identificador de origem que
você configurou.