Owner's manual

Section 6. CsiBrokerMap Control

6.1 Purpose of the CsiBrokerMap Control

The CsiBrokerMap control gives developers access to the broker map, which is

the list of brokers or dataloggers known by the LoggerNet server. This control

also keeps track of all tables on each of the brokers including the table

definitions or columns. This table information is derived from the collect

areas that are known by the LoggerNet server. Collect areas are known by the

LoggerNet server after a datalogger program has been associated or table

definitions have been retrieved. The user may also create collect areas

manually in the LoggerNet server.

The information given by the CsiBrokerMap control can be used as parameters

for other controls in the SDK. For example, the CsiDataLogger control can use

the name of a datalogger that was displayed to the user through the

CsiBrokerMap control. Similarly, the CsiBrokerMap control can display

specific brokers, tables, and columns that the CsiDataSource control can use to

create an advisor that monitors acquired data.

This control can also be used in combination with the CsiDatalogger control to

set a value within a datalogger table. With information about the names of a

broker, a table, and a column provided by the CsiBrokerMap control, the

variableSetStart method of the CsiDatalogger control could be used to set

the value of that column.

The CsiBrokerMap can be a useful tool to display the dataloggers, tables and

columns that exist in the LoggerNet server datalogger network.

6.2 Connecting to the LoggerNet Server

There are two basic actions required to connect to the LoggerNet server:

1) Set server properties:

serverName - The name of the LoggerNet server or IP address. The

default value is

localhost.

b) serverPort - The port on which the LoggerNet server is running. The

default value is

6789.

c) serverLogonName (Optional) - If security has been enabled on the

server, a valid logon name is required.

serverLogonPassword (Optional) - If security has been enabled on

the server, a valid password that corresponds with a valid logon name

is required.

2) Invoke the s

tart() method.

6-1