com.esri.sde.sdk.client
Class SeConnection

java.lang.Object
  extended by com.esri.sde.sdk.client.SeConnection

public class SeConnection
extends java.lang.Object

This class is used to establish and manage a connection to an ArcSDE server. To establish a connection, which is the first step in most ArcSDE client applications, one of the constructors is invoked. The underlying databases's security model is employed to authenticate the connection. Therefore, a valid database user and password information is required to connect to an ArcSDE server.

The SeConnection class provides methods to obtain information about the current connection. It also provides methods to retrieve lists of ArcSDE objects such as Tables, Layers, States, Versions, Logfiles, Locators and Metadata.

The SeConnection class also has an inner class, SeConnection.SeStreamSpec that is used to set and retrieve the specifications for any stream that will be created by this connection.

By default, the SeConnection class does not enforce a concurrency policy for simultaneous access by multiple threads. This ensures the best performance when invoking methods on an SeConnection object. To enforce a concurrency mechanism, which is required when building multi-threaded applications, one of the concurrency schemes must be adopted. This is done by invoking the setConcurrency(int) method with the desired concurrency policy.


Nested Class Summary
static class SeConnection.SeStreamSpec
          This inner class is used to set and retrieve the specifications of streams associated with a connection object.
 
Field Summary
static int SE_LOCK_POLICY
          SeConnection concurrency policy.
static int SE_ONE_THREAD_POLICY
          SeConnection concurrency policy.
static int SE_TRYLOCK_POLICY
          SeConnection concurrency policy.
static int SE_UNPROTECTED_POLICY
          SeConnection concurrency policy.
 
Constructor Summary
SeConnection(java.lang.String server, int instance, java.lang.String database, java.lang.String username, java.lang.String password)
          Creates an application server connection to an ArcSDE server.
SeConnection(java.lang.String server, int instance, java.lang.String database, java.lang.String username, java.lang.String password, java.util.Locale connLocale)
          Creates a connection to an ArcSDE server, using the Locale specified.
SeConnection(java.lang.String server, java.lang.String instance, java.lang.String database)
          Creates a Windows Authenticated direct connection to a Sqlserver Database.
SeConnection(java.lang.String server, java.lang.String instance, java.lang.String database, java.lang.String username, java.lang.String password)
          This constructor can be used to create either an application server or direct connection to an ArcSDE instance.
 
