- TIBCO SmartSockets provides extensive monitoring capabilities through the TipcMon* API and the TipcMon C++ Class.
- The monitoring capabilities are not available when using peer-to-peer connections (TipcConn*).
- All program monitoring goes through RTserver and information can be gathered for only one project at a time.
- The monitoring API can be used to locate processes on the network, such as finding all processes subscribed to a specified subject.
- There are two different types of monitoring:
- Polling for a one-time snapshot of information (TipcMon*Poll), or
- Watching for continuous notification whenever an item of interest changes (TipcMon*Watch).
- Monitoring is initiated by calling a TipcMon* function, which initiates messages of type MON_*_SET_WATCH or MON_*_POLL_CALL to be sent to RTserver.
- Monitoring information is returned to the requesting program from RTserver through MON_*_STATUS or MON_*_POLL_RESULT message types.
- There is no monitoring information returned if a poll or watch is issued with a bad argument, such as an unknown client name or a subject to which no processes are subscribed.
- User-defined message process callbacks must be written to handle the incoming monitoring information.
- The Unique_Subject option should be explicitly set to make it easy to identify a program in the project. This option must be explicitly set to use some features of TIBCO SmartSockets, such as, guaranteed message delivery.
- The API function TipcSrvMsgSearchType can be used to search the input message queue for a message of a given type.
- The API function TipcMsgRead is a convenience function (similar to TipcMsgWrite) that can be used in place of the TipcMsgNext* functions to get all the fields of a message with one call.
- TipcSrvMainLoop can be used with a timeout to poll for project information on a regular time interval.
- RTmon is a powerful tool for monitoring and debugging your project built with TIBCO SmartSockets.
- The RTmon Main window presents an animated graphical tree of a project, which is updated in real time as changes occur, such as a process joins the project.
- From RTmon, you can build and publish messages to any processes in your project, regardless of where they are running in the network. A typical use of this feature might be to send a CONTROL message to stop a process or group of processes.
- RTmon can be used to watch resource usage of processes in a TIBCO SmartSockets project and stop processes through the GDI.
- RTmon is a valuable support tool. It can be run remotely to help diagnose problems in a TIBCO SmartSockets project.