DB2 10.5 for Linux, UNIX, and Windows

DB2Connection.ARMCorrelator Property

Sets the connection property to allow the association of statements to a workload manager on the data server.

Namespace:
IBM.Data.DB2
Assembly:
IBM.Data.DB2 (in IBM.Data.DB2.dll)

Syntax

[Visual Basic]
Public Property ARMCorrelator As byte[]
[C#]
public byte[] ARMCorrelator {set;}
[C++]
public: __property void set_ARMCorrelator(byte[]*);
[JScript]
public function set ARMCorrelator(btye[]);

Property value

The property value must be a non null, byte[] with a length greater than 0 and less than or equal to 255. Values outside this will result in an exception being thrown.

Remarks

The ARMCorrelator property must be set before the connection is opened. This property can be set at any unit of work boundary, and will flow to the server with the next server request. An exception will be thrown if this property is set while a unit of work is open.

No changes are made to this property when the connection is returned to the connection pool, or when a connection is taken from the connection pool. As a result, any ARMCorrelator set previously on the pooled connection will remain in effect.

For IBM® Power Systems™ and z/OS® servers, the ARMCorrelator property can only be set before the connection is open. Connection pooling should be disabled, otherwise a connection from the pool will be retrieved which would not allow the ARMCorrelator to be updated. The z/OS and IBM Power Systems conditions are not enforced by the IBM Data Server Provider for .NET, they may result in the operation being ignored, or a server generated error message.

This property is available for all servers and will perform no action when set against a server that does not have EWLM support.

The ARMCorrelator property can not be set in Microsoft Visual Studio for the DB2Connection object. This property must be set by explicitly coding the property assignment in the application.

This property is supported for DB2® Version 9.1, Fix Pack 4 and later.

Data server restrictions

Informix®
This property has no effect.