Nodo SCADAInput

Questo argomento contiene le seguenti sezioni:

Scopo

Utilizzare il nodo SCADAInput per ricevere i messaggi dai client che si connettono al broker attraverso WebSphere MQ Telemetry Transport. I client dell'unità SCADA utilizzano il protocollo MQIsdp per inviare messaggi, che sono convertiti dal nodo SCADAInput in un formato riconosciuto da WebSphere Message Broker. Il nodo inoltre stabilisce l'ambiente di elaborazione per questi messaggi.

I flussi di messaggi che gestiscono i messaggi ricevuti dalle unità SCADA devono sempre iniziare con un nodo SCADAInput. Impostare le proprietà del nodo SCADAInput per controllare come sono ricevuti i messaggi: ad esempio, è possibile indicare che un messaggio venga elaborato sotto il controllo della transazione.

Quando si distribuiscono i flussi di messaggi che contengono i nodi SCADA ad un broker, è necessario distribuirli in un singolo gruppo di esecuzione, indipendentemente dal numero dei flussi di messaggi.

Poiché l'unità SCADA esegue principalmente pubblicazione/sottoscrizione, in genere si include un nodo Publication per terminare il flusso. In scenari in cui non si desidera un nodo Publication, è possibile includere un nodo SCADAOutput. In tal caso, è necessario includere anche un nodo SCADAInput indipendentemente dall'origine dei messaggi, poiché il nodo SCADAInput fornisce le informazioni sulla connessione richieste dal nodo SCADAOutput.

Se si include un nodo di output in un flusso di messaggi che inizia con un nodo SCADAInput, questo può essere un nodo di output qualsiasi tra quelli supportati, compresi i nodi definiti dall'utente. E' possibile creare un flusso di messaggi che riceve i messaggi dalle unità SCADA e crea messaggi per i client che utilizzano tutti i trasporti supportati per collegarsi al broker, poiché è possibile configurare il flusso di messaggi per richiedere al broker di fornire tutte le conversioni necessarie.

E' possibile richiedere che il broker avvii o arresti un listener SCADA pubblicando i messaggi con un argomento specifico. Questo si può realizzare per tutte le porte o per una porta singola identificata nel messaggio.

Il nodo SCADAInput gestisce i messaggi nei seguenti domini di messaggi:

  • MRM
  • XML
  • XMLNS
  • XMLNSC
  • JMSMap
  • JMSStream
  • MIME
  • BLOB
  • IDOC

Non è possibile utilizzare i nodi SCADAInput nei flussi di messaggi che vanno distribuiti ai sistemi z/OS.

Se si desidera elaborare i dati in un messaggio SCADA in entrata, includere un nodo, come ad esempio ResetContentDescriptor e impostarne le proprietà in modo da forzare una nuova analisi del flusso di bit da parte di un nodo successivo.

Se si crea un flusso di messaggi da utilizzare come un flusso secondario, non è possibile utilizzare un nodo di input standard, è necessario utilizzare un'istanza del nodo Input come primo nodo per creare un terminale in per il flusso secondario.

Se il flusso di messaggi non riceve messaggi attraverso le connessioni SCADA, è possibile scegliere uno dei nodi di input supportati.

Il nodo SCADAInput è rappresentato nel workbench dalla seguente icona:

Icona del nodo SCADAInput

Utilizzo di questo nodo in un flusso di messaggi

Per avere un esempio di come utilizzare questo nodo, ipotizziamo di creare un flusso di messaggi con un nodo SCADAInput che riceva messaggi da un sensore remoto quando rilevi una modifica nel proprio ambiente operativo (ad esempio, un calo della temperatura esterna). Si connette il nodo ad un nodo MQOutput che renda questi messaggi disponibili in una coda che utilizza un'applicazione WebSphere MQ che analizza e risponde alle informazioni ricevute.

In un secondo esempio, si crea un flusso di messaggi con un nodo SCADAInput che riceve messaggi ogni minuto da un sistema remoto. I messaggi contengono dettagli relativi alle impostazioni del commutatore del sistema. I dati ricevuti vengono inseriti in un nodo ResetContentDescriptor per eseguire il cast dei dati da binari (BLOB) al formato del messaggio MRM. Le informazioni relative al sistema sono memorizzate in un database utilizzando un nodo Database e ampliate utilizzando un nodo Compute per creare un messaggio XML, che è pubblicato utilizzando un nodo Publication.

