Vidíte historickú verziu tejto stránky. Pozrite si aktuálnu verziu.

Porovnať s aktuálnou verziou Zobraziť históriu stránky

Verzia 1 Aktuálny »

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).


D2000 CALC

DP ON/OFFDebug Pipe - zapnutie / vypnutie zobrazovania komunikácie s procesom D2000 Calc (len vtedy, ak je okno procesu zobrazené na pracovnej ploche).
RESET_STATISTICSVynulovanie počítadiel pre vyhodnotenie štatistických údajov.
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.

CALCINFO ON|OFF clcName [row]

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.

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
STATISTICS path+filenameZapíše do súboru štatistické údaje o jednotlivých počítaných bodoch. Súbor obsahuje nasledovné informácie: meno počítaného bodu, počet prepočtov a počet nových hodnôt vyslaných do systému. Počítadlá sú vynulované pri štarte procesu D2000 Calc alebo použitím povelu RESET_STATISTICS

CHECK_DESTID_VALUES [DestId [ColIndex]] [FlagList]

Umožní porovnať hodnoty cieľových stĺpcov (štruktúrovaných premenných) nakonfigurovaných v počítaných bodoch s hodnotami, ktoré boli vypočítané procesom D2000 Calc.

Pre špecifikáciu konkrétneho objektu typu Štruktúrovaná premenná, pre ktorý sa má porovnanie vykonať, je potrebné zadať nenulovú hodnotu parametra DestId, prípadne aj nenulové ColIndex pre konkrétny stĺpec. Nasledujú nepovinné kľúčové slová zo zoznamu: Detail, Debug, Ignore_Time, ReCalc0s, ReCalc1m.
Bližší popis je uvedený v kontrole hodnôt cieľových stĺpcov.

Poznámka: Príkaz je určený hlavne pre diagnostické účely v systémoch D2000.

SHOW_DYN_INFO {Mask|HOBJ} [Row]

Umožní zobraziť konfiguráciu a aktuálny stav konkrétneho počítaného bodu. Ten je zadaný ako vstupný parameter buď cez jeho ID (HOBJ) alebo masku. V prípade, ak maske vyhovuje viacero počítaných bodov, zobrazí prvých 20. Ak je zadaný parameter Row odlišný od 0, musí sa jednať o počítaný bod, ktorý svoje hodnoty zapisuje do cieľového stĺpca štruktúrovanej premennej. Pri bežných počítaných bodoch (tie, čo nemajú nastavený cieľový stĺpec), musí byť Row nulový.

Formát výpisu je zhodný s formátom [Calc] v 3. príklade kontroly hodnôt cieľových stĺpcov.

Poznámka: Príkaz je určený hlavne pre diagnostické účely v systémoch D2000.
GET_SOURCE_VALUE HOBJ Row ColUmožní zobraziť vstupy do výpočtu, pokiaľ sa jedná o vstupy zo štruktúrovaných premenných.

Formát výpisu je zhodný s formátom [DestVal] 3. príklade kontroly hodnôt cieľových stĺpcov.

Poznámka: Príkaz je určený hlavne pre diagnostické účely v systémoch D2000.


D2000 DBMANAGER

SHOW_HANDLE [table/database/structure_definition HOBJ] or [table mask]Zobrazenie informácií o otvorených deskriptoroch. Viac informácií - kapitola DBManager - ladenie a debugovanie.
SHOW_CONNECT [database HOBJ [connect/transaction ID]] or [database mask [connect ID]] [DETAIL]Zobrazenie informácií o otvorených spojeniach. Viac informácií - kapitola DBManager - ladenie a debugovanie.
SET_WATCHDOG database_mask seconds [NONTRANS]Zapnutie sledovania spojení, ktoré vykonávajú SQL príkazy dlhšie, ako je zadaný čas seconds. Táto informácia je použiteľná na profilovanie aplikácie a zisťovanie najpomalších SQL príkazov. V prípade zadania klauzuly NONTRANS sa nesledujú transakčné spojenia.
Po skončení dlhotrvajúceho SQL príkazu sa vypíšu do logu podrobnosti o SQL príkaze.
Viac informácií - kapitola DBManager - ladenie a debugovanie.
SET_WATCHDOG_QUEUE database_mask seconds [NONTRANS]Zapnutie sledovania databázových akcií, ktorých vykonávanie (včítane času stráveného vo frontách DBManagera) dlhšie, ako je zadaný čas seconds.
Po skončení takejto databázovej akcie sa do logu vypíšu podrobnosti o nej. V prípade zadania klauzuly NONTRANS sa nesledujú transakčné spojenia.
Viac informácií - kapitola DBManager - ladenie a debugovanie.

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

MONITOR_TRANS ON <history_depth_sec>

MONITOR_TRANS OFF

MONITOR_TRANS RESET

Mechanizmus monitorovania transakcií.

ON - zapína monitorovanie, kde <history_depth_sec> predstavuje časovú hĺbku histórie uzavretých transakcií
OFF - vypína monitorovanie
RESET - premaže zoznam transakcií (aj otvorených)
SHOW - vypíše celý zoznam transakcií aj s históriou (ALL) alebo konkrétnu transakciu (<id>) na konzolu alebo do súboru <file_path> v CSV formáte s oddeľovačom ";"

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

Mechanizmus monitorovania spojení.

ON - zapína monitorovanie, kde <history_depth_sec> predstavuje časovú hĺbku histórie uzavretých spojení
OFF - vypína monitorovanie
RESET - premaže zoznam spojení (aj otvorených)
SHOW - vypíše celý zoznam spojení aj s históriou (ALL) alebo konkrétne spojenie (<id>) na konzolu alebo do súboru <file_path> v CSV formáte s oddeľovačom ";"

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).

