Manipulate Nodes

Component Group classes provide methods to make changes on a Connect:Direct® node.

The Component Group classes represent Connect:Direct entities and provide methods to manipulate an object to generate changes on the Connect:Direct node. Use the following classes to manipulate nodes:

Class Description
CDNode Contains the high-level Connect:Direct functionality. It returns network map, initialization parameters, and translation table information as well as User and Proxy objects that maintain node information and execute command objects.
CDUser Contains the user functional authority information. Use to add, delete, and update functional authorities on the Connect:Direct node, including Network map Access Flags, Command Access Flags, Control Flags, Process Statement Flags, and default directories.
CDProxy Contains the Connect:Direct proxy information. Use to add, delete, and update proxy information on the Connect:Direct node. The remote user proxy contains information for operations initiated from a remote Connect:Direct node and defines relationships between a remote node and local user IDs.
CDTranslationTable Contains and maintains the translation table information that translates data being sent to other nodes and provides methods for setting and retrieving translation information.
CDTrace Holds the trace criteria. It contains all the fields returned from the node with the TRACEON command, with no parameters and provides access methods for all of the Trace fields.
CDNetmapNode Contains the network map node information.
CDNetmapDesc Contains the description for a network map node.
CDNetmapPath Contains the network map path information.
CDNetmapMode Contains the network map mode information.

When using the C++ Class interface, no sequence must be followed when using the C++ classes. All objects are self-contained and are not dependent on any other classes when fully constructed. Each object's constructor is different and some of the objects require another object to be built successfully.

The first and most important class is the CDNode class. This class is the first one to use when interacting with any Connect:Direct node.

While the only prerequisite for constructing a class is the creation of the objects needed by the constructor, the following example shows a possible sample execution sequence:

 CDNode creation 
             CDSelectProcCommand creation 
                CDProcIterator creation 
                       (Use the data) 
                CDProcIterator destruction 
             CDSelectProcCommand destruction 
 CDNode destruction

The Connect:Direct CDNode class serves as the virtual Connect:Direct node. It enables you to manipulate and send commands to the actual Connect:Direct node. You manipulate this object through the use of the CDNode methods and issue commands to the node using Command objects. Calling these methods and using the objects sends KQV streams to the physical Connect:Direct node. See the C++ API Reference Guide for more information.