Method Summary
 void addInstanceMetaData(int recordCount, SeMetaData[] arrMetadata)
          Adds new metadata records for current SE instance.
 void alterInstanceMetaData(int recordCount, SeMetaData[] arrMetadata)
          Alters properties of the specified metadata record.
 void close()
          Closes the connection to the ArcSDE instance.
 void commitTransaction()
          This method commits all modifications made since the last call to startTransaction().
 void databaseUse(java.lang.String database)
          Changes the database or data source being used by a connection.
 void deleteInstanceMetaData(int recordCount, SeObjectId[] recordIds)
          Deletes instance's metadata records.
 void disableTlmCheck()
          This method disables the Time Last Modified check done by the server for state lineages, layers, registered tables, xml columns and raster columns.
 void enableTlmCheck()
          This method enables the Time Last Modified check done by the ArcSDE server for state lineages, layers, registered tables, xml columns and raster columns.
 void exportDbtune(java.lang.String dbtuneFile)
          Exports the contents of the DBTUNE table to a file.
 void freeAllLocks()
          Frees all the Layer, Table, State and Object locks associated with the current connection.
 java.lang.String getAdminDatabaseName()
          Returns the name of the administration database for this connection.
 java.lang.String[] getDatabaseList()
          Returns a list of databases or data sources for a DBMS instance.
 java.lang.String getDatabaseName()
          Returns the name of the database connected to.
 SeDBMSInfo getDBMSInfo()
          Returns information about the underlying RDBMS used by the ArcSDE server.
 java.lang.String getDefaultDatabase()
          Gets the name of the default database for this connection.
 int getInstance()
          Returns the port number of the ArcSDE instance connected to.
 java.util.Vector getInstanceList()
          Returns an array of instances objects containing information for all instances.
 SeMetaData[] getIntanceMetaDataInfoList(java.lang.String whereClause)
          Deletes instance's metadata records.
 java.lang.String[] getKeywordInfo()
          Returns a list of keywords reserved for use by the underlying RDBMS.
 java.util.Vector getLayers()
          Retrieves a list of all ArcSde layers that are accessible to the current user.
 java.util.Vector getList(java.lang.Class cType)
          Returns a Vector of objects from an ArcSDE instance given the class type.
 SeLocale getLocale()
          Returns the locale used by the current connection.
 SeLog[] getLogfileList(java.lang.String owner)
          Returns a list of all logfiles owned by the specified owner.
 SeLog[] getLogfileList(java.lang.String owner, java.lang.String table)
          Returns a list of all logfiles associated with the specified layer or table.
 SeMetaData[] getMetaDataList(java.lang.String whereClause)
          Returns the meta-data associated with a table.
 java.util.Vector getRasterColumns()
          Retrieves a list of all ArcSde raster columns that are accessible to the current user.
 java.util.Vector getRegisteredTables()
          Returns an array of SeRegistration objects containing information for all registered tables.
 SeRelease getRelease()
          Returns the version description of the ArcSDE instance to which the connection has been established.
 java.lang.String getSdeDbaName()
          Returns the name of the ArcSDE DBA user.
 java.lang.String getServer()
          Returns the name of the ArcSDE server connected to.
 java.util.Date getServerTime()
          Returns the current time on the computer running the ArcSDE server.
 java.util.Vector getSpatialRefList()
          Returns an array of SeSpatialReference objects.
 java.lang.String getSQLInfo(int sqlId)
          Returns the RDBMS dependent function name according to the specified sqlId.
 SeState[] getStateList(java.lang.String whereClause)
          Returns a list of SeState objects accessible to the current connection.
 SeConnection.SeStreamSpec getStreamSpec()
          Returns the properties of any stream that will be created with this connection.
 java.util.Vector getTables(int permissions)
          Retrieves a list of all tables, views, and synonyms which are available to the current user, with the given permissions.
 long getTimeSinceLastRT()
          This method returns the time, in seconds, since the last round trip to the ArcSDE server.
 int getTransactionAutoCommit()
          Gets the user transaction autocommit interval for the current connection.
 java.lang.String getUser()
          Returns the name of the ArcSDE user associated with the current connection.
 SeVersion[] getVersionList(java.lang.String whereClause)
          Returns a list of SeVersion objects accessible by the current user.
 void importDbtune(java.lang.String dbtuneFile)
          Imports the data to ArcSde DBTUNE table.
 boolean isAdmin()
          Check whether the connected user has admin privilege.
 boolean isClosed()
          Returns TRUE if the connection has been closed, FALSE otherwise.
 void restorePrimarySession()
          Restore primary session on the connection.
 void rollbackTransaction()
          This method aborts all modifications since the last call to startTransaction(), or any intermediate commits on a transaction resulting from a call to commitTransaction(), or an automatic commit (See the AUTOCOMMIT parameter in the giomgr.defs file).
 void setConcurrency(int policy)
          Sets the concurrency policy for the SeConnection object.
 void setStreamSpec(SeConnection.SeStreamSpec specs)
          Sets the properties of streams created by the current connection.
 int setTransactionAutoCommit(int interval)
          Sets the user transaction autocommit interval.
 void startTransaction()
          This method begins a transaction on the current connection.
 void switchToProxySession(java.lang.String username, java.lang.String password, java.lang.String[] role_array, int num_roles, java.lang.String distinguished_name)
          Switch to the proxy session.
 void testServer(long roundTripInterval)
          This method tests if this connection object is active by checking if a disconnect occured during the execution of any of the previous ArcSDE client functions.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

SE_UNPROTECTED_POLICY

public static final int SE_UNPROTECTED_POLICY
SeConnection concurrency policy. This policy does not enforce concurrency. It allows multiple threads to use the same connection object simultaneously. If two or more threads call a Java API method that uses a connection object, simultaneously, unpredictable results may be obtained.

See Also:
Constant Field Values

SE_ONE_THREAD_POLICY

public static final int SE_ONE_THREAD_POLICY
SeConnection concurrency policy. The thread that calls the setConcurrency(int) method with this policy, locks the connection object. No other thread(s) can use this connection object until the lock is released. Any attempt by other threads to use a locked connection will throw a SeError.SE_CONNECTION_LOCKED error. The thread that owns the lock releases it by calling the setConcurrency(int) method with a policy other than the SE_ONE_THREAD_POLICY.

