/SU source_user

Meno užívateľa pre source (potrebné, ak je iné ako štandardné).
Poznámka: ak je arcsynchro spúšťané procesom D2000 Archív (parameter ArcsynchroAuto), tak používané meno/heslo je prenášané automaticky. Pokiaľ je teda rovnaké meno/heslo pre source a target archívne databázy, nie je nutné parametre /SU, /SP, /TU a /TP používať.

/SP source_password

Heslo užívateľa pre source (potrebné, ak je iné ako štandardné). Viď poznámku pri parametri /SU.

/TU target_user

Meno užívateľa pre target (potrebné, ak je iné ako štandardné). Viď poznámku pri parametri /SU.

/TP target_password

Heslo užívateľa pre target (potrebné, ak je iné ako štandardné). Viď poznámku pri parametri /SU.

TNS (ak je source Oracle databáza) alebo DSN (ak je source ľubovoľná databáza prístupná cez nakonfigurované ODBC) archívu, ktorý obsahuje platné archívne záznamy.

TNS alebo DSN archívu, v ktorom chýbajú záznamy.

time_start

Začiatok časového intervalu, v ktorom sa dopĺňajú chýbajúce archívne záznamy.

time_end

Koniec časového intervalu, v ktorom sa dopĺňajú chýbajúce archívne záznamy.

Identifikátor (číslo) archívneho objektu, ktorý sa bude synchronizovať. Ak je id=113, tak príslušná archívna tabuľka je DT0000113 (názvy spracúvaných archívnych tabuliek sú vypisované pri behu programu).

+id
-id
+id -id

Identifikátor (číslo) archívneho objektu, od ktorého (+id) resp. do ktorého (-id) resp. v akom intervale (+id -id) prebieha synchronizácia.
Ak je napr. +113, tak sa synchronizujú premenné s HOBJ=113 a vyšším (tabuľky DT0000113, DT0000114 atď.).
Je možné zadať aj interval pomocou +id -id, napr. +1 -999 bude synchronizovať archívne objekty s HOBJ 1 až 999.

mask

Maska pre názov archivovanej premennej. V maske je možné použiť špeciálne znaky (? *), čím je možné synchronizovať zvolené premenné. Maska nie je citlivá na veľké/malé písmená.

Príklad: maske H11?E* vyhovujú premenné H11_Edo, H11re, h111Element. Nevyhovujú jej premenné H11abEdo, H11Edo, H12_edo