REFRESH_TABLES secondsPríkaz je určený pre použitie na platforme PostgreSQL. Slúži na zatvorenie a znovuotvorenie kurzorov používaných pri stránkovom prístupe k tabuľkám, aby neblokovali vacuumovanie tabuliek, ak sú tieto kurzory otvorené príliš dlho. Typicky sa jedná o schémy s browsermi, ktoré sú napr. niekoľko dní otvorené. Parameter seconds je minimálny vek kurzora v sekundách, ktorý má byť znovuotvorený (napr. 86400).
TIME_STATISTICS database_mask [DETAIL]Zobrazenie štatistiky trvania jednotlivých typov databázových akciá pre jednotlivé databázy alebo pre jednotlivé tabuľky (pokiaľ je špecifikovaný parameter DETAIL).
Viac informácií - kapitola DBManager - ladenie a debugovanie.
REOPEN_CONNECT [database_HOBJ [connect_ID]]
REOPEN_CONNECT[database_mask [connect_ID]]

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é.

DISCARD_TEMPORARY database_HOBJ [connect_ID]
DISCARD_TEMPORARY database_mask [connect_ID]

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é.


D2000 ALARM

DI ON/OFF [HOBJ/mask]Debug Info pre alarmy - zapnutie/vypnutie zobrazovanie informácií o vyhodnocovaní alarmových objektov s uvedeným HOBJ, resp. s menom vyhovujúcim udanej maske. Pokiaľ nie je uvedené meno ani maska, zapne / vypne sa zobrazovanie informácií pre všetky alarmové objekty.
SHOW_DYN_INFO HOBJ / mask
Príkaz vypíše dynamické informácie o špecifikovanom alarmovom objekte/objektoch na textovú konzolu procesu D2000 Alarm.
Poznámka: Príkaz je určený hlavne pre diagnostické účely v systémoch D2000.


D2000 TOPOLOGY

SHOW_TOPOLOGY HOBJ or topology_name [DETAIL]Zobrazenie informácií o topológii. Viac informácií - kapitola Topológia - Debugovanie topológie.
DEBUG_TOPOLOGY HOBJ or topology_mask ON/OFFZapnutie/vypnutie vypisovania podrobných informácií o prepočítavaní topológie. Viac informácií - kapitola Topológia - Debugovanie topológie.
SHOW_ASYMETRIC TERMINALS or TRANSFORMERS [topology_mask]Vypísanie asymetrických vývodov alebo transformátorov v topológii. Viac informácií - kapitola Topológia - Debugovanie topológie.


D2000 GateWay Client

GETOLDVAL remoteTagName "BeginTime" ["EndTime"] [NORECALC]

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

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

Dočítanie hodnôt vzdialeného objektu z daného intervalu. Ak nie je zadaný parameter EndTime, ako náhradná hodnota sa použije aktuálny čas.
Formát času ("BeginTime", "EndTime") je "dd-mm-rrrr hh:mi:ss".

Príkaz je vhodné použiť napr. po výpadku alebo odstávke aplikácie, ku ktorej proces D2000 GateWay Client patrí. Spôsobí prenos hodnôt z archívu vzdialenej aplikácie do archívu aplikácie. Podmienkou dočítania hodnôt je, že vo vzdialenej aplikácii boli príslušné hodnoty archivované.

Prvý zápis príkazu dočíta všetky hodnoty, ktoré daný vzdialený objekt prenáša (aj štruktúrované objekty).

Druhý zápis príkazu dočíta všetky hodnoty viacerých objektov podľa masky.

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"

Tell príkaz musí byť vždy vykonávaný v transakčnom režime - akcia COMMAND (v rámci procesu D2000 System Console je príkaz transakčne vykonávaný automaticky). Po jeho ukončení sú prenesené hodnoty zapísané do archívu a zároveň sa vykoná prepočet súvisiacich štatistík.

Príkaz GETOLDVAL môže mať na konci parameter NORECALC. V takomto prípade proces D2000 Archiv nebude spätne vykonávať prípadné štatistické výpočty.

DI ON/OFF [HOBJ/mask]

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.

SHOW_DYN_INFO HOBJ / mask
Príkaz vypíše dynamické informácie o špecifikovanom vzdialenom objekte/objektoch na textovú konzolu procesu D2000 Gateway.
Poznámka: Príkaz je určený hlavne pre diagnostické účely v systémoch D2000.
TRGTWLadiaci príkaz pre mód transparentného gatewaya. Príkaz vypíše zoznam mien objektov, ich HOBJ na lokálnom aj vzdialenom systéme.
START_RECORD dir_name_only [begin_time] end_timeSpustí nahrávanie hodnôt čítaných z GateWay Servera. Pre detaily viď popis príkazu pre proces D2000 KOM.
Poznámka: nahrané hodnoty môžu byť prehrávané D2000 KOM procesom, pokiaľ počas nahrávania beží  GateWay Klient v móde transparentného gatewaya.
STOP_RECORDOkamžite zastaví nahrávanie hodnôt čítaných z GateWay Servera. Pre detaily viď popis príkazu pre proces D2000 KOM.
START_REPLAY dir_name_only [begin_time [/NOW]]
alebo
START_REPLAY dir_name_only /LOOP		Spustí prehrávanie hodnôt nahratých príkazom START_RECORD. Pre detaily viď popis príkazu pre proces D2000 KOM.
STOP_REPLAYOkamžite zastaví prehrávanie dát. Pre detaily viď popis príkazu pre proces D2000 KOM.


D2000 WorkBook

OBJECTS_INFOProces zapíše do svojho .log súboru zoznam všetkých objektov, ktoré sú, alebo boli použité v rámci reportov.

Súvisiace stránky:

D2000 Tell
Práca s procesom D2000 Tell

  • Žiadne štítky