Provides a database context for all enclosed tags. If you are including several core tags that are running off the same database in a page, you can wrap them in this tag to increase scalability. This tag is not required if there is only one core tag on the page; the dbserver and dbname attributes of that core tag implement the db tag for you. Do not use this tag to wrap two core tags that reside in different databases; use the session tag instead.

If you do not supply values for the user and password attributes, the database identifies the user as an Anonymous user. The database's ACL must have an "Anonymous" entry with at least Reader level privileges to the database for the tag to access the database successfully. For more details, see "Anonymous access" in the Application Development with Domino Designer book.

To loop over all the documents in a database, use the docloop tag nested inside the db tag.

Contexts

Valid in:

None required; session

view, ifdbrole, form, page, novalues, docloop, ftsearch, ifauthor, ifdepositor, ifdesigner, document, ifnoaccess, ifeditor, ifmanager, ifreader

<domino:db
id="name of object variable"
dbname="database name"
dbserver="server name"
user="login information"
password="password associated with user"
host="CORBA server name"
debug="true|false"
onfailure="inline|exception"
time="true|false">

The following attributes are optional:

dbname

Name of the database to open. For example, "foo.nsf." All Notes databases are stored in the Notes/Data directory.

Tip If your database is located in a subdirectory of the Data directory, enter a forward slash before the .nsf file. For example, "Sales/foo.nsf." Notes traverses the subdirectories starting at the Data directory.

Name of the server the database is located on. Default is local.

Name of the Domino CORBA (Common Object Request Broker Architecture) server to use to host the back-end classes. If specified, forces a CORBA session. If not specified, a Domino server must be running locally on the same machine that is running the JSP Web container. Default is null which creates a local, non-CORBA, session.

If you specify an id name, creates a page level variable that contains the associated lotus.domino.Database object. The variable created is only available within the body of the db tag. If not specified, no programmatic access to the Database object is available.

Password associated with the value specified in the user attribute.

Login information of the session this database was opened in. If this tag is being used in the context of the session tag, its value is ignored.

Example
See Also

The Domtags tag library

Glossary