Pre diagnostiku a prípadne zmenu nastavení bežiacej SGCom inštancie je možné použiť príkazy odoslané zo systémovej konzoly D2000 subsystémom Runtime intercom. Aby dostupné rozhranie pre zadávanie príkazov, je potrebné spustiť systémovú konzolu s parametrom z príkazového riadku /ARTI.
sysconsole.exe /ARTI
Rozhranie sa otvára z kontextovej ponuky k danému procesu
V rozhraní je nutné vybrať príkaz v tvare JAPI::<instanceName>(HOBJ).
Do parametra príkazu sa píše úloha, ktorú má vybraná inštancia SGCom-u vykonať. O výsledku príkazu sa cez rozhranie nedozviete. Výsledok je zapísaný jedine do LOG-u.
Príkaz SetLogLevel – zmena úrovne podrobnosti LOG-u
Umožňuje zmeniť úroveň podrobnosti zaznamenávania správ do LOG-u počas behu aplikácie, pretože zo súboru z nastaveniami sa načítajú iba raz pri štarte. Príkaz má tvar:
SETLOGLEVEL <subsystem> <level>
Nasleduje príklad príkazu, ktorým sa nastaví úroveň INFO do subsystému sk.ipesoft.sgcom.hdlc.
SETLOGLEVEL sk.ipesoft.sgcom.hdlc INFO
Príkaz Show – komplexná analýza konfigurácie
Umožňuje získať prehľadný výpis o zvolenej časti konfigurácii. Aktuálne je podporené zobrazenie konfigurácie pre logické zariadenie podľa jeho ID.
Príkaz v uvedenom príklade spôsobí výpis pre zariadenie 3.
SHOW CONFIG LD 3
Nahradením ID za kľúčové slovo ALL spôsobí výpis konfigurácie všetkých zariadení do súboru v adresári LOG. Príklad:
SHOW CONFIG LD ALL
Výpis obsahuje konfiguráciu entity LogicalDevice ako aj príslušných PhysicalDevice a Connector a hierarchicky tiež súvisiacich DataPointSet-ov a do nich zaradených DataPoint-ov, aj s ich plánovanými zbermi a odovzdávaniami.
Príkaz DUMP CONFIG - kompletný výpis obsahu konfiguračnej databázy do súboru
Umožňuje získať snapshot obsahu databázy do súboru v adresári LOG. Príklad:
DUMP CONFIG
Príkaz IMMEDIATE READ ANY - okamžité čítanie ľubovoľnej hodnoty z elektromera
Príkaz má tvar IMMEDIATE READ ANY conversionType deviceId obis classId attributeId
- converstionType = definuje typ konverzie prečítanej hodnoty. Môže byť jeden z:
- bool - logická hodnota
- integer - celočíselná hodnota (aj enum)
- real - hodnota s plávajúcou čiarkou
- text - textový reťazec
- raw - hodnota bez konverzie - vhodné pre štruktúrované hodnoty
- deviceId - číselné ID logického zariadenia podľa konfigurácie
- obis - OBIS kód čítaného COSEM objektu
- classID - číselné ID COSEM triedy čítaného objektu
- attributeID - číselné ID COSEM atribútu čítaného objektu
Príklad: čítanie jednoznačného identifikátora merača, ktorý je v konfigurácii ako logické zariadenie s ID = 10.
IMMEDIATE READ ANY text 10 0.0.42.0.0.255 1 2
Príklad: čítanie stĺpcov v LoadProfile 1 (obis=1.0.99.1.0.255, classId = 7, attributeId = 3) z logického zariadenia 10
IMMEDIATE READ ANY raw 10 1.0.99.1.0.255 7 3
Príkaz IMMEDIATE READ PROFILE - okamžité čítanie z profilu
Príkaz má tvar IMMEDIATE READ PROFILE deviceId datapointId beginTime endTime
- deviceId - číselné ID logického zariadenia podľa konfigurácie
- datapointId - číselné ID entity DataPoint, ktorá definuje čítaný objekt
- beginTime - začiatok čítaného intervalu v UTC tvare yyyy-mm-ddThh:mi:ss.s1000Z (napr. 2007-12-03T10:15:30.00Z)
- endTime - koniec čítaného intervalu.
Pozn. ktorá z hraníc beginTime, endTime je súčasťou čítaného intervalu závisí od implementácie konkrétneho elektromera.
Príklad čítania z logického zariadenia 10, datapointId -178
IMMEDIATE READ PROFILE 31 -148 2018-08-25T00:00:00.000Z 2018-08-25T12:00:00.000Z
Príkaz IMMEDIATE READ R6 - čítanie špecifických dát cez protokol IEC21
Príkaz je univerzálny pre čítanie metadát o profiloch cez protokol IEC21.
Príkaz má formát IMMEDIATE READ R6 deviceId request
Príklad čítania hlavičky