This method opens a connection that is identical to a previously opened connection. Use this method to have two or more concurrent transactions against the same database with the same parameter settings.

The syntax is:

The DBSessionObject object on which the method is invoked must represent an open session, because this method uses the existing session as a template for the new session.

When the method completes, it returns a DBSessionObject object representing the new session. The new session accesses the same database and runs under the same flags as the existing session. If the method fails, it returns null.

For more information about these statements, see the Language Reference Guide.