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.
Napíšte komentár