Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.
DYNAMIC_INFOPríkaz pre procesy s menom *.EVH a *.HIS.
Tell príkaz je bez parametrov.

Po jeho prijatí proces do príslušného log súboru zapíše informácie o:

- zozname všetkých bežiacich inštancií ESL skriptov
Formát: ESL;ESL name

ESL - text identifikujúci nasledujúce informácie
ESL name - identifikácia skriptu1

- registrovaných textových reťazcoch (akcia GETACCESS)
Formát: ACCESS;ESL name;String;time of GetAccess;bGlobal;userComment;status

ACCESS - text identifikujúci nasledujúce informácie
ESL name - identifikácia skriptu1
String - registrovaný textový reťazec
time of GetAccess - čas, kedy prebehla registrácia reťazca
bGlobal - príznak, či je reťazec globálny
userComment - komentár
status - text "IN PROGRESS", ak prebieha registrácia globálneho reťazca, inak prázdny text ""

- zozname všetkých otvorených XML dokumentov (%XML_CreateDocument, %XML_OpenDocument)
Formát: XML;ESL name;handle

XML - text identifikujúci nasledujúce informácie
ESL name - identifikácia skriptu 1
handle - jednoznačný číselný identifikátor XML dokumentu; je zhodný s hodnotou handle, ktorú používajú funkcie %XML_* 

- zozname objektov, ktoré boli otvorené prostredníctvom funkcie %OpenRefToObject
Formát: REFOBJ;Esl Name;Synchro;Obj HOBJ;Obj Name;Open In Progress

REFOBJ - text identifikujúci nasledujúce informácie
ESL name - identifikácia skriptu1
Synchro - hodnota parametra _bSynchro pri volaní funkcie %OpenRefToObject
Obj HOBJ - jednoznačný identifikátor otvoreného objektu
Obj Name - jednoznačné meno otvoreného objektu
Open In Progress - príznak, či aktuálne prebieha otváranie objektu

-zozname aktívnych databázových pripojení (prostredníctvom akcií DB_TRANS_OPEN, DB_CONNECT, PG_CONNECT, SQL_CONNECT)Formát: DBCONNECT;ESL name;DB TRANS HANDLE;SUB CONNECT HANDLE;TYPE;OBJNAME;Prepared SQL Command;Last SQL Prepare; Comment

DBCONNECT - text identifikujúci nasledujúce informácie
ESL name - identifikácia skriptu1
DB TRANS HANDLE - identifikátor transakčného pripojenia (vzniká volaním DB_TRANS_OPEN), alebo 0, ak príslušné pripojenie nie je realizované transakčne
SUB CONNECT HANDLE - identifikátor pripojenia (vzniká volaním akcií DB_CONNECT, PG_CONNECT, SQL_CONNECT)
TYPE - typ pripojenia (SUB CONNECT HANDLE)
OBJNAME - meno objektu, ku ktorému je pripojenie realizované
Prepared SQL Command - príznak existencie predpripraveného SQL príkazu
Last SQL Prepare - "znenie" posledného SQL príkazu predpripraveného volaním akcie SQL_PREPARE
Comment - miesto, kde bola volaná akcia SQL_PREPARE

- zoznam súborov otvorených prostredníctvom funkcií %FIO_*
Formát: FIO;ESL name;file name

FIO - - text identifikujúci nasledujúce informácie
ESL name - identifikácia skriptu1
file name - meno súboru

- zoznam vytvorených dátových kontainerov (akcia CNT_CREATE)
Formát: CNT;ESL name;handle;NR;valTyp;is array

CNT - text identifikujúci nasledujúce informácie
ESL name - identifikácia skriptu1
handle - jednoznačný číselný identifikátor dátového kontajnera
NR - počet prvkov
valTyp - typ kľúča, ktorý jednoznačne identifikuje položky v kontajneri
is array - príznak, či je na príslušný kontajner aplikovaná akcia CNT_CNVTOARRAY

1 - identifikácia skriptu: Textový reťazec, ktorý jednoznačne identifikuje bežiaci ESL skript. Obsahuje meno objektu (HOBJ)[číslo inštancie] jednoznačný číselný identifikátor.
Napríklad: E.Script(728)[105]1872
(%GetSelfInstanceId, %GetSelfHBJ)

