WebSphere Message Brokers
File: as07490_
Writer: Lorraine Waitt

Reference topic

This build: July 31, 2007 21:37:14

cniSetAttribute

Sets the value of an attribute on a specific node instance. It is invoked by the message broker 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 broker processes the request correctly.

The responsibilities of the node at this point 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, 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.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:37:14

as07490_ This topic's URL is: