SGCom je navrhnutý tak, aby bol odolný voči rôznym formám výpadkov. Pri svojom štarte sa musí pripojiť k centrále, aby získal konfiguráciu (bez ktorej nevykoná žiadnu akciu), ale potom môže pracovať aj v prípade, že stratí s centrálou na nejaký čas kontakt. Je robustný aj v prípade, že nedokáže vykonať zber dát, o čom informuje centrálu a poskytuje mechanizmy, ako neskôr dáta opätovne získať. Životný cyklus ilustruje nasledujúci obrázok a možno ho tiež popísať v nasledovných krokoch.
...
is designed to be resilient to various forms of outages. When it starts, it must connect to the metering central to get the configuration (without which it will not perform any action), but then it can work even if it loses contact with the metering central for some time. It is robust even if it fails to collect data, which it reports to the metering central and provides mechanisms to recover the data later. The life cycle is illustrated in the following figure and can also be described in the following steps.
Figure 3 - Illustration of the life cycle
- Starting the application, processing the command line parameters, which, among other things, contain the address for connecting to the D2000 kernel, login data, and the address of the so-called "point of first contact".
- Performing maintenance on the DataStorage module:
Deleting records older than 90 days. The task repeats every 24 hours.
Removing the transaction number tag from all records (details in step 7).
Connection to the D2000 kernel of the headquarters. SGCom tries to get a D2Japi Session, which will be represented in DODM by an object with a name of the form SGCOM1.SGC. If unsuccessful, the connection is retried every 30 seconds.
Signing in to the "point of first contact" The address of the object is defined by the -f command-line parameter, which is an instance of an object of type D2000 Event that implements the I.SGC_FirstContactServer interface. It signs in by calling RPC SignIn with the _name parameter value set to the process name (from command line).RPC is asynchronous and establishes an application-driven transaction that ensures that either SGCom or HQ knows when its partner crashes.
The center responds to the establishment of the first contact by sending a new configuration to SGCom, or changes the existing one. The D2000 Event that controls sending the configuration must implement the I.SGC_Configurator interface, SGCom implements the I.SGC_Configurable interface for reception.
Configuration transfer is transactional. All changes are either OK and accepted as a whole, or all are rejected and the configuration is left in its original state. The sequence of steps is as follows:
Open Transaction: I.SGC_Configurable^OpenTransaction
Submit changes: I.SGC_Configurable^Set* and Delete*.
Commands must be entered in such a sequence that the referential integrity of the configuration database is not violated at any time.
Commit transaction: I.SGC_Configurable^Commit
Confirmation of acceptance of changes I.SGC_Configurator^OnTransactionAccepted, or rejection of changes I.SGC_Configurator^OnTransactionDenied with a list of errors in the parameter.
Alternatively, the transaction can be rolled back from the HQ by calling I.SGC_Configurable^Rollback, which SGCom will confirm with I.SGC_Configurator^OnTransactionRolledBack. The transaction is automatically canceled even if the application-driven conversation is interrupted.
According to the current SGCom configuration, SGCom sets its task schedule - for each PeriodicEvent entity, it creates a separate record and schedules its execution.
- Štart aplikácie, spracovanie parametrov príkazového riadku, ktoré okrem iného obsahujú adresu pre pripojenie sa ku D2000 kernelu, prihlasovacie údaje a adresu tzv. „bodu prvého kontaktu".
- Vykonanie údržby modulu DataStorage:
- Vymazanie záznamov starších ako 90 dní. Úloha sa opakuje každých 24 hodín.
- Odstránenie označenia číslom transakcie zo všetkých záznamov (podrobnosti v kroku 7).
- Pripojenie ku D2000 kernelu centrály. SGCom sa pokúša získať D2Japi Session, ktorá bude v DODM reprezentovaná objektom s názvom v tvare SGCOM1.SGC. V prípade neúspechu sa pokus o pripojenie opakuje každých 30 sekúnd.
- Prihlásenie sa do „bodu prvého kontaktu" Adresa objektu je definovaná parametrom z príkazového riadku –f., čo je inštancia objektu typu D2000 Event, ktorá implementuje rozhranie I.SGC_FirstContactServer. Prihlási sa volaním RPC SignIn s hodnotou parametra _name nastavenou na meno procesu (z príkazového riadku). RPC je asynchrónne a zakladá aplikačne riadenú transakciu, ktorá zabezpečí, že sa buď SGCom alebo centrála dozvie, keď jej partner havaruje.
- Centrála na nadviazanie prvého kontaktu reaguje tým, že odošle do SGCom-u novú konfiguráciu, resp. zmení existujúci. D2000 Event, ktorý riadi zasielanie konfigurácie musí implementovať rozhranie I.SGC_Configurator, SGCom pre prijatie implementuje rozhranie I.SGC_Configurable.
- Prenos konfigurácie je transakčný. Všetky zmeny sú buď v poriadku a prijaté ako celok, alebo sú všetky zamietnuté a konfigurácia je ponechaná v pôvodnom stave. Postupnosť krokov je nasledovná:
- Otvorenie transakcie: I.SGC_Configurable^OpenTransaction
- Odoslanie zmien: I.SGC_Configurable^Set* a Delete*.
- Príkazy je nutné zadávať v takom poradí, aby nebola v žiadnom okamihu porušená referenčná integrita konfiguračnej databázy.
- Commit transakcie: I.SGC_Configurable^Commit
- Potvrdenie prijatia zmien I.SGC_Configurator^OnTransactionAccepted, alebo zamietnutie zmien I.SGC_Configurator^OnTransactionDenied so zoznamom chýb v parametri.
- Alternatívne môže byť transakcia zrušená zo strany centrály volaním I.SGC_Configurable^Rollback, čo SGCom potvrdí I.SGC_Configurator^OnTransactionRolledBack. Transakcia je automaticky zrušená aj v prípade, že sa preruší aplikačne riadená konverzácia.
- Prenos konfigurácie je transakčný. Všetky zmeny sú buď v poriadku a prijaté ako celok, alebo sú všetky zamietnuté a konfigurácia je ponechaná v pôvodnom stave. Postupnosť krokov je nasledovná:
- SGCom podľa aktuálnej konfigurácie SGCom nastaví svoj harmonogram úloh – pre každú entitu PeriodicEvent vytvorí zvlášť záznam a naplánuje jej vykonanie.
- Keď nastane časový okamih, na ktorý je naplánovaná periodická udalosť, SGCom prezrie aktuálnu konfiguráciu a začne vykonávať všetky súvisiace úlohy. Do modulu TaskExecutor vloží do príslušných front úlohy na zber a odovzdávanie dát, ktoré TaskExecutor následne vykoná. Vykonanie úloh, ktoré si vzájomne nekonkurujú je paralelné. (Pozn.: vzájomne si konkurujú dve úlohy, ktoré sú vykonané na tom istom logickom zariadení a tiež úlohy, ktoré obsluhujú logické zariadenia pripojené tou istou komunikačnou linkou. Zber a odovzdávanie dát si vzájomne nekonkuruje.)
Zber dát každej jednej veličiny, či už úspešný alebo neúspešný, končí tým, že je výsledok zaznamenaný do modulu DataStorage. Pri úspešnom zbere je to zoznam hodnôt s časovými značkami, pri neúspešnom je to kód a popis chyby, tiež s časovou značkou.
Odovzdanie hodnôt centrále prebieha po jednotlivých logických zariadeniach a jednotlivých veličinách (DataPoint). Každé odovzdanie predstavuje samostatnú transakciu a až keď centrála potvrdí úspešné prevzatie hodnôt, sú dáta odstránené z DataStorage. Odovzdanie pre jedno logické zariadenie a veličinu pozostáva z nasledujúcich krokov:- Vygenerovanie unikátneho ID transakcie.
- Všetky záznamy pre dané logické zariadenie a veličinu sú označené číslom transakcie. (V prípade, že predchádzajúca transakcia neskončila, sú označené len nové záznamy.)
- Hodnoty a časové značky označených záznamov sú odoslané volaním I.SGC_DataCollector^OnDataCollected.
- Po spracovaní dát je transakcia ukončená volaním I.SGC_DataProducer^OnDataAccepted.
- Záznamy označené príslušným číslom transakcie sú vymazané z DataSorage-u.
(Pozn.: RPC komunikácia prebieha v rámci aplikačne riadenej transakcie, takže ak spracovanie odovzdaných dát z nejakého dôvodu zlyhá, SGCom sa túto skutočnosť dozvie a transakcia sa zruší. Dáta zostanú v DataStorage-i do nasledujúceho plánovaného odovzdávania dát a označenie číslom transakcie sa odstráni.)
- Centrála môže kedykoľvek po odoslaní konfigurácie zadať príkaz na vykonanie „okamžitej" úlohy. Najčastejšie sa vykonáva čítanie archivovaných dát meraných veličín za obdobie, pre ktoré v centrále chýbajú dáta, ale tiež nastavenie presného času v meračoch a iné. Príkazy sú riadené párovými rozhraniami I.SGC_ImmediateReadMaster – Slave, I.SGC_SetRTCMaster – Slave, I.SGC_ConsumerDisconnectMaster – Slave, kde centrála implementuje Master rozhranie a SGCom implementuje Slave. Všetky príkazy prebiehajú v režime aplikačne riadených konverzácií ale vždy pozostávajú len s jednoduchej výmeny príkaz – oznámenie výsledku.
- Ak SGCom stratí spojenie s centrálou, naďalej pokračuje vo vykonávaní plánovaných úloh, ako je popísané v bode 7. Zber dát prebieha bez zmeny, všetky pokusy o odovzdanie zlyhajú a zozbierané dáta sa preto zhromažďujú v DataStorage-i až dovtedy, kým sa nepodarí spojenie obnoviť a dáta odovzdať. Po nadviazaní nového spojenia pokračuje vykonávanie bodom 4.
...