Function EN Version 1.90

@Replicate

Database NotesAdmin NotesSystem Replication

Syntax

@Replicate(DBHANDLE1;DBHANDLE2;FNLIST3);
@Replicate(DBHANDLE1;DBHANDLE2;FNLIST3;FNREPLICATIONFLAGS4);
@Replicate(DBHANDLE1;DBHANDLE2;FNLIST3;FNREPLICATIONFLAGS4;FNLISTERROR5);

Description

Replicates the database with DBHANDLE DBHANDLE1 with the database with DBHANDLE DBHANDLE2. FNLIST FNLIST3 is a list of rights where the first element specifies the replication rights in the first database and the second element specifies the rights in the second database. The databases do not have to be replicas of each other. FN FNREPLICATIONFLAGS4 can be used to enable or disable options in the replicator.

A FNLIST is returned:

element   Meaning
1   UpdateCount DBHANDLE1
2   CreateCount DBHANDLE1
3   DeleteCount DBHANDLE1
4   UpdateCount DBHANDLE2
5   CreateCount DBHANDLE2
6   DeleteCount DBHANDLE2

FNLIST3:

Bit   HEX   Meaning
01   0001   Read
02   0002   Write
03   0004   Modify
04   0008   Delete

FNREPLICATIONFLAGS4:

Bit   HEX   Meaning
01   0001   Localize links (Doc;View;DB) in databases with different replica IDs.

FNLISTERROR5:
When the optional return parameter FNLISTERROR5 is used, error statisics are returned in it.

element   Meaning
1   Error UpdateCount DBHANDLE1
2   Error CreateCount DBHANDLE1
3   Error DeleteCount DBHANDLE1
4   Error UpdateCount DBHANDLE2
5   Error CreateCount DBHANDLE2
6   Error DeleteCount DBHANDLE2

Example: @Replicate(DBHANDLE1;DBHANDLE2;FNLIST3)

DBHANDLE1:=@OpenDB("TESTRP1.NSF");
DBHANDLE2:=@OpenDB("TESTRP2.NSF");
FNLIST3:=@BitVektor(1:2:3:4);
FNLIST3:=FNLIST3:FNLIST3;
@LogReport(@Replicate(DBHANDLE1;DBHANDLE2;FNLIST3));
DBHANDLE2:=@CloseDB(DBHANDLE2);
DBHANDLE1:=@CloseDB(DBHANDLE1);

The database "TESTRP1.NSF" with the database "TESTRP2.NSF" is replicated and the result is output.

Example: @Replicate(DBHANDLE1;DBHANDLE2;FNLIST3;FNREPLICATIONFLAGS4)

DBHANDLE1:=@OpenDB("TESTRP1.NSF");
DBHANDLE2:=@OpenDB("TESTRP2.NSF");
FNLIST3:=@BitVektor(1:2:3:4);
FNLIST3:=FNLIST3:FNLIST3;
FNREPLICATIONFLAGS4:=1;
@LogReport(@Replicate(DBHANDLE1;DBHANDLE2;FNLIST3;FNREPLICATIONFLAGS4));
DBHANDLE2:=@CloseDB(DBHANDLE2);
DBHANDLE1:=@CloseDB(DBHANDLE1);

The database "TESTRP1.NSF" with the database "TESTRP2.NSF" is replicated and the result is output. Local links are mapped to the respective replica ID of the database.

Note : This text was machine-translated and may contain inaccuracies.