This topic contains sections marked as revised for this release

WebSphere Message Brokers
File: as07540_
Writer: Lorraine Waitt

Reference topic

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

cniCreateOutputTerminal

Creates an output terminal on an instance of a node object, returning the address of the terminal object that was created. The terminal object is destroyed when its owning node is destroyed.

You must call this function only from within the implementation function cniCreateNodeContext.

Syntax

CciTerminal* cniCreateOutputTerminal(
  int*      returnCode,
  CciNode*  nodeObject,
  CciChar*  name);

Parameters

returnCode
The return code from the function (output).
Possible return codes are:
  • CCI_SUCCESS
  • CCI_FAILURE
  • CCI_EXCEPTION
  • CCI_INV_NODE_OBJECT
  • CCI_INV_TERMINAL_NAME
nodeObject
The address of the instance of the node object on which the output terminal is to be created (input). The handle is passed to the cniCreateNodeContext function.
name
The name of the terminal being created (input).

Return values

If successful, the address of the node terminal object is returned. Otherwise, a value of zero (CCI_NULL_ADDR) is returned.

Example

    entry->handle = cniCreateOutputTerminal(
                                           &rc, 
                                           context->nodeObject
                                           (CciChar*)terminalName);
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:16

as07540_ This topic's URL is: