Defines the environment that the core collaboration tags run in. Use the session tag when multiple core tags are included on the same JavaServer page. This initializes and tears down the Domino session one time only, providing improved performance. This tag is not required if there is only one core tag on the page; the user and password attributes of the core tag implement the session for you. However, if you are using a CORBA session, this tag must be used, since the host attribute cannot be specified on the top-level tags. If one or more of the core tags reside in the same database, you can further improve the efficiency of the page by using the db tag instead of this tag to wrap them.

Contexts

Valid in:

None required

db, document, ftsearch, view, form

<domino:session
id="name of object variable"
user="user name"
password="user password"
host="CORBA server name"
debug="true|false"
onfailure="inline|exception"
time="true|false">

The following attributes are optional:

host

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.Session object. The variable created is only available within the body of the session tag. If not specified, no programmatic access to the Session object is available. Default is unnamed.

Password of the user specified by the user parameter. Default is null.

Name of the user the session should be opened under. Default is to open the session under the server ID.

Example
See Also

The Domtags tag library

Glossary