SCADAInput

Utilize o nó SCADAInput para receber mensagens de clientes que se conectam ao intermediário por meio do WebSphere MQ Telemetry Transport.

Este tópico contém as seguintes seções:

Propósito

Os clientes do dispositivo SCADA utilizam o protocolo MQIsdp para enviar mensagens que são convertidas pelo nó SCADAInput em um formato que é reconhecido pelo WebSphere Message Broker. O nó também estabelece o ambiente de processamento para essas mensagens.

Os fluxos de mensagens que manipulam as mensagens recebidas dos dispositivos SCADA devem sempre iniciar com um nó SCADAInput. Defina as propriedades do nó SCADAInput para controlar a forma como as mensagens são recebidas; por exemplo, você pode indicar que uma mensagem deve ser processada sob o controle da transação.

Ao implementar fluxos de mensagens que contêm nós SCADA em um servidor intermediário, implemente-os em um único grupo de execução, independentemente do número de fluxos de mensagens.

O grupo de execução no qual os fluxos de SCADA são implementados deve ser o grupo de execução padrão. O grupo de execução padrão pode ser identificado pela inspeção do campo defaultExecutionGroup na mensagem BIP2201 na inicialização do grupo de execução. Um valor true indica o grupo de execução padrão.

SCADA é principalmente um protocolo de Publicação/Assinatura; portanto, você geralmente inclui um nó Publicação no final do fluxo. Em cenários em que você não deseja utilizar um nó Publicação, inclua um nó SCADAOutput. Se você incluir um nó SCADAOutput, também deverá incluir um nó SCADAInput, independentemente da origem das mensagens, porque o nó SCADAInput fornece as informações de conectividade exigidas pelo nó SCADAOutput.

Se você incluir um nó de saída em um fluxo de mensagens que comece com um nó SCADAInput, ele poderá ser qualquer um dos nós de saída suportados, incluindo nós de saída definidos pelo usuário. Você pode criar um fluxo de mensagens que recebe mensagens de dispositivos SCADA, e gera mensagens para clientes que utilizam todos os transportes suportados para conectar-se ao intermediário, porque é possível configurar o fluxo de mensagens para solicitar que o intermediário forneça alguma conversão necessária.

Você pode solicitar que o intermediário inicie ou pare um listener SCADA, publicando mensagens com um tópico específico. Este pedido pode ser aplicado a todas as portas ou a uma única porta que esteja identificada na mensagem.

O nó SCADAInput manipula mensagens nos seguintes domínios de mensagem:
  • MRM
  • XML
  • XMLNS
  • XMLNSC
  • BLOB

z/OS platform Você não pode utilizar nós SCADAInput nos fluxos de mensagens que devem ser implementados nos sistemas z/OS.

Para processar os dados em uma mensagem SCADA recebida, inclua um nó, como o nó ResetContentDescriptor, e configure suas propriedades para forçar o fluxo de bits a ser reanalisado por um nó subsequente.

Se você criar um fluxo de mensagens para utilizar como um subfluxo, não poderá utilizar um nó de entrada padrão; é necessário utilizar um nó Entrada como o primeiro nó para criar um terminal In para o subfluxo.

Se o fluxo de mensagens não receber mensagens pelas conexões SCADA, escolha um dos nós de entrada suportados.

O nó SCADAInput está contido no repositório Protocolos Adicionais da paleta e é representado no ambiente de trabalho pelo seguinte ícone:

 Ícone do nó SCADAInput

Utilizando este nó em um fluxo de mensagens

Para obter um exemplo de como utilizar esse nó, considere a criação de um fluxo de mensagens com um nó SCADAInput que recebe mensagens de um sensor remoto quando ele detecta uma alteração em seu ambiente operacional (por exemplo, uma queda na temperatura externa). Você conecta o nó a um nó MQOutput, que disponibiliza essas mensagens em uma fila atendida por um aplicativo WebSphere MQ que analisa e responde às informações recebidas.

