DB_TRANS_OPEN
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
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. |
| in | Identifiká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á.
Príklad
Súvisiace odkazy
Súvisiace stránky: