Akcia DB_TRANS_OPEN

Návratový kód

Hodnota parametra retCodeIdent_Int - pozri tabuľku chybových stavov. Je možné získať rozšírenú informáciu o chybe.
Poznámka: Maximálny počet spojení nakonfigurovaný na objekte Databáza je možné obmedziť parametrom Maximum spojení, pričom hodnota 0 obmedzenie vypína. Ak proces D2000 DBManager spotrebuje všetky spojenia, tak ďalšie volania DB_TRANS_OPEN snažiace sa o vytvorenie spojenia vrátia chybu DBM_MAX_CONNECTIONS v premennej _ERR_NR_TRANS_EX.

Popis

Identifikátor pre číslo Pripojenia, alebo handle sa používa pri:

následných operáciách typu CONNECT na tabuľku (DB_, PG_, SQL_).
akciách:

Návratový kód popisuje úspešnosť akcie (_ERR_NO_ERROR).

Ak je zadaná nenulová hodnota parametra timeoutSec_Int, tak všetky príkazy vykonávané v rámci tejto transakcie, ktoré budú trvať dlhšie, budú zrušené a rozšírená informácia o chybe vráti v premennej _ERR_NR_TRANS_EX chybu USER_EXPIR_TIME. Zároveň je inkrementovaná hodnota v stĺpci AbortCnt v systémovej štruktúre SV._System_DBMDbPerf. Toto chovanie je zatiaľ implementované iba pre databázu PostgreSQL.

Poznámka: Zrušenie príkazu je realizované PostgreSQL funkciou pg_cancel_backend. Po zrušení príkazu je transkcia naďalej použiteľná.

Akcie v skriptoch

dbObjIdent	in	Odkaz na objekt typu Databáza.
handleIdent_Int	out	Identifikátor pre jednoznačné číslo (handle) Pripojenia.
retCodeIdent_Int	out	Identifikátor - návratový kód.
timeoutSec_Int	in	Identifikátor - timeout na príkazy v sekundách.