| Description | Ensures that an address book context is present within
the current pageContext.   This tag must appear, at least once, before all
other tags within the AddressBook   taglib.  Ifconfigis not specified,  then a search 
for a useable configuration name is performed in the following fashion:
 
         Once a configuration name has been determined, an attempt is made to acquire 
an appropriate addressbook context object.  This is done in the following 
fashion:Attempt to retrieve the current addressbook configuration name 
from the page context.  If that succeeds, use it.  If the retrieval 
fails...Attempt to retrieve the current addressbook configuration name 
from the session.  If that succeeds, store it on the page context and 
use it.  If the retrieval fails...From the list of all SSOAdapter configuration names, try to
find the first useable addressbook configuration name.  If that succeeds, 
store it in the session and page context and use it.  If it is not possible 
to find a useable addressbook configuration name, the contexttag will
fail.
 
 
         This way, if an addressbookAttempt to retrieve an addressbook contextfrom the page 
context, and verify that it matches the configuration (using the previously acquired 
configuration name).  If that succeeds, use it.  If that fails...Attempt to retrieve an addressbook contextfrom the user's 
cache of addressbook contexts.  If that succeeds, store it on the page 
context and use it.  If the retrieval fails...Create an SSOAdapter object using the previously acquired configuration 
name.  Create an addressbook context, and bind it with the SSOAdapter 
object.  Store the addressbook context in the context cache as well as
the page context.
 contexthas been previously referenced 
on a page, or within the session, then theconfigattribute may be omitted,  and the most 
recently referencedcontextwill be retrieved. |