See Also:
Constant Field Values

SE_TRYLOCK_POLICY

public static final int SE_TRYLOCK_POLICY
SeConnection concurrency policy. This policy ensures that only one thread can use the connection object at a time. If this concurrency policy is enforced on a connection object, a thread must obtain a lock on the connection before it can execute any method that uses the connection object. The lock is released when the thread completes execution of the method. If the connection has already been locked by another thread, a SeError.SE_CONNECTION_IN_USE error will be thrown.

See Also:
Constant Field Values

SE_LOCK_POLICY

public static final int SE_LOCK_POLICY
SeConnection concurrency policy. This policy is the same as the SE_TRYLOCK_POLICY , except that, if another thread already has a lock on the connection object, the current thread will wait until the connection object is released. If multiple threads are waiting on a connection, only one thread, chosen at random from the wait list, will resume execution.

See Also:
Constant Field Values
Constructor Detail

SeConnection

public SeConnection(java.lang.String server,
                    int instance,
                    java.lang.String database,
                    java.lang.String username,
                    java.lang.String password)
             throws SeException
Creates an application server connection to an ArcSDE server.

Parameters:
server - name of the server to connect to.
instance - the port number that the ArcSDE server is listening on.
database - the specific database to connect to. Only applicable to certain databases. Value ignored if not applicable.
username - name of a valid database user account.
password - the database user's password.
Throws:
SeException - if the connection attempt failed.

SeConnection

public SeConnection(java.lang.String server,
                    int instance,
                    java.lang.String database,
                    java.lang.String username,
                    java.lang.String password,
                    java.util.Locale connLocale)
             throws SeException
Creates a connection to an ArcSDE server, using the Locale specified. NOTE: The ArcSDE Java API Localization Kit is required for non-English locales. The Kit can be obtained from any ESRI International distributer.

Parameters:
server - name of the server to connect to.
instance - the port number that the ArcSDE server is listening on.
database - the specific database to connect to. Only applicable to certain databases. Value ignored if not applicable.
username - name of a valid database user account.
password - the database user's password.
connLocale - a Locale object. If the Locale is not an English locale, a sytem property file specific to this locale is required. Please refer to the documentation available with the Java API Localization Kit.
Throws:
SeException - if the connection attempt failed.

SeConnection

public SeConnection(java.lang.String server,
                    java.lang.String instance,
                    java.lang.String database,
                    java.lang.String username,
                    java.lang.String password)
             throws SeException
This constructor can be used to create either an application server or direct connection to an ArcSDE instance. For information on establishing direct connections and the direct connect parameter format, please refer to your database configuration tuning guide.

Parameters:
server - name of the server to connect to.
instance - the instance name or the direct connect parameter.
database - the specific database to connect to. Only applicable to certain databases. Value ignored if not applicable.
username - name of a valid database user account.
password - the database user's password.
Throws:
SeException - if the connection attempt failed.

SeConnection

public SeConnection(java.lang.String server,
                    java.lang.String instance,
                    java.lang.String database)
             throws SeException
Creates a Windows Authenticated direct connection to a Sqlserver Database. For information on the format of the direct connect parameter, please refer to the Sqlserver configuration and tuning guide.

Parameters:
server - name of the server to connect to.
instance - the direct connect parameter
database - the Sqlserver database to connect to.
Throws:
SeException - if the connection attempt failed.
Method Detail

freeAllLocks

public void freeAllLocks()
                  throws SeException
Frees all the Layer, Table, State and Object locks associated with the current connection. Only the locks created using the current connection handle will be released. Any locks, created using a different connection object but by the same user, will remain in place.

Throws:
SeException

getDatabaseName

public java.lang.String getDatabaseName()
                                 throws SeException
Returns the name of the database connected to. This is only applicable to certain databases. If not applicable, an empty String is returned.

Throws:
SeException

getDBMSInfo

public SeDBMSInfo getDBMSInfo()
                       throws SeException
Returns information about the underlying RDBMS used by the ArcSDE server. The SeDBMSInfo object provides information about the underlying database type and its properties such as the RDBMS's ability to add a column, case sensitivity etc.

Returns:
an SeDBMSInfo object
Throws:
SeException
See Also:
SeDBMSInfo

getKeywordInfo

