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


Kotva
calc
calc
D2000 CALC

...

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.
Od verzie 10.1.39 sa po skončení dlhotrvajúceho SQL príkazu 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.

...