Dal momento che inviare i messaggi XML è costoso (perché la trasmissione satellitare ha un costo elevato per ogni byte), l'utilizzo di questo metodo è vantaggioso poiché i dati sono ampliati dal broker.

Configurazione di un nodo SCADAInput

Una volta inserita un'istanza del nodo SCADAInput in un flusso di messaggi, è possibile configurarla. Fare clic con il tasto destro del mouse sul nodo nella vista dell'editor e fare clic su Proprietà. Le proprietà base del nodo vengono visualizzate nella finestra di dialogo delle proprietà.

Tutte le proprietà obbligatorie, per le quali è necessario immettere un valore (quelle per le quali non è specificato un valore predefinito), sono contrassegnate con un asterisco nella finestra di dialogo delle proprietà.

Configurare il nodo SCADAInput come segue:

  1. Impostare le seguenti proprietà base:
    1. La casella di spunta Abilita listener all'avvio inizialmente è selezionata. Questo significa che il listener per i client MQIsdp è inizializzato quando viene distribuito il flusso di messaggi.

      È possibile aggiornare lo stato del listener tramite la pubblicazione nell'argomento di controllo $SYS/SCADA/MQIsdpListener/<port_number> con la sezione relativa al Payload del messaggio impostata su ON o OFF.

    2. Specificare il numero di Porta su cui il server MQIsdp è in ascolto. Questa deve essere una porta univoca e non deve entrare in conflitto con altri listener (ad esempio, quelli impostati per WebSphere MQ o WebSphere MQ Everyplace). Il numero predefinito è 1883.
    3. Impostare il valore Numero massimo di thread per indicare il numero massimo di thread disponibili per il server MQIsdp per il supporto ai client. Il valore predefinito è 500.

      Se si sta utilizzando DB2 per il database del broker, è necessario specificare un valore inferiore o pari al valore impostato per i parametri di configurazione DB2 maxappls e maxagents. Consultare Connessione ai database per ulteriori informazioni.

    4. Selezionare Utilizza pool di thread se si desidera che il nodo utilizzi un pool di thread per gestire i client. Con questa opzione, il numero di thread disponibili per il server MQIsdp è limitato dal Numero massimo di thread, che si consiglia di impostare su un valore compreso tra 20 e 40. Se non si seleziona questa opzione, viene creato un nuovo thread per ogni client che si connette. La casella di spunta è inizialmente deselezionata.

      Utilizzare questa opzione solo se si prevede la connessione di un numero elevato di client (superiore a 200).

  2. Selezionare Predefinite nel Navigator della finestra di dialogo delle proprietà e impostare i valori per le proprietà che descrivono il dominio dei messaggi, la serie di messaggi, il tipo di messaggio e il formato del messaggio che il nodo utilizza per stabilire come analizzare il messaggio in entrata e l'argomento predefinito associato al messaggio.
    • Se il messaggio in arrivo dispone di un'intestazione MQRFH2, non è necessario impostare i valori delle proprietà Predefinite poiché è possibile derivare tali valori dalla cartella <mcd> dell'intestazione. Ad esempio:
      <mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
      <Fmt>XML</Fmt></mcd>

      Se si impostano i valori e quei valori sono diversi da quelli nell'intestazione MQRFH2, i valori dell'intestazione MQRFH2 hanno la precedenza.

    • In Dominio messaggi, selezionare il nome del programma di analisi che si sta utilizzando dall'elenco a discesa. E' possibile scegliere tra i seguenti nomi:
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • JMSMap
      • JMSStream
      • MIME
      • BLOB
      • IDOC
    • Se si sta utilizzando il programma di analisi MRM o IDOC, selezionare la serie di messaggi corretta dall'elenco a discesa in Serie di messaggi. Questo elenco è popolato con le serie di messaggi disponibili quando si seleziona MRM o IDOC come dominio.

      Lasciare il campo Serie di messaggi vuoto per i programmi di analisi XML, XMLNS, XMLNSC, JMS, MIME e BLOB.

    • Se si sta utilizzando il programma di analisi MRM, selezionare il messaggio corretto dall'elenco a discesa in Tipo messaggio. Questo elenco è popolato con i messaggi definiti nella serie di messaggi selezionata.

      Lasciare il campo Tipo messaggio vuoto per i programmi di analisi XML, XMLNS, XMLNSC, JMS, MIME, BLOB e IDOC.

    • Se si sta utilizzando il programma di analisi MRM o IDOC, selezionare il formato del messaggio dall'elenco a discesa in Formato del messaggio. Questo elenco include tutti i formati fisici definiti per questa serie di messaggi.

      Lasciare il campo Formato del messaggio vuoto per i programmi di analisi XML, XMLNS, XMLNSC, JMS, MIME e BLOB.

  3. Selezionare Avanzate nel Navigator della finestra di dialogo delle proprietà e impostare il valore richiesto per Modalità transazione per definire le caratteristiche transazionali di come è gestito questo messaggio:
    • Se si seleziona Automatico, il messaggio in entrata è ricevuto nel punto di sincronizzazione, se è contrassegnato come permanente, altrimenti no. La transazionalità di qualunque messaggio derivato, successivamente inviato da un nodo di output è determinata dalla proprietà di permanenza in entrata, a meno che il nodo di output non abbia esplicitamente sovrascritto la transazionalità.
    • Se si seleziona , il messaggio in entrata è ricevuto nel punto di sincronizzazione. Tutti i messaggi derivati, successivamente inviati da un nodo di output nella stessa istanza del flusso di messaggi, sono inviati in modo transazionale, a meno che il nodo di output non abbia esplicitamente sovrascritto la transazionalità.
    • Se si seleziona No, il messaggio in entrata non è ricevuto nel punto di sincronizzazione. Tutti i messaggi derivati, successivamente inviati da un nodo di output nel flusso, sono inviati in modo non transazionale, a meno che il nodo di output non abbia specificato che il messaggio va inserito nel punto di sincronizzazione.
  4. Selezionare Convalida nel Navigator della finestra di dialogo delle proprietà se si desidera che il programma di analisi MRM convalidi il contenuto dei messaggi rispetto al dizionario generato dalla serie di messaggi. (Se un messaggio è trasmesso al terminale failure del nodo, non viene convalidato.)

    Per ulteriori dettagli fare riferimento a Convalida dei messaggi e Proprietà della convalida per i messaggi nel dominio MRM.

  5. Selezionare Opzioni generali messaggio nel Navigator della finestra di dialogo delle proprietà. Intervallo di analisi è, per impostazione predefinita, impostato su Su richiesta. Questo fa sì che la convalida venga ritardata fino al completamento dell'analisi parziale. Se si modifica in Immediata, l'analisi parziale viene sovrascritta e tutto il contenuto presente nel messaggio viene analizzato e convalidato, tranne i tipi complessi con una Composizione di Scelta o Messaggio, che non può essere risolta al momento. Se questa impostazione viene modificata in Completa, l'analisi parziale viene sovrascritta e tutto il contenuto del messaggio viene analizzato e convalidato; i tipi complessi con una Composizione di Scelta o Messaggio, che non possono essere risolti al momento, hanno come risultato un errore di convalida.
  6. Selezionare Descrizione nel Navigator della finestra di dialogo delle proprietà per immettere una descrizione breve, una descrizione completa o entrambe.
  7. Fare clic su Applica per effettuare le modifiche al nodo SCADAInput senza chiudere la finestra di dialogo delle proprietà. Fare clic su OK per applicare le modifiche e chiudere la finestra di dialogo delle proprietà.

    Fare clic su Annulla per chiudere la finestra di dialogo ed eliminare tutte le modifiche apportate alle proprietà.

