Funkcia %ESLProfileStart

Funkcia

Funkcia povolí/zakáže zaznamenávanie (profiling) vykonávania ESL skriptov.

Deklarácia

%ESLProfileStart(
   BOOL in init
 )

Parametre

init

@TRUE - povolí zbieranie ladiacich informácií.
@FALSE - pozastaví zbieranie ladiacich informácií a zapíše medzivýsledky.

Popis

V momente, keď je v niektorom skripte zavolaná funkcia %ESLProfileStart(@TRUE), začne sa zaznamenávať každý vykonávaný riadok vo všetkých bežiacich ESL skriptoch.

Po zavolaní funkcie %ESLProfileStart(@FALSE), zapíšu sa zozbierané informácie z jednotlivých skriptov do súboru Esl.nazov_skriptu_id_instancie.profiler (napr. Esl.e.mojskript_1250.profiler) v adresári \Log, ktorý je podadresárom programového adresára a pozastaví sa priebežné zbieranie ladiacich informácií.

Funkciu %ESLProfileStart je následne možné zavolať s parametrom @TRUE, kedy sa začnú opätovne priebežne zbierať ladiace informácie.

Formát zapísaných dát:
line; count; line duration; action duration; action status; line text; ActionType; Use Pragma ;DataSize ;Use PragmaRPC; DataSizeRPC

line	Číslo riadku.
count	Počet opakovaní riadku.
line duration	Celkový čas vykonávania riadku.
action duration	Čas pasívneho čakania akcie na vykonanie požadovanej činnosti.
action status	Parameter signalizuje stav použitej akcie.
line text	Text vykonávaného riadka.
ActionType	Vyplnené, ak sa na riadku vykonáva synchrónna akcia %HI_*.
Use Pragma	Vyplnené, ak sa využila vlastnosť akcie PRAGMA.
DataSize	Veľkosť dát, ktoré neboli kopírované medzi procedúrami v jednom ESL skripte pri použití akcie PRAGMA.
Use PragmaRPC	Vyplnené, ak sa využila vlastnosť akcie PRAGMA pre RPC procedúry.
DataSizeRPC	Veľkosť dát, ktoré neboli kopírované medzi RPC procedúrami ESL skriptov na rovnakom event handleri, ak sa využila vlastnosť akcie PRAGMA pre RPC procedúry.

V prípade, že dôjde k ukončeniu niektorého skriptu alebo zatvoreniu schémy pred volaním %ESLProfileStart(@FALSE), bude súbor *.profiler generovaný okamžite.
Popísaný mechanizmus je funkčný len pre ESL skripty, ktoré boli naštartované v čase, keď bola zapnutá ladiaca premenná DBG.ACTIONS.ENABLE_PROFILE_INFO. Štandardne je vypnutá. Jej zapnutie pri štarte procesu je možné parametrom /E+DBG.ACTIONS.ENABLE_PROFILE_INFO na príkazovom riadku, alebo počas behu prostredníctvom procesu D2000 System Console.

Súvisiace stránky:

Rozšírené funkcie ESL
Argumenty funkcie - typy