Adapter Development Kit 9.12 | webMethods Adapter Development Kit Documentation | webMethods Adapter Development Kit Installation and User’s Documentation | Using the Services for Managing Namespace Nodes | Connection Services | wm.art.dev.connection:updateConnectionNode
 
wm.art.dev.connection:updateConnectionNode
This service updates the values of an existing connection.
*You must disable the connection node before you update it, using the pub.art.connection:disableConnection service.
For more information, see the webMethods Integration Server Built-In Services Reference for your release.
You must perform the following steps to populate the input pipeline:
1. Use wm.art.dev.connection:fetchConnectionManagerMetadata service to identify the supported connection manager properties and configure the connectionManagerSettings input parameter.
2. Use wm.art.dev.connection:fetchConnectionMetadata service to identify the connection-specific properties and configure the connectionSettings input parameter.
3. Provide values for the properties you want to change.
This service attempts to overlay these new values on the connection's current property values. The resulting set of merged property values are used to reconfigure the connection.
If you are not changing any connection manager or connection-specific properties, it is not necessary to pass in that container parameter. For example, if you are not changing any connection manager properties, you must not build and pass in the connectionManagerSettings parameter.
4. If you are providing explicit property values in connectionManagerSettings and connectionSettings parameter, then the values must conform to the underlying data types of those properties.
For an example of setting a connection property, see the Java code example in wm.art.dev.connection:createConnectionNode.
Input Parameters
Name
Description
connectionAlias
String. Required. Name of the connection in the format: folder:node.
connectionManagerSettings
IData. Required. Structure for passing connection's manager property values. The connection's manager property are predefined for all connections.
poolable
Boolean. Required. Determines whether to pool the connection.
Note:
If poolable is false, then the following property values are not used:
*minimumPoolSize
*maximumPoolSize
*poolIncrementSize
*blockingTimeout
*expireTimeout
minimumPoolSize
Integer. Minimum number of connections retained in the pool.
maximumPoolSize
Integer. Maximum number of connections retained in the pool.
poolIncrementSize
Integer. Number of connections to add to the pool when additional connections are needed and must not exceed maximumPoolSize.
blockingTimeout
Integer. Milliseconds to wait for a connection.
expireTimeout
Integer. Milliseconds of inactivity that may elapse prior to destroying the connection.
connectionSettings
IData. Required. Structure for passing a connection's property values. The actual connection properties and their underlying data types vary from adapter to adapter. You must set a connection property's value in accordance with its data type. To determine the value, call the service wm.art.dev.connection:fetchConnectionMetadata and note the parameterType attribute for that property.
systemName
String. Internal name of the property.
For more information about the predefined connection manager properties, see wm.art.dev.connection:fetchConnectionManagerMetadata
For more information about the adapter-specific connection properties, see wm.art.dev.connection:fetchConnectionMetadata
Output Parameters
None.