Em outro exemplo, você cria um fluxo de mensagens com um nó SCADAInput que recebe mensagens a cada minuto de um sistema remoto. As mensagens contêm detalhes das definições do comutador de sistema. Os dados recebidos são alimentados em um nó ResetContentDescriptor para converter os dados de binário (BLOB) para o formato de mensagens MRM. As informações sobre o sistema são armazenadas em um banco de dados utilizando o nó Banco de Dados e aprimoradas utilizando um nó Compute para criar uma mensagem XML, que é publicada utilizando um nó Publicação.

As mensagens XML são caras para enviar (porque a transmissão via satélite possui um alto custo para cada byte); portanto, é vantajoso utilizar este método, porque os dados são enriquecidos pelo intermediário.

Configurando o Nó SCADAInput

Quando tiver colocado uma instância do nó SCADAInput em um fluxo de mensagens, será possível configurar o nó. Para obter informações adicionais, consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Para exibir as propriedades do nó no diálogo Propriedades, dê um clique duplo no nó ou clique com o botão direito no nó e clique em Propriedades.

Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.

  1. Opcional: Na guia Descrição , digite uma Descrição breve, uma Descrição longa, ou ambas. Você também pode renomear o nó nessa guia.
  2. Na guia Básico, configure as seguintes propriedades:
    • Atualize o status do listener publicando no tópico de controle $SYS/SCADA/MQIsdpListener/<port_number> com a parte de Carga Útil da mensagem configurada como ON ou OFF. Ativar o listener na Inicialização é selecionado inicialmente, o que significa que o listener para clientes MQIsdp é inicializado quando o fluxo de mensagens é implementado.
    • Especifique o número da Porta (Port) na qual o servidor MQIsdp atende. Esse valor deve ser um número de porta exclusivo e não deve causar conflito com outros listeners (por exemplo, aqueles configurados para WebSphere MQ ou WebSphere MQ Everyplace). O número padrão é 1883.
    • Defina o valor Máximo de Encadeamentos para indicar o número máximo de encadeamentos disponíveis para o servidor MQIsdp para suportar clientes. O valor padrão é 500.

      Se você estiver utilizando o DB2 como seu banco de dados intermediário, especifique um valor que seja menor que ou igual ao valor definido para os parâmetros de configuração maxappls e maxagents do DB2. Veja informações adicionais na publicação Ativando as Conexões ODBC para os Bancos de Dados.

    • Selecione Utilizar Conjunto de Encadeamento se você quiser que o nó utilize um conjunto de encadeamentos para atender os clientes. Se você selecionar essa opção, o número de encadeamentos disponíveis para o servidor MQIsdp será limitado por Máximo de Encadeamentos, que mais eficiente quando definido para um valor entre 20 e 40. Se esta opção não for selecionada, será criado um novo encadeamento para cada cliente que se conecta. A caixa de opções fica desmarcada inicialmente.

      Utilize esta opção apenas se você esperar que um grande número de clientes (acima de 200) faça conexão.

  3. Na guia Análise de Mensagem de Entrada, defina valores para as propriedades que descrevem o domínio de mensagem, o conjunto de mensagens, o tipo de mensagens e o formato de mensagens que o nó utiliza para determinar como analisar a mensagem de entrada.
    • Em Domínio de Mensagem, selecione da lista o nome do analisador que está sendo utilizado. Você pode escolher a partir das seguintes opções:
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • BLOB
    • Se você estiver utilizando o analisador MRM , selecione o Conjunto de Mensagens que deseja utilizar. Essa lista é preenchida com os conjuntos de mensagens disponíveis quando você seleciona MRM ou XMLNSC como o domínio.

      Deixe Conjunto de Mensagens em branco para os analisadores XML, XMLNS, XMLNSC e BLOB.

    • Se você estiver utilizando o analisador MRM, selecione a mensagem correta na lista em Tipo de Mensagem. Esta lista é ocupada com mensagens que estão definidas no Conjunto de mensagens que você selecionou.

      Deixe Tipo de Mensagem em branco para os analisadores XML, XMLNS, XMLNSC e BLOB.

    • Se você estiver utilizando o analisador MRM, selecione o formato da mensagem a partir da lista em Formato de Mensagem. Esta lista inclui todos os formatos físicos que você definiu para este Conjunto de Mensagens.

      Deixe Formato de Mensagem em branco para os analisadores XML, XMLNS, XMLNSC, e BLOB.

  4. Na guia Opções de Analisadores, Analisar Tempo é, por padrão, definido como On Demand. Esse valor causa o atraso da validação até que ela seja analisada pela análise parcial. Se você alterar esse valor para Imediato (Immediate), a análise parcial será substituída e tudo o que estiver na mensagem será analisado e validado, exceto aqueles tipos complexos com uma composição de Opção (Choice) ou Mensagem (Message) que não possam ser resolvidos no momento. Se você alterar esse valor para Completo (Complete), a análise parcial será substituída e tudo que estiver na mensagem será analisado e validado; tipos complexos com uma composição de Opção (Choice) ou Mensagem (Message) que não podem ser resolvidos no momento causam falha de validação.
  5. Na guia Avançado, defina o valor exigido para Modo de Transação para definir as características transacionais de como essa mensagem será manipulada:
    • Se você selecionar Automático, a mensagem que chega será recebida no ponto de sincronização se estiver marcada como persistente; caso contrário, ela não será recebida no ponto de sincronização. A transacionalidade de todas as mensagens derivadas, enviadas subseqüentemente por um nó de saída, é determinada pela propriedade de persistência de entrada, a menos que o nó de saída tenha substituído explicitamente a transacionalidade.
    • Se você selecionar Sim, a mensagem que chega será recebida no ponto de sincronização. Todas as mensagens derivadas, enviadas subseqüentemente por um nó de saída na mesma instância do fluxo de mensagens, são enviadas de forma transacional, a menos que o nó de saída tenha substituído explicitamente a transacionalidade.
    • Se você selecionar Não, a mensagem que chega não será recebida no ponto de sincronização. Qualquer mensagem derivada enviada subseqüentemente por um nó de saída no fluxo será enviada não-transacionalmente, a menos que o nó de saída tenha especificado que a mensagem deve ser colocada no ponto de sincronização.
  6. Na guia Validação, defina as propriedades de validação se quiser que o analisador valide o corpo das mensagens a partir do Conjunto de Mensagens. Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada.

    Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.

