bea.jolt.pool.asp
Class AspSessionPool

java.lang.Object
  |
  +--bea.jolt.pool.Factory
        |
        +--bea.jolt.pool.SessionPool
              |
              +--bea.jolt.pool.asp.AspSessionPool

public class AspSessionPool

extends SessionPool

This class provides a SessionPool implementation for the Microsoft Active Server Pages environment.

Method Summary

Result	call(java.lang.String svcname, java.lang.String[] input, Transaction tran) Invokes a BEA Tuxedo service.
Result	callEx(java.lang.String svcname, AspDataSet input, Transaction tran) Invokes a BEA Tuxedo service.

Methods inherited from class bea.jolt.pool.SessionPool

call, getAppAddr, getConnection, getFailOverAddr, getMaxConnections, getMinConn, getPoolName, getSecurityContextClass, getUser, isSuspended, propagateSecurityContext, setMaxConnections, startTransaction

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

call

public Result call(java.lang.String svcname,
                   java.lang.String[] input,
                   Transaction tran)

Invokes a BEA Tuxedo service. The name of the service to be invoked is passed to this method as a String svcname. Input parameters for the service are passed in input. The input is either a String array with name=value pairs or a null for an implicit ASP Request object. The name in the name=value pair should match the parameter name in the Jolt service definition. The member name in the Request object may have a trailing "_" and an index number (e.g. SBALANCE_0) if it is a multiple occurrence field. Any non-matching parameter names in the input or Request object are ignored. The tran parameter must be the object returned by the startTransaction() method, or null.

If the session pool is suspended or if no connections are available, this method returns null.

Parameters:

svcname - The name of a Tuxedo service

input - An array of String name-value pair, or null for ASP built-in Request object

tran - Transaction object, or null if no transaction

Returns:

bea.jolt.pool.asp.Result object, or null

See Also:

callEx(java.lang.String, bea.jolt.pool.asp.AspDataSet, bea.jolt.pool.Transaction), SessionPool.startTransaction(int), AspResult

callEx

public Result callEx(java.lang.String svcname,
                     AspDataSet input,
                     Transaction tran)

Invokes a BEA Tuxedo service. The name of the service to be invoked is passed to this method as a String svcname. Input parameters for the service are passed in input. If no input parameters are required for the service, input should be null. The names of the elements in the input must match the names of the service parameters.

To invoke multiple services in a transaction, create a Transaction object (see startTransaction()) and pass the Transaction object as the parameter tran. If this service is not part of a transaction, tran should be null.

If the session pool is suspended, or if no connections are available, this method returns null.

Parameters:

svcname - Name of the service to be invoked

input - AspDataSet containing service parameters, or null if no input parameters

tran - Transaction object, or null if no transaction

Returns:

bea.jolt.pool.asp.Result object, or null

See Also:

call(java.lang.String, java.lang.String[], bea.jolt.pool.Transaction), SessionPool.startTransaction(int)