IBM Integration Bus, Version 10.0.0.0 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


cniSetAttribute

This function sets the value of an attribute on a specific node instance. It is called by the integration node when a configuration request is received that attempts to set the value of a node attribute, or during initialization of the node.

A node receives requests to set attributes for the base. If an unknown attribute value is received, this function must return a non-zero value so that the integration node processes the request correctly.

The responsibilities of the node are to:
  1. Verify that the value of the attribute is correctly specified. If not, a configuration exception should be thrown using the cciThrowException function.
  2. Store the value of the attribute within the context, which should have been allocated in the cniCreateNodeContext function.
  3. Throw a configuration exception if an error occurs, by using the cciThrowException function.
Defined In Type Member
CNI_VFT Optional iFpSetAttribute

Syntax

int cniSetAttribute(
  CciContext*  context,
  CciChar*     attrName,
  CciChar*     attrValue);

Parameters

context
The address of the context for the instance of the node, as created by the node and returned by the cniCreateNodeContext function (input).
attrName
The name of the attribute whose value is to be set (input).
attrValue
The value of the attribute (input).

Return values

If successful, zero is returned. If the name of the attribute does not identify one supported by the node, a non-zero value is returned.


as07490_.htm | Last updated 2015-03-27 19:27:18