Conectando Terminais

O nó SCADAInput roteia cada mensagem recuperada com êxito para o terminal Out. Se esta ação falhar, a mensagem será propagada para o terminal Failure; será possível conectar nós a este terminal para manipular esta condição. Se você não tiver conectado o terminal Failure, a mensagem entrará em loop contínuo através do nó, até que o problema seja resolvido.

Se a mensagem for capturada por esse nó após a emissão de uma exceção no fluxo de mensagens, a mensagem será roteada para o terminal Catch. Se você não tiver conectado o terminal Catch, a mensagem entrará em loop contínuo através do nó, até que o problema seja resolvido. Assegure-se de que um nó esteja sempre conectado a este terminal se houver a possibilidade de a mensagem ser revertida em um fluxo de mensagens.

Configurando para Transações Coordenadas

Quando você incluir um nó SCADAInput em um fluxo de mensagens, o valor configurado para o Modo de Transação definirá se as mensagens são recebidas no ponto de sincronização:

  • Se você configurar esta propriedade para Sim (o padrão), a mensagem será recebida no ponto de sincronização; ou seja, em uma unidade de trabalho do WebSphere MQ. Qualquer mensagem enviada subseqüentemente por um nó de saída na mesma instância do fluxo de mensagens será colocada no ponto de sincronização, a menos que o nó de saída tenha substituído isto explicitamente.
  • Se você configurar esta propriedade para Automático, a mensagem será recebida no ponto de sincronização se a mensagem que chega estiver marcada como persistente; caso contrário, ela não será recebida no ponto de sincronização. Qualquer mensagem enviada subseqüentemente por um nó de saída é colocada no ponto de sincronização, conforme determinado pela propriedade de persistência de entrada, a menos que o nó de saída tenha substituído isto explicitamente.
  • Se você configurar esta propriedade para Não, a mensagem não será recebida no ponto de sincronização. Qualquer mensagem envida subseqüentemente por um nó de saída no fluxo de mensagens não será colocada no ponto de sincronização, a menos que um nó de saída individual tenha especificado que a mensagem deve ser colocada no ponto de sincronização.