SHOW_TRANS_LIST idInstanceAk je idInstance = 0, príkaz zobrazí zoznam všetkých inštancií eventov, ktoré čakajú na dokončenie transakcie, a zoznam transakcií. Ak je idInstance <> 0, príkaz zobrazí informáciu len o zadanej inštancii (zoznam inštancií je možné získať napríklad v dialógovom okne ESL Diagnostic Pack alebo tell príkazom TASK_STATUS).
STATISTICS path+filenameZapíše do súboru údaje o konzumácii času procesora podľa jednotlivých eventov.
STDOUT outputPríkaz presmeruje štandardný výstup na nový výstup.

Príklad:
D2000 na OpenVMS platforme: STDOUT "_TNA2:" (výstup presmerovaný na terminál _TNA2:)
D2000 na Windows platforme: STDOUT C:\vystup.txt (výstup presmerovaný do súboru vystup.txt)
Pozn: viď poznámku k príkazu STDOUT pre archív.

TASK_STATUS path+filenameZapíše do súboru aktuálne vykonávaný riadok všetkých skriptov bežiacich v danom procese (*.EVH alebo *.HIS). Zároveň poskytne informáciu o tom, či ESL skript aktuálne vykonáva externú funkciu. Ak áno, tak do súboru zapíše jej meno a číslo riadku v skripte, ktorý ju volá.
ON_CHANGE_INFO [idInstance]Príkaz do log súboru zapíše všetky aktívne ESL akcie ON CHANGE v rámci procesu. Ak je zadaný nepovinný parameter idInstance, vypíšu sa len akcie danej inštancie ESL skriptu (idInstance popísaný v ESL Diagnostic Pack záložka Event Instances).

...

Príklad:
D2000 na OpenVMS platforme: STDOUT "_TNA2:" (výstup presmerovaný na terminál _TNA2:)
D2000 na Windows platforme: STDOUT C:\vystup.txt (výstup presmerovaný do súboru vystup.txt)
Pozn: viď poznámku k príkazu STDOUT pre archív.

...

Príkaz slúži na zistenie dôvodu prepočtu počítaného bodu, ktorý má parameter Spôsob prepočtu nastavený na hodnotu Pri zmene alebo Trigger.

Príkaz zabezpečí (CALCINFO ON), že do LOG súboru procesu budú priebežne zapisované informácie o dôvode prepočtu daného počítaného bodu. Príkaz CALCINFO OFF ukončí priebežný zápis do LOG súboru. Používa sa pre počítané body, ktoré majú parameter Spôsob prepočtu nastavený na hodnotu Pri zmene alebo Trigger.

Záznam v LOG súbore obsahuje:

  • identifikáciu objektu, ktorý spôsobil prepočet a jeho hodnotu
  • výstupnú hodnotu počítaného bodu, ktorá bola odoslaná na server

Parametre:

clcName - meno počítaného bodu

row - špecifikuje číslo riadku pri štruktúrovanom počítanom bode. Ak nie je zadaný, náhradná hodnota je 0 a sledované budú všetky riadky.

Príklad (obsah LOG súboru):

Tell príkaz: CALCINFO ON P.OnSec

V LOG súbore vidieť záznam o tom, že informácie sú o prepočte počítaného objektu P.OnSec. Zmenila sa hodnota objektu z HOBJ=20 (VALUE IN $20). Ďalej sú zobrazené jednotlivé atribúty vstupnej hodnoty. Atribúty výstupnej hodnoty sú zobrazené za riadkom s obsahom VALUE OUT.

Blok kódu
CALCINFO: P.OnSec[ 0]
VALUE IN $20
GValTyp : INT (Integer)
Status : VALID
LimitStatus : INLIMIT
ProcAlarmStatus : NOALARM
ValTyp : INT
Flags : F,F,F,F,F,F,F,F,F,F,F,F,F,F,F,F
ValTime : 20.11.2017 16:39:59.000
AlarmTime : (null)
Value : 59
VALUE OUT
GValTyp : INT (Integer)
Status : VALID, NOACKVALUE
LimitStatus : INLIMIT
ProcAlarmStatus : NOALARM
ValTyp : CE
Flags : F,F,F,F,F,F,F,F,F,F,F,F,F,F,F,F
ValTime : 20.11.2017 16:39:59.001
AlarmTime : (null)
Value : 60

