LotusNotesConnect

Syntax

LotusNotesConnect(str_server, str_database, str_password);

str_server	The Lotus Domino server.
str_database	The filename of the Lotus Notes database on the Lotus Domino server. If the script requires read access to the Lotus Notes database, the database specified in str_database must allow read access for the user specified in the Lotus ID file. See the str_password argument. If the script requires write access to the Lotus Notes database, the database specified in str_database must allow write access for the user specified in the Lotus ID file. See the str_password argument. Only a Lotus Domino administrator can enable read or write access to the Lotus Notes database.
str_password	The password for unlocking the Lotus ID file which authenticates access to a Lotus Notes database. The StreamServer searches for the Lotus ID file named ssdominouser.id in the export directory of the StreamServe Project. If the Lotus ID file is not found, or if str_password fails to unlock it, the StreamServer tries to use the previously used Lotus ID file that ssnotes.ini has a reference to. If you connect to the database via a Lotus Domino server, without access to a Lotus Notes client installation, you must: • Obtain a suitable Lotus ID file. • Ensure that the Lotus ID file is recertified and contains a valid password. • Rename the Lotus ID file to ssdominouser.id • Store the Lotus ID file in the export directory of the Project. Ask your Lotus Domino administrator for assistance.

Description

Establishes a connection to a Lotus Notes database on a Lotus Domino server.

If you call the LotusNotesConnect function again, when a connection has been established, the previous connection will be closed. Using the LotusNotesDisconnect function to close a connection ensures that all data written to the database is saved.

Returns

	A connection was successfully established.
-1	Failed to establish a connection to the Lotus Notes database.

Example

$ret = LotusNotesConnect("windows_server05/my_domino_server", "invoice.nsf", "my_password");