Rockwell Automation 9220-TG QUICK START CONTROLNET MESSAGE - Manual (Page 30)

ControlNet Message/Traffic Generator Tool 30
Publication 9220-10.1 — July 1996
Message/Traffic Generator API Functions
The following functions can be used to create executable test programs,
for testing on a ControlNet network. Once created, these programs can
be added to CNXOR.CFG so they can be accessed in the tool from the
Modules pull-down menu.
Use this function To See page
MG_Env ( )
read the message/traffic generator environment
variable and fill in the global configFile string.
31
MG_Init ( ) initialize the message/traffic generator interface. 31
MG_Cleanup ( ) clean up the message/traffic generator interface. 31
MG_LoadCNSetup ( ) load a ControlNet setup from CNXOR.CFG. 32
MG_Online ( )
put the message/traffic generator in listen only
mode until it receives a moderator type packet,
then it goes online with the target, otherwise it
remains in the listen only mode.
32
MG_Offline ( )
take the message/traffic generator offline with
the target.
32
MG_OpenConnection ( ) open a connection with the target device. 33
MG_CloseConnection ( ) close a previously opened connection. 33
MG_SendUnconnected ( ) send an unconnected user-supplied message. 33
MG_SendUnconnectedMsg ( )
send an unconnected message from
CNXOR.CFG.
34
MG_ReceiveUnconnected ( )
receive an unconnected message from
the UCMM.
34
MG_SendConnected ( )
send a user-supplied message on a connection
previously opened with a call to
MG OpenConnection.
34
MG_ReceiveConnected ( )
receive a message on a connection previously
opened with a call to MG OpenConnection.
35
MG_SendConnectedMsg ( )
send a message from the config file on a
connection previously opened with a call to
MG_OpenConnection.
35
MG_RegisterClass ( )
register a class with the message router for
receipt of the unsolicited messages.
36
MG_UnregisterClass ( )
unregister a class with the message router
that was previously registered with
MG RegisterClass.
36