public java.lang.String[] getKeywordInfo()
                                  throws SeException
Returns a list of keywords reserved for use by the underlying RDBMS.

Returns:
An array of RDBMS reserved keywords.
Throws:
SeException

getLocale

public SeLocale getLocale()
Returns the locale used by the current connection.

Returns:
the locale used by the connection

getList

public java.util.Vector getList(java.lang.Class cType)
                         throws SeException
Returns a Vector of objects from an ArcSDE instance given the class type. The following ArcSde objects can be retrieved:

Returns:
a Vector containing a list of a specified ArcSDE object.
Throws:
SeException
See Also:
getLayers(), getRegisteredTables(), getSpatialRefList(), getTables(int), getRasterColumns()

getTables

public java.util.Vector getTables(int permissions)
                           throws SeException
Retrieves a list of all tables, views, and synonyms which are available to the current user, with the given permissions. Permissions are:

Parameters:
permissions - permission bit mask.
Throws:
SeException

getRegisteredTables

public java.util.Vector getRegisteredTables()
                                     throws SeException
Returns an array of SeRegistration objects containing information for all registered tables.

Returns:
a Vector containing a list of registered ArcSDE tables.
Throws:
SeException

getVersionList

public SeVersion[] getVersionList(java.lang.String whereClause)
                           throws SeException
Returns a list of SeVersion objects accessible by the current user. The list can be filtered by an optional where clause.

