Function EN Version 1.90

@OpenDB

Database

Syntax

@OpenDB(NOTESPATH1);
@OpenDB(NOTESPATH1;OPTIONS2);

Description

Opens a database with the NOTESPATH NOTESPATH1 and liefert einen DBHANDLE returned. As of version 1.93, TEXT OPTIONS2 can be used to specify more detailed behavior.

OPTIONS2:
L=Locked (no further opening from another location allowed)
P=Purge (remove documents still present as deletion stubs)
C=Consistency check (perform integrity check)
F=Cluster failover (if the database can no longer be opened normally because it is corrupt, this option can be used to try again)
S=Close session if a path error occurs in @OpenDB (remote).
X=Do not use cluster failover under any circumstances (even if the default value via NOTES.INI variable APIOpenDBOptionsClusterFailover is set differently)
Y=Do not close the session under any circumstances (even if the default value via NOTES.INI variable APIOpenDBOptionsCloseSession is set differently)

N=Only in addition to C: no note scan, i.e. ???
D=Only in addition to C: without note delete, i.e. documents marked as deleted
are not removed ???

IMPORTANT:
Options F and S are available only as of Engine V4.00.

Example: @OpenDB(NOTESPATH1)

NOTESPATH1:="DEMOSERVER!!TEST.NSF";
DBHANDLE:=@OpenDB(NOTESPATH1);
DBHANDLE:=@CloseDB(DBHANDLE);

Opens the database "TEST.NSF" on the server "DEMOSEVER" and returns in the variable DBHANDLE a database handle. The database is then closed again.

Example: @OpenDB(NOTESPATH1;OPTIONS2) ab Version 1.93

NOTESPATH1:="DEMOSERVER!!TEST.NSF";
DBHANDLE:=@OpenDB(NOTESPATH1;"L");
DBHANDLE:=@CloseDB(DBHANDLE);

Opens the database "TEST.NSF" on the server "DEMOSEVER" and returns in the variable DBHANDLE the database handle. The database is then closed again. The parameter "L" specifies that this database can no longer be replicated.

NOTESPATH1:="DEMOSERVER!!TEST.NSF";
DBHANDLE:=@OpenDB(NOTESPATH1;"LP");
DBHANDLE:=@CloseDB(DBHANDLE);

Opens the database "TEST.NSF" on the server "DEMOSEVER" and returns in the variable DBHANDLE the database handle. The database is then closed again. By additionally specifying the parameters "P" all deletion stubs that fall within the deletion interval are removed.

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