Akcia DB_TRANS_OPEN


Funkcia

Akcia vytvorí nové Pripojenie na databázu.

Deklarácia
DB_TRANS_OPEN dbObjIdent, handleIdent_Int, retCodeIdent_Int [TIMEOUT timeoutSec_Int]
Parametre
dbObjIdentinOdkaz na objekt typu Databáza.
handleIdent_IntoutIdentifikátor pre jednoznačné číslo (handle) Pripojenia.
retCodeIdent_IntoutIdentifikátor - návratový kód.
timeoutSec_Int
inIdentifikátor - timeout na príkazy v sekundách.
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á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á.


Súvisiace stránky:

Napíšte komentár