Parameters:
whereClause - Applied to the SDE.VERSIONS table, a where clause specifying values of desired version properties. (Don't include the word WHERE.) If null, all versions are returned.
Returns:
array list of versions accessible to the current connection.
Throws:
SeException

getStateList

public SeState[] getStateList(java.lang.String whereClause)
                       throws SeException
Returns a list of SeState objects accessible to the current connection. The list can be filtered by an optional where clause.

Parameters:
whereClause - optional where clause to filter the list.
Returns:
array list of state objects accessible to the current connection.
Throws:
SeException

getStreamSpec

public SeConnection.SeStreamSpec getStreamSpec()
                                        throws SeException
Returns the properties of any stream that will be created with this connection. These properties are related to the pool size on the client, buffer management on the server, and the transmission of buffers betwen the client and server.

Returns:
an SeConnection.SeStreamSpec instance containing the stream properties of the current connection.
Throws:
SeException

setStreamSpec

public void setStreamSpec(SeConnection.SeStreamSpec specs)
                   throws SeException
Sets the properties of streams created by the current connection. These properties are related to buffer management on the server, and the transmission of buffers betwen the client and server.

Throws:
SeException

getSpatialRefList

public java.util.Vector getSpatialRefList()
                                   throws SeException
Returns an array of SeSpatialReference objects.

Returns:
a Vector containing a list of SeSpatialReference objects.
Throws:
SeException

getLogfileList

public SeLog[] getLogfileList(java.lang.String owner)
                       throws SeException
Returns a list of all logfiles owned by the specified owner.

Parameters:
owner - The name of the logfile owner. If null, current user is used.
Returns:
array list of log files owned by the specified user.
Throws:
SeException

getLogfileList

public SeLog[] getLogfileList(java.lang.String owner,
                              java.lang.String table)
                       throws SeException
Returns a list of all logfiles associated with the specified layer or table.

Parameters:
owner - the name of the owner. If null, current user is used.
table - the name of the table or layer.
Returns:
array list of log files associated with a specific ArcSDE table and owned by a specific user.
Throws:
SeException

getMetaDataList

public SeMetaData[] getMetaDataList(java.lang.String whereClause)
                             throws SeException
Returns the meta-data associated with a table.

Parameters:
whereClause - optional where clause to filter the data.
Returns:
array of meta-data objects associated with the specified table.
Throws:
SeException

addInstanceMetaData

public void addInstanceMetaData(int recordCount,
                                SeMetaData[] arrMetadata)
                         throws SeException
Adds new metadata records for current SE instance. Need "SDE" db_user privileges. The recordID, object_name, object_owner, object_type, and date can be set automatically.

Parameters:
recordCount - number of records to be added.*
arrMetadata - An array of valid SeMetaData objects to be added.
Throws:
SeException

alterInstanceMetaData

public void alterInstanceMetaData(int recordCount,
                                  SeMetaData[] arrMetadata)
                           throws SeException
Alters properties of the specified metadata record. Each metadata record is identified by recordID.

Parameters:
recordCount - number of records to modified.*
arrMetadata - An array of valid SeMetaData objects to modified.
Throws:
SeException

deleteInstanceMetaData

public void deleteInstanceMetaData(int recordCount,
                                   SeObjectId[] recordIds)
                            throws SeException
Deletes instance's metadata records. Each metadata record is identified by recordID.

Parameters:
recordCount - number of records to be deleted.
recordIds - list of metadata record ids to be deleted.
Throws:
SeException

getIntanceMetaDataInfoList

public SeMetaData[] getIntanceMetaDataInfoList(java.lang.String whereClause)
                                        throws SeException
Deletes instance's metadata records. Each metadata record is identified by recordID.

Parameters:
whereClause - optional where clause to filter the data.
Returns:
array of meta-data objects associated with the specified table.
Throws:
SeException

getLayers

public java.util.Vector getLayers()
                           throws SeException
Retrieves a list of all ArcSde layers that are accessible to the current user.

Returns:
a Vector containing a list of ArcSDE layers accessible by the current user.
Throws:
SeException

getTransactionAutoCommit

public int getTransactionAutoCommit()
                             throws SeException
Gets the user transaction autocommit interval for the current connection. This number is a count of the number of database write operations (stores, deletes and replaces) to allow before forcing an underlying database commit. If the value is 0, then no autocommit will be performed.

Returns:
The number of modification operations (stores, replaces, and deletes) to allow before performing an autocommit.
Throws:
SeException

getDefaultDatabase

public java.lang.String getDefaultDatabase()
                                    throws SeException
Gets the name of the default database for this connection.

Returns:
defaultDatabase Name of the default database.
Throws:
SeException

getRasterColumns

public java.util.Vector getRasterColumns()
                                  throws SeException
Retrieves a list of all ArcSde raster columns that are accessible to the current user.

Returns:
a Vector object of Raster columns accessible by the current user.
Throws:
SeException

getInstance

public int getInstance()
Returns the port number of the ArcSDE instance connected to.


getInstanceList

public java.util.Vector getInstanceList()
                                 throws SeException
Returns an array of instances objects containing information for all instances.

Returns:
a Vector containing a list of sde instances.
Throws:
SeException

enableTlmCheck

public void enableTlmCheck()
                    throws SeException
This method enables the Time Last Modified check done by the ArcSDE server for state lineages, layers, registered tables, xml columns and raster columns. The checks are enabled by default, but can be disabled using disableTlmCheck().

Throws:
SeException

disableTlmCheck

public void disableTlmCheck()
                     throws SeException
This method disables the Time Last Modified check done by the server for state lineages, layers, registered tables, xml columns and raster columns.

Throws:
SeException
See Also:
enableTlmCheck()

getUser

public java.lang.String getUser()
                         throws SeException
Returns the name of the ArcSDE user associated with the current connection.

Throws:
SeException

getRelease

public SeRelease getRelease()
Returns the version description of the ArcSDE instance to which the connection has been established.


getAdminDatabaseName

public java.lang.String getAdminDatabaseName()
                                      throws SeException
Returns the name of the administration database for this connection. For those DBMS that do not support this function, a empty string is returned.

Throws:
SeException

getSdeDbaName

public java.lang.String getSdeDbaName()
                               throws SeException
Returns the name of the ArcSDE DBA user. This is the database user that owns the ArcSDE system tables.

Throws:
SeException

getServer

public java.lang.String getServer()
Returns the name of the ArcSDE server connected to.


getServerTime

public java.util.Date getServerTime()
                             throws SeException
Returns the current time on the computer running the ArcSDE server. The time on the ArcSDE server and client computers may not match.

Returns:
The current time on the server.
Throws:
SeException

getSQLInfo

public java.lang.String getSQLInfo(int sqlId)
                            throws SeException
Returns the RDBMS dependent function name according to the specified sqlId. The sqlIds for RDBMS dependent functions are defined in SeDBMSInfo class.

Parameters:
sqlId - the sql id of an RDBMS function.
Returns:
The corresponding system function name for RDBMS.
Throws:
SeException

setConcurrency

public void setConcurrency(int policy)
                    throws SeException
Sets the concurrency policy for the SeConnection object. The concurrency policy affects how calls to other ArcSDE functions using this SeConnection object behave in a multi-threaded environment. Concurrency policies are:

Parameters:
policy - the concurrency policy.
Throws:
SeException

startTransaction

public void startTransaction()
                      throws SeException
This method begins a transaction on the current connection. The transaction is terminated by either commitTransaction() or rollbackTransaction(). You can establish an autocommit threshold for the connection with either setTransactionAutoCommit(int) or the AUTOCOMMIT parameter in the giomgr.defs file. The autocommit threshold determines how many database write operations are allowed before the transaction is automatically committed.

Throws:
SeException

testServer

public void testServer(long roundTripInterval)
                throws SeException
This method tests if this connection object is active by checking if a disconnect occured during the execution of any of the previous ArcSDE client functions. If the connection is active, this method will return without any error, otherwise an SeException, with details on the type of failure, will be thrown. If the argument roundTripInterval is less than the time since the last round trip to the ArcSDE server, this method also tests the ArcSDE server's connection to the DBMS. To force a check of the ArcSDE server's connection to the database, use a negative value, e.g. -1, for roundTripInterval.

Throws:
SeException
Since:
ArcSDE 9.1
See Also:
getTimeSinceLastRT()

getTimeSinceLastRT

public long getTimeSinceLastRT()
This method returns the time, in seconds, since the last round trip to the ArcSDE server.


databaseUse

public void databaseUse(java.lang.String database)
                 throws SeException
Changes the database or data source being used by a connection. Not all DBMS manufacturers support this functionality.

Parameters:
database - the database or data source to use.
Throws:
SeException

getDatabaseList

public java.lang.String[] getDatabaseList()
                                   throws SeException
Returns a list of databases or data sources for a DBMS instance. Not all DBMS manufacturers support this functionality.

Returns:
list of databases available.
Throws:
SeException

exportDbtune

public void exportDbtune(java.lang.String dbtuneFile)
                  throws SeException
Exports the contents of the DBTUNE table to a file. The new file is created in the $SDEHOME/etc directory.

Parameters:
dbtuneFile - name of the dbtune file to export data to.
Throws:
SeException

importDbtune

public void importDbtune(java.lang.String dbtuneFile)
                  throws SeException
Imports the data to ArcSde DBTUNE table. The dbtuneFile must exist in the $SDEHOME/etc directory. The DBTUNE table is truncated before data is imported into it.

Parameters:
dbtuneFile - name of the dbtune file to copy data from.
Throws:
SeException

commitTransaction

public void commitTransaction()
                       throws SeException
This method commits all modifications made since the last call to startTransaction(). Once this function is executed successfully, rollbackTransaction() cannot be used to undo modifications.

Throws:
SeException

rollbackTransaction

public void rollbackTransaction()
                         throws SeException
This method aborts all modifications since the last call to startTransaction(), or any intermediate commits on a transaction resulting from a call to commitTransaction(), or an automatic commit (See the AUTOCOMMIT parameter in the giomgr.defs file).

Throws:
SeException

setTransactionAutoCommit

public int setTransactionAutoCommit(int interval)
                             throws SeException
Sets the user transaction autocommit interval. This number is a count of the number of database write operations (stores, deletes, and replaces) to allow before forcing an underlying database commit. If 0 is specified, then no autocommit will be performed. If not set by this call, the interval will default to the value of the AUTOCOMMIT parameter in the giomgr.defs file.

Parameters:
interval - number of modification operations to do before an autocommit.
Returns:
the previous autocommit interval
Throws:
SeException

close

public void close()
           throws SeException
Closes the connection to the ArcSDE instance.

Throws:
SeException

isClosed

public boolean isClosed()
Returns TRUE if the connection has been closed, FALSE otherwise.


isAdmin

public boolean isAdmin()
                throws SeException
Check whether the connected user has admin privilege.

Returns:
TRUE if connected user has admin privilege
Throws:
SeException

switchToProxySession

public void switchToProxySession(java.lang.String username,
                                 java.lang.String password,
                                 java.lang.String[] role_array,
                                 int num_roles,
                                 java.lang.String distinguished_name)
                          throws SeException
Switch to the proxy session.

Throws:
SeException

restorePrimarySession

public void restorePrimarySession()
                           throws SeException
Restore primary session on the connection.

Throws:
SeException