...

MONITOR_TRANS SHOW {ALL/<id>} [<file_path>]

MONITOR_TRANS ON <history_depth_sec>

MONITOR_TRANS OFF

MONITOR_TRANS RESET

...

Stĺpce vo výpise:
- ID (identifikátor transakcie)
- time, task, traceback (čas poslednej operácie v skupine totožných operácií, task, traceback v internom kóde)
- comment, count (posledný komentár a počet za sebou idúcich totožných operácií) (totožná operácia je operácia s rovnakým task-om a traceback-om)

Poznámka: Po spustení procesu DBManager je monitorovanie vypnuté.

...

MONITOR_CONNECTS SHOW {ALL/<id>} [<file_path>]

MONITOR_CONNECTS ON <history_depth_sec>

MONITOR_CONNECTS OFF

MONITOR_CONNECTS RESET

...

Stĺpce vo výpise:
- ID (pomocný identifikátor spojenia)
- logon_time, logon_task, logon_traceback (čas pripojenia, task a traceback v internom kóde)
- logoff_time, logoff_task, logoff_traceback (čas odpojenia, task a traceback v internom kóde)
- comment (naposledy zapísaný komentár pre dané spojenie, napríklad traceback v ESL kóde)

Poznámka: Po spustení procesu DBManager je monitorovanie zapnuté s časovou hĺbkou histórie uzavretých spojení nastavenou na 3 hodiny (10 800 sekúnd).

...

Príkaz umožňuje zatvoriť a znovu otvoriť spojenia na databázu, ktoré práve nie sú používané (nie je v rámci nich rozrobená transakcia alebo používaný kurzor).

Pozn: Tento príkaz bol implementovaný kvôli práci s dočasnými tabuľkami (temporary tables) v PostgreSQL. Tieto zaniknú až po skončení databázového spojenia a kým existujú, dáta v nich nie sú viditeľné mimo databázového spojenia, ktoré ich vložilo, takže k nim nemá prístup vacuum a preto môže dôjsť k vyčerpaniu vnútorných transakčných ID, ak je nejaké spojenie dlho otvorené.

...

Príkaz spôsobí vykonanie SQL príkazu DISCARD TEMPORARY v PostgreSQL databáze so špecifikovaným menom/ID na všetkých spojeniach, prípadne na konkrétnom.

Pozn: Tento príkaz bol implementovaný kvôli práci s dočasnými tabuľkami (temporary tables) v PostgreSQL. Tieto zaniknú až po skončení databázového spojenia a kým existujú, dáta v nich nie sú viditeľné mimo databázového spojenia, ktoré ich vložilo, takže k nim nemá prístup vacuum a preto môže dôjsť k vyčerpaniu vnútorných transakčných ID, ak je nejaké spojenie dlho otvorené.

...

GETOLDVAL remoteObjectMask "BeginTime" ["EndTime"] [NORECALC]

GETOLDVAL "remoteTagName[row]^item" "BeginTime" ["EndTime"] [NORECALC]

...

Tretí zápis umožňuje čiastkové dočítanie hodnôt pri prenose hodnôt štruktúrovaných objektov. Parameter item určuje stĺpec z cieľovej štruktúry (viď parameter Cieľová štruktúra v konfigurácii vzdialeného objektu) a musí byť zadaný v úvodzovkách. Ak je potrebné dočítať práve jeden riadok (stĺpec), je možné použiť nasledovný zápis:

  • dočítanie riadku 10 - GETOLDVAL "RemoteTagName[10]" …
  • dočítanie stĺpca s menom Values - GETOLDVAL "RemoteTagName[0]^Values"

...

Debug Info pre vzdialené objekty - zapnutie / vypnutie zobrazovanie informácií o spracovaní hodnôt objektov s uvedeným HOBJ, resp. s menom vyhovujúcim udanej maske.

Poznámka: ak beží gateway klient v móde transparentného gatewaya, na zobrazenie informácií o hodnotách použite tell príkaz TRGTW.

...

Info
titleSúvisiace stránky:

D2000 Tell
Práca s procesom D2000 Tell