Nó SCADAInput

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

Finalidade

Utilize o nó SCADAInput para receber mensagens de clientes que se conectam ao intermediário pelo . Os clientes do dispositivo SCADA utilizam o protocolo MQIsdp para enviar as mensagens, que são convertidas pelo nó SCADAInput em um formato reconhecido pelo . O nó também estabelece o ambiente de processamento para essas mensagens.

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

Quando implementar fluxos de mensagens contendo nós SCADA em um intermediário, será necessário implementá-los em um único grupo de execução, independentemente do número do fluxo de mensagens.

Como SCADA é principalmente de publicação/assinatura, você geralmente incluirá um nó Publication para finalizar o fluxo. Em cenários nos quais você não deseja um nó Publication, pode incluir um nó SCADAOutput. Se fizer isso, também deverá incluir um nó SCADAInput, independentemente da origem das mensagens, porque o nó SCADAInput fornece as informações de conectividade requeridas pelo nó SCADAOutput.

Se você incluir um nó de saída em um fluxo de mensagens que começa com um nó SCADAInput, ele poderá ser qualquer um dos nós de saída suportados (incluindo os 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 conexão com o intermediário, porque você pode configurar o fluxo de mensagens para solicitar que o intermediário forneça qualquer 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. Isso pode ser feito para todas as portas, ou para uma única porta identificada na mensagem.

O nó SCADAInput identifica mensagens nos seguintes domínios de mensagens:

  • MRM
  • XML
  • XMLNS
  • JMSMap
  • JMSStream
  • BLOB

Você não pode utilizar nós SCADAInput em fluxos de mensagens que devem ser implementados em sistemas .

Se você deseja processar os dados em uma mensagem SCADA de entrada, inclua um nó como o nó ResetContentDescriptor e defina suas propriedades para forçar o fluxo de bits a ser reanalisado por um nó subseqüente.

Se você criar um fluxo de mensagens para utilizar como um subfluxo, não poderá utilizar um nó de entrada padrão, será necessário utilizar uma instância do nó Input como o primeiro nó a ser criado em um terminal para o subfluxo.

Se seu fluxo de mensagens não receber mensagens através de conexões SCADA, será possível escolher um destes outros nós de entrada:

  • HTTPInput
  • MQInput
  • MQeInput
  • Real-timeInput
  • Um nó de entrada definido pelo usuário

O nó SCADAInput é representado no pelo seguinte ícone:

 Ícone do nó SCADAInput

Utilizando este nó em um fluxo de mensagens

Para obter um exemplo de como utilizar esse nó, suponha que você cria 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 torna essa mensagens disponíveis em uma fila atendida por um aplicativo que analisa e responde às informações recebidas.

Em um segundo 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 do formato de mensagem BLOB (binário) para MRM. As informações sobre o sistema são armazenadas em um banco de dados utilizando o nó Database e enriquecidas utilizando um nó Compute para criar uma mensagem XML que é publicada utilizando um nó Publication.

Como o envio das mensagens XML é caro (a transmissão por satélite tem um alto custo por byte), é vantajoso utilizar esse método, pois 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, você poderá configurá-lo. Clique com o botão direito na visualização do editor clique em Propriedades. As propriedades básicas do nó serão exibidas no diálogo de propriedades.

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ó SCADAInput da seguinte forma:

  1. Defina as seguintes propriedades básicas:
    1. A caixa de opções Ativar Listener na Inicialização é inicialmente selecionada. Isso significa que o listener para clientes MQIsdp é inicializado quando o fluxo de mensagens é implementado.

      Você pode atualizar o status do listener publicando o tópico de controle $SYS/SCADA/MQIsdpListener/<número_da_porta> com a parte de Carga Útil da mensagem definida como ON ou OFF.

    2. Especifique o número da Porta na qual o servidor MQIsdp deve atender.Essa deve ser uma porta exclusiva e não deve entrar em conflito com outros listeners (por exemplo, os configurados para ou ).O número padrão é 1883.
    3. Defina o valor Número 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 do intermediário, deverá especificar um valor menor ou igual ao valor definido para os parâmetros de configuração do DB2 maxappls e maxagents. Consulte Conectando-se aos Bancos de Dados para obter informações adicionais.

    4. Selecione Utilizar Conjunto de Encadeamentos se desejar que o nó utilize um conjunto de encadeamentos para clientes do serviço. Se você selecionar essa opção, o número de encadeamentos disponíveis para o servidor MQIsdp será limitado por Número Máximo de Encadeamentos, que é recomendável ser definido como um valor máximo de 20. Se esta opção não for selecionada, será criado um novo encadeamento para cada cliente que se conecta. A caixa de opções é inicialmente limpa.

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

  2. Selecione Padrão no navegador do diálogo de propriedades e defina valores para as propriedades que descrevem o domínio da mensagem, o conjunto de mensagens, o tipo de mensagem e o formato de mensagem que o nó utiliza para determinar como analisar a mensagem de entrada e o tópico padrão associado à mensagem.
    • Se a mensagem de entrada tiver um cabeçalho MQRFH2, não será necessário definir valores para as propriedades Padrão, porque os valores podem ser derivados da pasta <mcd> no cabeçalho MQRFH2. Por exemplo:
      <mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
      <Fmt>XML</Fmt></mcd>

      Se você definir os valores e esses valores forem diferentes dos existentes no cabeçalho MQRFH2, os valores do cabeçalho MQRFH2 terão precedência.

    • No Domínio da Mensagem, selecione o nome do analisador que você está utilizando a partir da lista drop-down. Você pode escolher entre:
      • MRM
      • XML
      • XMLNS
      • JMSMap
      • JMSStream
      • BLOB
    • Se você estiver utilizando o analisador MRM, selecione o conjunto de mensagens correto na lista suspensa conjunto de mensagens. Essa lista é ocupada com conjuntos de mensagens disponíveis quando você seleciona MRM como o domínio.

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

    • Se estiver utilizando o analisador MRM, selecione a mensagem correta na lista suspensa 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, JMS, e BLOB.

    • Selecione o formato da mensagem a partir da lista suspensa em Formato de Mensagens.Essa lista inclui todos os formatos físicos definidos para este conjunto de mensagens. Se você utilizou os nomes padrão para os formatos físicos, a lista conterá:
      • CWF1 (o ID padrão do Formato de Ligação Personalizado)
      • XML1
      • TDS1
      Se você especificou nomes diferentes (não padrão) para qualquer um destes formatos físicos, seus nomes aparecerão nesta lista.

      Deixe Formato da Mensagem em branco para os analisadores XML, XMLNS, JMS e BLOB.

  3. Selecione Avançado no navegador do diálogo de propriedades e defina o valor requerido para Modo de Transação para definir as características transacionais de como esta mensagem é tratada:
    • Se você selecionar Automático, a mensagem de entrada será recebida sob o ponto de sincronização, se estiver marcada como persistente, de outra maneira, não será. A capacidade de transação de qualquer mensagem entregue 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 explicitamente substituído a capacidade de transação.
    • Se você selecionar Sim, a mensagem de entrada será recebida sob o ponto de sincronização.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 capacidade de transação.
    • Se você selecionar Não, a mensagem de entrada não será recebida sob o ponto de sincronização.As mensagens derivadas, enviadas subseqüentemente por um nó de saída no fluxo são enviadas em forma não-transacional, a menos que o nó de saída tenha especificado que a mensagem deve ser colocada sob o ponto de sincronização.
  4. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  5. Clique em Aplicar para fazer as alterações no nó SCADAInput sem fechar o diálogo de propriedades. Clique em OK para aplicar as alterações e fechar o diálogo de propriedades.

    Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.

Conectando Terminais

O SCADAInput roteia cada mensagem que recupera com êxito para o terminal out. Se falhar, a mensagem será propagada para o terminal failure; você poderá conectar nós nesse terminal para identificar essa condição. Se você não conectou o terminal failure, a mensagem entrará em um loop contínuo pelo nó até que o problema seja resolvido.

Se a mensagem for capturada por este nó após o lançamento de uma exceção no fluxo de mensagens, a mensagem será roteada para o terminal da captura. Se você não conectou o terminal catch, a mensagem entrará em um loop contínuo pelo nó até que o problema seja resolvido. Assegure 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

Ao incluir um nó SCADAInput em um fluxo de mensagens, o valor que você configura para o Modo de Transação define se as mensagens são recebidas sobre o ponto de sincronização:

  • Se você defini-la como Sim (o padrão), a mensagem será recebida sob o ponto de sincronização (ou seja, dentro de uma unidade de trabalho ). As mensagens enviadas subseqüentemente por um nó de saída na mesma instância do fluxo de mensagens são colocadas sob o ponto de sincronização, a menos que o nó de saída tenha feito a substituição explicitamente.
  • Se você defini-la como Automático, a mensagem será recebida sob o ponto de sincronização se a mensagem de entrada for marcada como persistente.De outra maneira, ela não será. Qualquer mensagem enviada subseqüentemente por um nó de saída será colocada sob o ponto de sincronização, conforme determinado pela propriedade de persistência de entrada, a menos que o nó de saída tenha feito a substituição explicitamente.
  • Se você defini-la como Não, a mensagem não será recebida sob o ponto de sincronização.As mensagens enviadas subseqüentemente por um nó de entrada no fluxo não são colocadas sob o ponto de sincronização, a menos que o nó de saída tenha especificado que a mensagem deva ser colocada sob o ponto de sincronização.

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

Terminais e Propriedades

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

Terminal Descrição
Defeito O terminal de saída para o qual a mensagem será roteada se ocorrer um erro.
Saída O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito da fila
Capturar 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 é 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ó SCADAInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Ativar Listener na Inicialização Sim Não Selecionada 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.
Número Máximo 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 Limpo Determina se deve utilizar o conjunto de encadeamentos. Se você selecionar a caixa de opções, esta ação é executada.

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

Propriedade M C Padrão Descrição
Domínio de Mensagens Não Não   O domínio da mensagem de entrada.
Conjunto de Mensagens Não Não   O conjunto de mensagens da mensagem de entrada.
Tipo de Mensagem Não Não   O tipo da mensagem de entrada.
Formato de Mensagem Não Não   O formato da mensagem de entrada.

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 Determina se a mensagem de entrada é recebida sob o ponto de sincronização. Os valores válidos são Automático, Sim e Não.

As propriedades de Descrição do nó SCADAInput 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
Extensões Definidas pelo Usuário
Implementação de Aplicativo de Fluxo de Mensagens

Tarefas relacionadas
Conectando-se aos Bancos de Dados
Decidindo Quais Nós Utilizar
Utilizando Mais de Um Nó Input
Configurando Fluxos de Mensagens Coordenados
Tratando Erros em Fluxos de Mensagens
Editando Propriedades Configuráveis

Referências relacionadas

Nó HTTPInput
Nó Input
Nó MQeInput
Nó MQInput
Nó Real-timeInput
Nó SCADAOutput