O nó MQOutput é o único nó de saída que pode ser configurado para substituir esta opção.

Terminais e Propriedades

Os terminais do nó SCADAInput são descritos na tabela a seguir.

Terminal Descrição
Failure O terminal de saída para o qual a mensagem será roteada se ocorrer um erro.
Out O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito da fila
Catch O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção downstream e capturada por este nó.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó SCADAInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não O tipo de nó, SCADAInput O nome do nó.
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.

As propriedades Básicas do nó SCADAInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Ativar Listener na Inicialização Sim Não Selecionada Essa propriedade controla quando o listener é iniciado. Se você selecionar a caixa de opções, o listener será iniciado quando o fluxo de mensagens for iniciado pelo intermediário. Se você limpar a caixa de opções, o listener será iniciado durante a chegada de uma mensagem na porta especificada.
Porta Sim Sim 1883 A porta na qual o protocolo SCADA está atendendo.
Máx. de encadeamentos Sim Sim 500 O número máximo de encadeamentos a serem iniciados para suportar dispositivos SCADA.
Utilizar conjunto de encadeamentos Sim Sim Não Selecionada Se você selecionar a caixa de opções, o conjunto de encadeamentos será utilizado.

As propriedades Análise de Mensagem de Entrada do nó SCADAInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Domínio de mensagem Não Não   O domínio utilizado para analisar a mensagem que chega.
Conjunto de Mensagens Não Não   O nome ou identificador do conjunto de mensagens no qual a mensagem que chega está definida.
Tipo de mensagem Não Não   O nome da mensagem que chega.
Formato de Mensagem Não Não   O nome do formato físico da mensagem que chega.

As propriedades Opções do Analisador do nó SCADAInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Cronometragem de análise (Parse timing) Não Não On Demand Esta propriedade controla quando uma mensagem de entrada é analisada. Os valores válidos são On Demand, Imediato e Completo.

Para obter uma descrição completa desta propriedade, consulte Analisando On Demand.

Utilizar analisador compacto XMLNSC para domínio XMLNS Não Não Não Selecionada Essa propriedade controla se o Analisador Compacto XMLNSC (XMLNSC Compact Parser) é utilizado para mensagens no Domínio XMLNS (XMLNS Domain). Se você definir essa propriedade, os dados da mensagem serão exibidos em XMLNSC nos nós que estão conectados ao terminal de saída quando o Domínio de Mensagem das propriedades Análise de Mensagens de Entrada for XMLNS.
Reter conteúdo misto Não Não Não Selecionada Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado.
Reter comentários Não Não Não Selecionada Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado.
Reter instruções de processamento Não Não Não Selecionada Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado.

A propriedade Avançada do nó SCADAInput está descrita na tabela a seguir.

Propriedade M C Padrão Descrição
Modo de Transação Sim Não Sim Esta propriedade controla se a mensagem que chega é recebida no ponto de sincronização. Os valores válidos são Automático, Sim e Não.

As propriedades Validação do nó SCADAInput são descritas na tabela a seguir.

Para obter uma descrição completa destas propriedades, consulte Propriedades de Validação.

Propriedade M C Padrão Descrição
Validar Não Sim Nenhuma Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor e Conteúdo.
Ação de falha Não Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Você pode configurar essa propriedade somente se configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Registro de Erros Local, Exceção e Lista de Exceções.
Inclusão de todos Valores de Tipo Não Não Selecionada Não é possível editar essa propriedade. Se a caixa de opções for selecionada, verificações básicas de limitação de valor serão incluídas na validação Conteúdo e Valor (Content and Value).
Correção Não Não Nenhuma Não é possível editar sua propriedade.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:41

ac04620_