Automatická synchronizácia archívov na základe informácií o dobách výpadkov archívu, ktoré sa nachádzajú v cieľovom archíve (tabuľka

Pokiaľ sa synchronizuje archív aj trezor, spracované budú diery so Status=10.
Pokiaľ sa synchronizuje iba archív, spracované budú diery so Status=10 alebo Status=15.
Pokiaľ sa synchronizuje iba trezor, spracované budú diery so Status=10 alebo Status=20.
Po úspešnej synchronizácii (ak v zdrojovom archíve nie je diera obsahujúca dieru cieľového archívu a ak je pri synchronizácii vložený aspoň 1 záznam) bude nastavený:

• Status=15, ak sa synchronizoval iba trezor

• Status=20, ak sa synchronizoval iba archív

• Status=25, ak sa synchronizoval archív aj trezor

Ak nebol vložený žiadny záznam, nastaví sa Status=30, aby pri následnom spustení sa arcsynchro nepokúšal stále znovu a znovu synchronizovať tú istú dieru.

/AN

Rovnaký význam ako /A, ale neopravuje záplatami - skončí po výpise zoznamu dier, ktoré by boli synchronizované. Slúži na zistenie množstva a veľkosti dier, ktoré potrebujú synchronizáciu.

/AX

Rovnaký význam ako /A, ale Status v tabuľke ARC_HOLE po plátaní diery sa nezmení.
Poznámka: Tento parameter sa dá použiť na synchronizáciu archívov s 3 alebo viacerými inštanciami. Na zaplátanie diery v databáze1 za použitia databázy2 a databázy3 je potrebné spustiť:
arcsynchro /AX databáza2 databáza1
arcsynchro /NU /A databáza3 databáza1
Prvý riadok zapláta dieru v databáze1 dátami z databázy2, ale nechá dieru označenú ako nesynchronizovanú.
Druhý riadok zapláta (iba vkladá údaje, neaktualizuje) dieru v databáze1 dátami z databáz3 a označí dieru ako zaplátanú.
Zvyčajne stačí na plátanie diery jeden príkaz arcsynchro. Uvedený príklad dokáže zaplátať dieru, aj keď databáza2 a databáza3 obsahujú nekompletné dáta (t.j. archívy [2] a [3] mali tiež drobné výpadky počas dlhšie trvajúceho výpadku archívu [1]).

/A+

Pre každý archivovaný objekt sa synchronizuje celá jeho časová hĺbka (podľa konfigurácie objektov) až do aktuálneho času. Parameter je použiteľný pri kopírovaní celého archívu do nového archívu. Štandardne sa dá nahradiť vhodne zvolenými time_start a time_end parametrami (time_start musí byť dostatočne ďaleko v minulosti, aby pokryl najväčšiu nakonfigurovanú časovú hĺbku), ale v prípade, že zdrojový archív má vypnuté mazanie hodnôt, by takýto prístup dosynchronizoval aj staré hodnoty.
Poznámka: Konfigurácia je zisťovaná zo zdrojovej alebo cieľovej databázy (viď popis parametra /TAD).

/ATE
/ATD
/ATA

Synchronizujú sa archívne objekty so zapnutým archivovaním (/ATE, prednastavená voľba), s vypnutým (/ATD) alebo všetky (/ATA). Parameter je použiteľný pri kopírovaní celého archívu do nového archívu, pokiaľ je želané kopírovanie aj hodnôt starých archívnych objektov s vypnutým archivovaním. Pre tieto objekty sa v cieľovej databáze vytvoria príslušné tabuľky, pokiaľ neexistovali.

Veľkosť okolia diery v archíve, ktoré bude tiež synchronizované.
Pri zápise do archívu môžu prichádzať z komunikácie aj hodnoty so starším alebo novším časom ako je aktuálny. Po výpadku archivačného procesu následne chýbajú aj novšie a staršie dáta z okolia diery. Preto je možné zadaním parametra time_delta nastaviť veľkosť okolia diery (v sekundách), ktoré bude tiež synchronizované. Prednastavené time_delta = 10.

Veľkosť okolia od konca diery v archíve, ktoré bude tiež synchronizované.
Pri zápise do archívu môžu byť vkladané (zvyčajne zo skriptu) aj dáta s budúcim časom (napr. príprava prevádzky). Po výpadku archivačného procesu následne chýbajú aj novšie dáta ako je čas konca diery. Preto je možné zadaním parametra future_delta nastaviť čas dát pripočítaný ku koncu diery (v sekundách), ktoré bude tiež synchronizované. Prednastavené future_delta = 0.
Pozn: ak sú zadané obidva parametre /TD a /FD (/TD time_delta  /FD future_delta), budú synchronizované dáta za interval <zaciatok_diery - time_delta , koniec_diery + time_delta + future_delta>

/NU

Ak sa v cieľovej archívnej databáze hodnota archívneho objektu s konkrétnym časom už nachádza (takže vloženie hodnoty zlyhá), nebude následne hodnota aktualizovaná. Parameter slúži na zrýchlenie synchronizácie, pokiaľ cieľová archívna databáza obsahuje iba diery a nie dáta s inými hodnotami, ako zdrojová databáza.

/U

Vykoná sa aktualizácia štruktúr tabuliek v archívnej databáze. Pokiaľ je aspoň jedna z tabuliek v archívnej databáze neaktuálna (napr. tabuľky ARCHIV_DEF, ARC_HOLE, UTC_OFFSET), utilita Arcsynchro bez prepínača /U skončí s chybovým hlásením. S použitím prepínača /U sa štruktúra databázy aktualizuje (to ale môže vadiť, pokiaľ by niekto omylom použil nový arcsynchro na opravenie dier v staršej aplikácii, ktorá by potom nebola schopná s upgradovaným archívom pracovať).

/UX

Bude sa pracovať aj so starými (neaktualizovanými) štruktúrami tabuliek v archívnej databáze. Tento parameter umožňuje synchronizovať dáta zo starších D2000 aplikácií (napr. D2000 verzia 8.0 bez podpory UTF8) bez potreby aktualizovať starú archívnu databázu. Toto môže byť výhodné pri príprave migrácie na novú verziu D2000, pokiaľ sa mení aj databázová platfoma pre D2000 Archiv.

Arcsynchro najskôr vykoná aktualizáciu hodnoty (update). Pokiaľ nie je v dôsledku aktualizácie modifikovaný žiaden riadok, až potom sa vykoná vloženie hodnoty (insert). Parameter je implementovaný iba v ODBC verzii.
Pozn: parameter má zmysel pre archívy na platforme PostgreSQL na minimalizáciu generovania transakčných ID (XID) pri použití DSN s nastavením "Level of rollback on errors" na hodnotu Transaction.
Pozn: pre PostgreSQL od verzie 9.5 je možné na redukciu generovania XID použiť parameter /UP.
Pozn: identickú funkcionalitu v archíve zapína parameter archívu SelectBeforeUI.

Parameter zapína použitie SQL príkazu "UPSERT" (kombinácia Insert a Update SQL príkazu), ktorý je podporovaný pre databázu PostgreSQL od verzie 9.5. V takom prípade bude vkladanie hodnôt do archívu a trezorov realizované pomocou príkazu INSERT .. ON CONFLICT .. DO UPDATE. Parameter je implementovaný iba v ODBC verzii.
Pozn: parameter má zmysel pre archívy na platforme PostgreSQL na minimalizáciu generovania transakčných ID (XID) pri použití DSN s nastavením "Level of rollback on errors" na hodnotu Transaction.
Pozn: pre staršie verzie PostgreSQL ako 9.5 je možné na redukciu generovania XID použiť parameter /UF.
Pozn: identickú funkcionalitu v archíve zapína parameter archívu Upsert.

Synchronizujú sa iba primárne archívy, nie štatistické ani vypočítané.

Parameter je prípustný iba vtedy, ak je zadaný aj parameter id (synchronizácia dát jedného objektu s konkrétnym identifikátorom).
Vtedy sa hodnoty objektu s identifikátorom Arcsynchro - pomôcka pre synchronizáciu archívov#id načítané zo zdrojovej databázy vkladajú do cieľovej archívnej databázy do tabuliek objektu s identifikátorom tid. Ak sa synchronizujú dáta do trezorov, tak sa identifikátor objektu id nahradí pri vkladaní do cieľového trezoru identifikátorom tid.
Pozn: Parameter /TID je použiteľný pri spájaní aplikácií a ich archívov, ak dochádza k zmene HOBJ objektov (ID objektu v zdrojovej aplikácii a zdrojovom archíve je iné ako v cieľovej aplikácii/archíve).

Arcsynchro nebude písať do štandardného logu arcsynchro.log ale do logu s názvom podľa parametra logname.

Arcsynchro nebude písať do štandardného logu arcsynchro.log ale do logu s časovou značkou arcsynchro yyyy-mm-dd hh-mi-ss.log. Možnosť použitia - viď poznámka.

DSN zdrojovej trezorovej databázy (pre Sybase).
Parameter môže byť použitý iba raz. Parameter implicitne zapína aj parameter /TAD (t.j. z trezorovej databázy sa načítavajú iba hodnoty objektov, ktorých definície sú v cieľovej archívnej databáze).

Poznámka: Ak je použitý parameter /ST, parameter source (DSN zdrojového archívu) bude ignorovaný.

Meno zdrojovej trezorovej databázy (pre PostgreSQL). Zvyčajne vo formáte appname_TREZOR_n, napr. Test_TREZOR_11.
Parameter môže byť použitý iba raz. Parameter implicitne zapína aj parameter /TAD (t.j. z trezorovej databázy sa načítavajú iba hodnoty objektov, ktorých definície sú v cieľovej archívnej databáze).

Poznámka: Ak je použitý parameter /STPG, parameter source (DSN zdrojového archívu) bude použitý na pripojenie sa k PostgreSQL trezoru (aby nemuselo byť vytvorené zvlášť DSN pre každý PostgreSQL trezor). Preto musí byť source DSN zdrojového archívu, ktorý sa nachádza na rovnakom PostgreSQL serveri ako trezor.

DSN cieľovej trezorovej databázy (pre Sybase/Oracle).
Pre cieľovú databázu na Sybase môže byť parameter opakovaný aj viackrát (napr. pre synchronizáciu aktuálnej a predchádzajúcej trezorovej databázy: /TT app.curr_trezor /TT app.prev_trezor).

Poznámka: Ak sa nepodarí otvoriť prvú trezorovú databázu, arcsynchro skončí s chybou. Chyba otvorenia druhej alebo ďalšej databázy je ignorovaná (aby sa umožnilo štandardné použitie s aktuálnym a predchádzajúcim trezorom, pričom predchádzajúci už nemusí byť dostupný).

Pre cieľovú databázu na Oracle má význam iba vtedy, ak sú trezory umiestnené oddelene od archívnej databázy (v opačnom prípade použite parameter /TTO). Preto je možné parameter použiť iba jedenkrát. Užívateľské meno použité pre pripájanie sa k databáze špecifikuje parameter target_user, užívateľské heslo je nastaviteľné parametrom /TTP trezor_password.

Pre zdrojovú databázu na Oracle: synchronizujú sa dáta z trezoru trezor_id. Parameter je použiteľný pre Oracle trezory, ktoré sú umiestnené v tej istej databáze ako archív. Parameter umožňuje naplnenie cieľovej databázy, prípadne trezorov cieľovej databázy (Oracle, PostgreSQL, Sybase) z trezoru Oracle databázy.
Príklady:

• /STO 16 - patchovanie z trezoru 16

• /STO 16_S01 - patchovanie z trezoru 16, z trezorového segmentu č.1

Pozn: Synchronizovať sa budú dáta iba z trezorov, ktoré sú namontované (aktuálny, predchádzajúci a staršie, ktoré sú namontované príkazom MOUNT_TREZOR).

Pre cieľovú databázu na Oracle: synchronizovať sa majú aj trezory. Parameter je použiteľný pre Oracle trezory, ktoré sú umiestnené v tej istej databáze ako archív. Ak sú trezory vo zvláštnej databáze, je nutné použiť parameter /TT trezor_dsn.
Pozn: Synchronizovať sa budú dáta iba do trezorov, ktoré sú namontované na zápis (aktuálny, predchádzajúci a staršie, ktoré sú namontované príkazom MOUNT_TREZOR WRITE).

/PTO

V cieľovej databáze sa synchronizujú iba trezory, nie samotný archív. Parameter target bude ignorovaný, pokiaľ sa použije parameter /TT trezor_dsn a nepoužije sa parameter /TAD.

/TTP trezor_password

Heslo na pripojenie sa k cieľovej trezorovej databáze.

Arcsynchro použije definíciu archívnych objektov z cieľovej databázy. Štandardne sa používa definícia archívnych objektov zo zdrojovej databázy, tento prepínač je potrebný, ak je nakonfigurovaný v cieľovom Oracle archíve iný počet trezorových segmentov ako v zdrojovom archíve a synchronizujú sa dáta aj do trezorov.
Bez prepínača /TAD by archív ukladal dáta do trezorového segmentu 0 (ak počet trezorových segmentov v zdrojovom archíve je menší ako v cieľovom) alebo by nenašiel trezorový segment, do ktorého má dáta ukladať (ak počet trezorových segmentov v zdrojovom archíve je väčší ako v cieľovom).

Pre cieľovú databázu na PostgreSQL: synchronizovať sa majú aj trezory.
Pokiaľ sa vytvára iba jeden trezorový segment (TrezorCountSegments=0), stačí použiť parameter /TTPG0 mask0, pričom mask0 je hodnota parametra PG_TrezorName0 (napr. MyAPP_TREZOR_#ID#). Názvy jednotlivých trezorových databáz sa vytvárajú z numerického ID trezora (1,2, atď) a z textovej masky.
Pokiaľ sa vytvára viacero trezorových segmentov (TrezorCountSegments>0), je treba špecifikovať aj parameter /TTPGN maskN, pričom maskN je hodnota parametra PG_TrezorName.
Pozn: Synchronizovať sa budú dáta iba do trezorov, ktoré sú namontované na zápis (aktuálny, predchádzajúci a staršie, ktoré sú namontované príkazom MOUNT_TREZOR WRITE).

Pre trezory na PostgreSQL od verzie 9.5: dáta sa do trezorov nevkladajú cez ODBC, ale vytvorí sa súbor v adresári path, v ktorom budú dáta v textovej forme. Po vložení počtu riadkov, ktorý zodpovedá štartovaciemu parametru /CM (default 1000, ale odporúčame pri použití /FM zvýšiť až na 1000000) sa pomocou PostgreSQL rozšírenia 'file_fdw' vytvorí tzv. foreign table (externá tabuľka) mapovaná na tento súbor a dáta sa vložia do trezoru z nej (upsert).

Tento postup obchádza pomalosť ODBC, ktoré spracúva riadky po jednom. Podmienkou je, aby adresár path bol čitateľný pre PostgreSQL databázu (t.j. arcsynchro musí bežať na tom istom počítači ako databáza).

Použitím parametra /FM sa zrýchlilo načítavanie dát v konkrétnom prípade cca 3-násobne (z 2400 na 7050 riadkov za sekundu).

Kopírovanie obsahu tabuľky LOG_DATA.
Kopírovanie je nutné pri pridávaní novej inštancie archívu do už existujúcej aplikácie alebo pri prechode na novú databázu (napr. pri prechode zo Sybase nižšej verzie na vyššiu, alebo z Sybase na Oracle platformu a opačne). Tabuľka LOG_DATA obsahuje údaje o prechode archívu na monotónny čas a o začiatku zmenovej archivácie. Pokiaľ sa budú do archívnej databázy kopírovať staršie dáta (zo staršej archívnej databázy), je nutné nakopírovať z neho aj obsah tabuľky LOG_DATA a až následne spustiť archiváciu. V opačnom prípade dôjde k zlej interpretácii starých údajov a k ich prípadnému poškodeniu pri prepočtoch.
Kopírovanie obsahu tabuľky LOG_DATA je nutné spustiť pred tým, ako proces D2000 Archiv začne zapisovať do novej archívnej databázy dáta. Doporučený postup je nasledovný:

1. Vytvorenie novej archívnej databázy (platforma Sybase, MSSQL) alebo archívneho tablespace (platforma Oracle).

2. Spustenie procesu D2000 Archiv s parametrom /RO (read only). Vytvoria sa tabuľky pre archivované hodnoty, ale nezapisujú sa dáta.

3. Po skončení vytvárania tabuliek vypnutie procesu D2000 Archiv.

4. Spustenie:
   arcsynchro /CLD source target,
   source je DSN ukazujúce na starú archívnu databázu s údajmi,
   target je DSN ukazujúce na novú archívnu databázu s prázdnymi tabuľkami.

5. V tomto bode je možné spustenie procesu D2000 Archiv (začiatok bežnej archivácie do novej archívnej databázy).

6. Kopírovanie všetkých starých dát zo starého do nového archívu
   arcsynchro source target time_start time_end.

Poznámka: Riadok 'STOP' udávajúci čas posledného zastavenia procesu D2000 Archiv nebude v tabuľke LOG_DATA v cieľovej databáze prepísaný.

/DD

Detailné ladiace výpisy.
Po zapnutí parametra budú na obrazovku aj do logovacieho súboru arcsynchro.log zapisované rozšírené ladiace výpisy.

/DC count

Po nastavení parametra na nenulovú hodnotu count budú na obrazovku aj do logovacieho súboru arcsynchro.log zapisované písmená 'I' resp. 'U' po vložení (Insert) resp aktualizovaní (Update) count hodnôt v archíve.

Poznámka: Na obrazovke sa výpisy zobrazujú priebežne, v logovacom súbore až po ukončení spracovania jedného archívneho objektu.

Commitovanie v archívnej databáze bude po count vložených/aktualizovaných hodnotách. Prednastavená hodnota tohto parametra je 1000.

Dodatočná podmienka pre ArchivDef tabuľku (tabuľka s definíciami archívnych objektov v archíve).
Príklad použitia: pri použití arcsynchro na kopírovanie dát z trezorových segmentov (napr. z Oracle databázy) do trezorových segmentov (napr. PostgreSQL databáza) je možné špecifikovať /XADC "TRZ_SEG=2". Synchronizované budú iba objekty, ktoré sú v trezorovom segmente č. 2. Toto môže zrýchliť kopírovanie dát (zdrojový trezorový segment nie je dotazovaný na dáta objektov, ktoré sa nachádzajú v iných trezorových segmentoch).

0

Úspešné ukončenie programu.

1

Chybné parametre programu.

2

Chyba pripojenia sa k zdrojovej databáze zadanej parametrom Arcsynchro - pomôcka pre synchronizáciu archívov#source.

3

Chyba pripojenia sa k zdrojovej trezorovej databáze zadanej parametrom /ST.

4

Chyba pripojenia sa k cieľovej databáze zadanej parametrom Arcsynchro - pomôcka pre synchronizáciu archívov#target.

5

Chyba pripojenia sa k samostatnej cieľovej trezorovej databáze na platforme Oracle zadanej parametrom /TT trezor_dsn.

6

Chyba pripojenia sa k prvej cieľovej trezorovej databáze na platforme Sybase zadanej prvým parametrom /TT trezor_dsn.

7

V zdrojovej databáze Arcsynchro - pomôcka pre synchronizáciu archívov#source bola začatá, ale nebola dokončená konverzia na časové rezy.

8

V cieľovej databáze Arcsynchro - pomôcka pre synchronizáciu archívov#target bola začatá, ale nebola dokončená konverzia na časové rezy.

9

Cieľová databáza Arcsynchro - pomôcka pre synchronizáciu archívov#target nie je na platforme Oracle a použitý bol parameter /TTO.

10