.. _dpiPoolGetMode:
ODPI-C Enumeration dpiPoolGetMode
---------------------------------
This enumeration identifies the mode to use when getting sessions from a
session pool.
=========================== ==================================================
Value Description
=========================== ==================================================
DPI_MODE_POOL_GET_WAIT Specifies that the caller should block until a
session is available from the pool.
DPI_MODE_POOL_GET_NOWAIT Specifies that the caller should return
immediately, regardless of whether a session is
available in the pool. If a session is not
available an error is returned.
DPI_MODE_POOL_GET_FORCEGET Specifies that a new session should be created if
all of the sessions in the pool are busy, even if
this exceeds the maximum sessions allowable for
the session pool (see
:member:`dpiPoolCreateParams.maxSessions`)
DPI_MODE_POOL_GET_TIMEDWAIT Specifies that the caller should block until a
session is available from the pool, but only for
the specified length of time defined in
:member:`dpiPoolCreateParams.waitTimeout`. If a
session is not available within the specified
period of time an error is returned.
=========================== ==================================================