Connessione dei terminali

SCADAInput instrada ogni messaggio che richiama con esito positivo al terminale out. Se questa operazione ha esito negativo, il messaggio è trasmesso al terminale failure; per gestire questa condizione si possono collegare nodi a questo terminale. Se il terminale failure non è stato connesso, il messaggio entra in loop continuo attraverso il nodo fino a quando non viene risolto il problema.

Se il messaggio viene rilevato da questo nodo dopo che è stata generata un'eccezione nel successivo avanzamento del flusso di messaggi, il messaggio viene instradato al terminale catch. Se il terminale catch non è stato connesso, il messaggio entra in loop continuo attraverso il nodo fino alla risoluzione del problema. Assicurarsi che sia sempre connesso un nodo a questo terminale se c'è la possibilità che il messaggio sia sottoposto a rollback all'interno del flusso di messaggi.

Configurazione delle transazioni coordinate

Quando si include un nodo SCADAInput in un flusso di messaggi, il valore impostato per Modalità transazione definisce l'eventuale ricezione dei messaggi nel punto di sincronizzazione:

  • Se si imposta su (valore predefinito), il messaggio è ricevuto nel punto di sincronizzazione (cioè, all'interno di un'unità di lavoro WebSphere MQ). Tutti i messaggi successivamente inviati da un nodo di output nella stessa istanza del flusso di messaggi, sono collocati nel punto di sincronizzazione, a meno che il nodo di output non abbia esplicitamente sovrascritto questa opzione.
  • Se si imposta su Automatico, il messaggio è ricevuto nel punto di sincronizzazione se il messaggio in entrata è contrassegnato come permanente. Altrimenti no. Tutti i messaggi successivamente inviati da un nodo di output sono collocati nel punto di sincronizzazione, come stabilito dalla proprietà di permanenza in entrata, a meno che il nodo di output non abbia esplicitamente sovrascritto questa opzione.
  • Se si imposta su No, il messaggio non è ricevuto nel punto di sincronizzazione. Tutti i messaggi successivamente inviati da un nodo di output nel flusso non sono inseriti nel punto di sincronizzazione, a meno che il nodo di output non abbia specificato che il messaggio debba essere inserito nel punto di sincronizzazione.

