9 70 DOM_OPEN_DATABASE

9.70 DOM_OPEN_DATABASE

Þ Note: Built-In Function Rules.

Opens a Domino/Notes Database on a local or remote Domino server.

You must use the DOM_CLOSE_DATABASE Built-In Function before exiting your application once the database has been opened.

For use with

LANSA for i YES Visual LANSA for Windows YES Visual LANSA for Linux NO

 

Arguments

No Type Req/ Opt Description Min Len Max Len Min Dec Max Dec 1 A Req Notes database file name. Note: This includes the Notes data directory. The file extension may be omitted if it is ".NSF" e.g. "/NOTES/DATA/ACME.NSF" 1 255     2* A Opt Network port name 1 32     3* A Opt Domino server name 1 255

 

Note: Arguments 2* and 3* required if accessing a Remote Server Directory

To open the database on a local Domino server only requires the database name.

To open the database on a remote Domino server may require a full path name including the server name (TCP/IP host name usually registered in a DNS), the organisation name, the country code and Notes database name eg. "SYDNOTES/ACME/AU/NOTES/DATA/ACME.NSF".

The server name may be sufficient if this name exists in the TCP/IP Host Table on the local IBM i server.

Return Values

No Type Req/ Opt Description Min Len Max Len Min Dec Max Dec 1 A Req Return code OK = Database successfully opened. ER = Database not opened. 2 2     2 A Req Database handle 4 4

 

Examples

Refer to these Domino Built-In Function Examples:

Example 1: Creating a New Document in a Database

Example 2: Selecting documents from a Database using a view

Example 3: Executing an Agent in a Database

Example 4: Updating Documents selected from a Browselist.

Technical Notes

This Built-In Function uses the standard Lotus Notes APIs OSTranslate, NotesInit, OSPathNetConstruct and NSFDbOpen. All security and integrity issues related to the use of this Built-In Function are according to normal Lotus Notes API use for the current platform.