skip to main content
Using the driver : Using connection properties : Web service properties
  

Try DataDirect Drivers Now

Web service properties

The following table summarizes Web service connection properties, including those related to timeouts.
Table 16. Web Service Properties
Property
Characteristic
The amount of time, in seconds, that the driver waits for a connection to be established before timing out the connection request.
If set to 0, the driver does not time out a connection request.
If set to x, the driver waits for the specified number of seconds before returning control to the application and throwing a timeout exception.
The default is 0 (no timeout).
Specifies the maximum number of Web service calls the driver can make when executing any single SQL statement or metadata query.
If set to 0, there is no limit.
If set to x, the driver uses this value to set the maximum number of Web service calls on a single connection that can be made when executing a SQL statement. This limit can be overridden by changing the STMT_CALL_LIMIT session attribute using the ALTER SESSION statement.
The default is 0 (no limit).
Specifies the behavior of the driver when the maximum Web service call limit specified by the StmtCallLimit property is exceeded.
If set to errorAlways, the driver generates an exception if the maximum Web service call limit is exceed.
If set to returnResults, the driver returns any partial results it received prior to the call limit being exceeded. The driver generates a warning that not all of the results were fetched.
The default is errorAlways.
Specifies the number of rows of data the driver attempts to fetch for each JDBC call when paging is enabled for an endpoint.
If set to 0, the driver attempts to fetch up to the maximum number of row specified by the maximumPageSize property. This value typically provides the maximum throughput.
If set to x, the driver attempts to fetch up to the maximum of the specified number of rows. Setting the value lower than the maximum can reduce the response time for returning the initial data. Consider using a smaller WSFetch size for interactive applications only.
0 (up to the maximum number of rows specified by the maximumPageSize property)
Specifies the maximum number of sessions the driver uses. This allows the driver to have multiple web service requests active when multiple JDBC connections are open, thereby improving throughput and performance.
The default is 1.
The number of times the driver retries a timed-out Select request.
If set to 0, the driver does not retry timed-out requests after the initial unsuccessful attempt.
If set to x, the driver retries the timed-out request the specified number of times.
The default is 5.
Specifies the time, in seconds, that the driver waits for a response to a Web service request.
If set to 0, the driver waits indefinitely for a response; there is no timeout.
If set to x, the driver uses the value as the default timeout for any statement created by the connection.
The default is 120.