(Il nodo MQOutput è l'unico nodo di output che è possibile configurare per sovrascrivere questa opzione.)

Terminali e proprietà

I terminali del nodo SCADAInput sono descritti nella seguente tabella.

Terminale Descrizione
Failure Il terminale di output a cui è instradato il messaggio se si verifica un errore.
Out Il terminale di output a cui è instradato il messaggio se è richiamato con con esito positivo dalla coda.
Catch Il terminale di output a cui è instradato il messaggio se viene generata un'eccezione nel proseguimento dell'elaborazione e questo nodo la rileva.

Le seguenti tabelle descrivono le proprietà del nodo; la colonna con l'intestazione O indica se la proprietà è obbligatoria (contrassegnata con un asterisco nella finestra di dialogo delle proprietà, se è necessario immettere un valore quando non è specificato un valore predefinito), la colonna con l'intestazione C indica se la proprietà è configurabile (è possibile modificare il valore quando si aggiunge un flusso di messaggi a un file bar per distribuirlo).

Le proprietà base del nodo SCADAInput sono descritte nella seguente tabella.

Proprietà O C Valore predefinito Descrizione
Abilita listener all'avvio No Selezionata Quando è avviato il listener. Se si seleziona la casella di spunta, il listener si avvia quando il flusso di messaggi è avviato dal broker. Se si deseleziona la casella di spunta, il listener si avvia all'arrivo di un messaggio sulla porta specificata.
Porta 1883 La porta su cui il protocollo SCADA è in ascolto.
Numero massimo di thread 500 Il numero massimo di thread da avviare per il supporto alle unità SCADA.
Utilizza pool di thread Deselezionata Indica se utilizzare il pool di thread. Questa azione viene eseguita se si seleziona la casella di spunta.

Le proprietà Predefinite del nodo SCADAInput sono descritte nella seguente tabella.

Proprietà O C Valore predefinito Descrizione
Dominio messaggi No No   Il dominio che sarà utilizzato per analizzare il messaggio in entrata.
Serie di messaggi No No   Il nome o identificativo della serie di messaggi in cui è definito il messaggio in entrata.
Tipo messaggio No No   Il nome del messaggio in entrata.
Formato del messaggio No No   Il nome del formato fisico del messaggio in entrata.

La proprietà Avanzate del nodo SCADAInput è descritta nella seguente tabella.

Proprietà O C Valore predefinito Descrizione
Modalità transazione No Indica se il messaggio in entrata viene ricevuto nel punto di sincronizzazione. I valori validi sono Automatico, e No.

Le proprietà Convalida del nodo SCADAInput sono descritte nella seguente tabella.

Fare riferimento a Proprietà della convalida per i messaggi nel dominio MRM per una descrizione completa di queste proprietà.

Proprietà O C Valore predefinito Descrizione
Convalida Nessuno Indica se viene effettuata la convalida. I valori validi sono Nessuno, Contenuto e valore e Contenuto.
Azione in caso di errore No Eccezione Indica cosa accade se la convalida ha esito negativo. E' possibile impostare questa proprietà solo se si imposta Convalida su Contenuto o Contenuto e valore. I valori validi sono Traccia utente, Registrazione errori locale, Eccezione ed Elenco di eccezioni.
Includi tutti i vincoli valore No Selezionata Questa proprietà non può essere modificata. L'azione predefinita, indicata dalla casella di spunta selezionata, è che i controlli del vincolo del valore base sono inclusi nella convalida Contenuto e valore.
Correzione No Nessuno Questa proprietà non può essere modificata.

Le proprietà delle Opzioni generali messaggio per il nodo SCADAInput sono descritte nella seguente tabella.

Proprietà O C Valore predefinito Descrizione
Intervallo di analisi No Su richiesta Questa proprietà consente di controllare quando viene analizzato un messaggio di input. I valori validi sono Su richiesta, Immediata e Completa.

Fare riferimento ad Analisi su richiesta per una descrizione completa di questa proprietà.

Utilizza programma di analisi compatto MQRFH2C per il dominino MQRFH2 No No False Questa proprietà consente di controllare se viene utilizzato il programma di analisi compatto MQRFH2C, invece del programma di analisi MQRFH2, per le intestazioni MQRFH2.

Le proprietà delle Opzioni del programma di analisi XMLNSC per il nodo SCADAInput sono descritte nella seguente tabella.

Proprietà O C Valore predefinito Descrizione
Utilizza programma di analisi compatto XMLNSC per il dominio XMLNS Deselezionata No Inizio modificaTale proprietà consente di controllare se il programma di analisi XMLNSC viene utilizzato per messaggi nel dominio XMLNSC. Se si imposta questa proprietà, i dati del messaggio verranno visualizzati in XMLNSC nei nodi collegati al terminal dell'output quando l'intestazione RFH2 di input o il dominio di proprietà predefinito è XMLNS.Fine modifica
Modalità di mantenimento contenuto misto No Nessuno Questa proprietà controlla se il programma di analisi XMLNSC crea elementi nella struttura ad albero del messaggio quando rileva testo misto in un messaggio di input. I valori validi sono Nessuno e Tutti. La selezione del valore Tutti indica che gli elementi vengono creati per testo misto. La selezione del valore Nessuno indica che il testo misto viene ignorato e non viene creato alcun elemento.
Modalità di mantenimento commenti No Nessuno Questa proprietà controlla se il programma di analisi XMLNSC crea elementi nella struttura ad albero del messaggio quando rileva commenti in un messaggio di input. I valori validi sono Nessuno e Tutti. La selezione del valore Tutti indica che vengono creati elementi per i commenti. La selezione del valore Nessuno indica che i commenti vengono ignorati e non viene creato alcun elemento.
Modalità di mantenimento delle istruzioni di elaborazione No Nessuno Questa proprietà controlla se il programma di analisi XMLNSC crea elementi nella struttura ad albero del messaggio quando rileva istruzioni di elaborazione in un messaggio di input. I valori validi sono Nessuno e Tutti. La selezione del valore Tutti indica che vengono creati elementi per le istruzioni di elaborazione. La selezione del valore Nessuno indica che le istruzioni di elaborazione vengono ignorate e non viene creato alcun elemento.

Le proprietà Descrizione del nodo SCADAInput sono descritte nella seguente tabella.

Proprietà O C Valore predefinito Descrizione
Descrizione breve No No   Una breve descrizione del nodo.
Descrizione completa No No   Testo che descrive lo scopo del nodo nel flusso di messaggi.
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
ac04620_