TipcInitCommands

Name

TipcInitCommands — create SmartSockets IPC commands

Synopsis

T_BOOL TipcInitCommands()

Arguments

None

Return Values

TRUE if the SmartSockets IPC commands were successfully created, FALSE otherwise.

Diagnostics

If TipcInitCommands fails, it returns FALSE and sets the global SmartSockets error number to:

T_ERR_ALREADY_EXISTS — the SmartSockets IPC commands have already been created

Description

TipcInitCommands adds these IPC-specific commands to the SmartSockets command interface:

connect — create connection to RTserver

disconnect — destroy connection to RTserver

subscribe — start subscribing to one or more subjects

unsubscribe — stop subscribing to one or more subjects

TipcInitCommands is useful for user-defined processes.

Caution

The commands created with TipcInitCommands (connect, disconnect, subscribe, and unsubscribe) act on the global connection unless received via a CONTROL message, in which case the command is applied to the connection on which it was received.

Examples

This example adds the IPC commands, connects to RTserver, and subscribes to the subject /foo:

if (!TipcInitCommands()) { 
  return;  /* error */ 
  } 
 TutCommandParseStr("connect"); 
 TutCommandParseStr("subscribe /foo");