Este tópico contém as seguintes seções:
Utilize o nó Mapping para construir uma ou mais mensagens e ocupá-las com novas informações, com informações modificadas da mensagem de entrada ou com informações extraídas de um banco de dados. Você pode modificar elementos dos dados do corpo da mensagem, seu ambiente associado e sua lista de exceção.
Os cabeçalhos na mensagem de entrada são sempre copiados para a mensagem de saída sem modificação. Você não pode modificar os cabeçalhos de mensagens em um nó Mapping; deve utilizar um nó Compute.
Esses componentes da mensagem de saída podem ser definidos utilizando mapeamentos que são baseados em elementos da mensagem de entrada e de dados de um banco de dados externo. Você cria os mapeamentos associados a esse nó no arquivo de mapeamento associado a esse nó, mapeando entradas (mensagem ou banco de dados) para saídas. Opcionalmente, você pode modificar as designações feitas por esses mapeamentos, utilizando funções e procedimentos fornecidos ou definidos pelo usuário: por exemplo, você pode converter um valor de cadeia em maiúscula quando designá-lo ao campo de saída da mensagem.
Utilize o nó Mapping para:
O nó Mapping é representado no pelo seguinte ícone:
Quando você tiver colocado uma instância do nó Mapping em um fluxo de mensagens, poderá configurá-lo. Clique com o botão direito na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.
Todas as propriedades mandatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.
Configure o nó Mapping da seguinte forma:
No sistema z/OS, o intermediário utiliza o ID da tarefa iniciada do intermediário.
Se você clicar em Procurar próximo ao campo de entrada, um diálogo é exibido, listando todas as rotinas de mapeamento disponíveis, acessíveis por esse nó. Selecione a rotina desejada e clique em OK. O nome da rotina é definida em Módulo de Mapeamento.
Para trabalhar com a rotina de mapeamentos associada a esse nó, clique com o botão direito no nó e selecione Abrir Mappings. Se a rotina de mapeamento não existir, ela será criada com o nome padrão no arquivo padrão. Se o arquivo já existir, você também poderá abrir o arquivo <flow_name>_<node_name>.mfmap na visualização do Navigator.
Uma rotina de mapeamento é específica para o tipo de nó com o qual está associada; não é possível utilizar uma rotina de mapeamento desenvolvida para um nó Mapping com qualquer outro nó que use mapeamentos (por exemplo, um nó DataInsert). Se você criar uma rotina de mapeamento, não será possível chamá-la a partir de outra rotina de mapeamento, embora seja possível chamá-la a partir de uma rotina ESQL.
Não é possível modificar os cabeçalhos da mensagem no nó Mapping; eles são copiados inalterados da mensagem de entrada para a mensagem de saída. Você deve utilizar um nó Compute para alterar os cabeçalhos em uma mensagem.
Para obter informações adicionais sobre o trabalho com os arquivos de mapeamento, e a definição de seu conteúdo, consulte Desenvolvendo Mapeamentos.
Você deve definir essa propriedade para refletir corretamente o formato da mensagem de saída requerido. Se selecionar uma opção (ou aceitar o valor padrão) que não inclua um determinado componente da mensagem, esse componente não será incluído em qualquer mensagem de saída que for construída.
(Em releases anteriores à Versão 2.1, o ambiente associado (Ambiente Local) era conhecido como Lista de Destino. O ambiente Lista de Destino é válido e pode ser utilizado para compatibilidade).
(O componente Environment da árvore de mensagens não é afetado pela definição do modo. Seu conteúdo, se houver, é transmitido a partir desse nó.)
As opções são explicadas na tabela a seguir.
Modo | Descrição |
---|---|
Mensagem (o padrão) | A mensagem é gerada ou passada pelo nó Mapping conforme é modificada no nó. |
Ambiente Local | A estrutura em árvore Ambiente Local é gerada ou passada pelo nó Mapping conforme é modificada no nó. |
Ambiente Local e Mensagem | A estrutura em árvore Ambiente Local e a mensagem são geradas ou passadas pelo nó Mapping conforme são modificadas pelo nó. |
Exceção | A Lista de Exceções é gerada ou passada pelo nó Mapping conforme é modificada pelo nó. |
Exceção e Mensagem | A Lista de Exceções e a mensagem são geradas ou passadas pelo nó Mapping conforme são modificadas pelo nó. |
Exceção e Ambiente Local | A Lista de Exceções e estrutura em árvore Ambiente Local são geradas ou passadas pelo nó Mapping conforme são modificadas pelo nó. |
Todos | A mensagem, Lista de Exceções e Ambiente Local são geradas ou passadas pelo nó Mappings conforme são especificadas pelo nó. |
Quando selecionar a caixa, o nó tratará todos os códigos de retorno positivos no banco de dados como erros e gerará exceções da mesma forma que faria para os erros negativos ou mais sérios.
Se você não selecionar a caixa, o nó tratará avisos como códigos de retorno normais e não gerará nenhuma exceção. O aviso mais significativo gerado é não-localizado, que pode ser tratado como um código de retorno normal de forma segura na maioria das circunstâncias.
Se você limpar a caixa, deverá tratar o erro no fluxo de mensagens para assegurar a integridade do intermediário e do banco de dados: o erro será ignorado se você não tratá-lo pelo seu próprio processamento, porque escolheu não chamar o tratamento de erros padrão pelo intermediário. Por exemplo, você pode conectar o terminal failure a uma sub-rotina de processamento de erros.
As duas primeiras opções são úteis, principalmente quando a validação é chamada pela primeira vez, porque você vê todos os defeitos de validação, não apenas o primeiro erro encontrado. Quando tiver analisado os defeitos, geralmente você poderá selecionar Exceção para utilização futura.
Os destinos de defeitos se comportam como os da saída do nó Trace. Assim, por exemplo, se você selecionar Rastreio do Usuário, as entradas de rastreio serão gravadas independentemente da definição do sinalizador de rastreio do usuário para o fluxo de mensagens.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
Os terminais do nó Mapping são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Entrada | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
Defeito | O terminal de saía para qual a mensagem de entrada será propagada caso seja detectada uma falha durante o cálculo. Se você tiver selecionado Tratar Avisos como Erros, o nó propagará a mensagem para esse terminal se as mensagens de aviso de banco de dados forem retornadas, mesmo se o processamento tiver sido concluído com êxito. |
Saída | O terminal de saída que exibe a mensagem após a execução da instrução do banco de dados. |
As tabelas a seguir descrevem as propriedades do nó; a coluna com cabeçalho M indica se a propriedade é mandatória (marcado com um asterisco no diálogo de propriedades caso seja necessário digitar um valor quando nenhum padrão for definido), a coluna com cabeçalho C indica se a propriedades é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens no arquivo bar para implementá-lo).
As propriedades Básicas do nó Mapping são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Fonte de Dados | Não | Sim | O nome da origem de dados ODBC do banco de dados no qual residem as tabelas as quais foram referidas nos mapeamentos associados a este nó (identificado pela propriedade Módulo de Mapeamento). | |
Transação | Sim | Não | Automático | O modo de transação para o nó. Os valores válidos são Automático ou Consolidar. |
Módulo de Mapeamento | Sim | Não | Mapeamento | O nome da rotina de mapeamento que contém as instruções a serem executadas na árvore de mensagens ou no banco de dados. A rotina é exclusiva para esse tipo de nó. |
Modo de Mapeamento | Sim | Não | Message | Selecione uma das seguintes opções:
|
Tratar Avisos como Erros | Sim | Não | Limpo | Trata aviso SQL do banco de dados como erros. Se você selecionar a caixa de opções, esta ação é executada. |
Exceção emitida em erro do banco de dados | Sim | Não | Selecionada | Erros de banco de dados fazem com que o intermediário lance uma exceção. Se você selecionar a caixa de opções, esta ação é executada. |
As propriedades de Validação do nó Mapping são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Validar | Sim | Não | Nenhum | Determina se a validação ocorrerá. Os valores válidos são Nenhum e Conteúdo e Valor. |
Ação de Defeito | Sim | Não | Exceção | O que acontece se ocorrer um defeito de validação. Você pode definir essa propriedade apenas se Validar for definido para Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Log de Erro Local e Exceção. |
Incluir Todas as Limitações do Valor | Sim | Não | Selecionada | Essa propriedade não pode ser editada. A ação padrão, indicada pela caixa de opções que está sendo selecionada, é que todas as restrições de valores estão incluídas na validação. |
Corrigir | Sim | Não | Nenhum | Essa propriedade não pode ser editada. É fornecida uma correção mínima. |
As propriedades de Descrição do nó Mapping são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Descrição Breve | Não | Não | Uma breve descrição do nó. | |
Descrição Longa | Não | Não | Texto que descreve a finalidade do nó no fluxo de mensagens. |
Conceitos relacionados
Fluxos de Mensagem
Fluxos de Mensagens, Mapeamentos e ESQL
Editor de Mapeamento do Fluxo de Mensagens
Tarefas relacionadas
Configurando o DB2
Decidindo Quais Nós Utilizar
Configurando Fluxos de Mensagens Coordenados
Tratando Erros em Fluxos de Mensagens
Desenvolvendo Mapeamentos
Editando Propriedades Configuráveis
Referências relacionadas
Comando mqsichangebroker
Comando mqsicreatebroker
Comando mqsisetdbparms
Nó Compute
Nó Datalnsert
Avisos |
Marcas |
Downloads |
Biblioteca |
Suporte |
Feedback
![]() ![]() |
ac04720_ |