unwatch

Name

unwatch — stop watching monitoring information

Synopsis

Supported for RTmon only:

unwatch client_buffer client 
unwatch client_msg_recv client msg_type 
unwatch client_msg_send client msg_type 
unwatch client_names 
unwatch client_subscribe client 
unwatch client_time client 
unwatch project_names 
unwatch server_conn 
unwatch server_names 
unwatch subject_names 
unwatch subject_subscribe subject 

Description

The unwatch command is used to stop watching monitoring information. The unwatch command uses the TipcMonTypeSetWatch API functions to stop the watching. See watch for more information on the RTmon watch categories.

For all of the user-specifiable parameters (such as client, server, or subject), a single item can be specified by name or @ (an at sign) can be used to specify all items that match Monitor_Scope or all items of that type (such as all RTclients or all subjects). For client (RTclient processes), server (RTserver processes), and process (RTclient or RTserver processes), the process is identified by its unique subject. See Specifying Items to be Monitored for complete information on monitoring parameters.

Caution

The RTmon GDI uses the poll, watch, and unwatch commands to control RTmon. Because the GDI needs complete control over these commands, these three commands are unavailable for interactive use (entering at the GDI MON> prompt) when using the GDI. These three commands are always available when using the runtime RTmon.

Only one project at a time can be monitored by each RTmon process. Information in other projects is not visible. To monitor a different project, the option Project must be changed, and then RTmon must disconnect and reconnect to RTserver.

The unwatch command causes RTmon to connect to RTserver if it is not already connected. A warning message is printed if an unwatch is requested for a category not being watched.

See Also

watch

Examples

This example shows how watching is started and stopped for certain subjects:

MON> watch subject_names 
Start watching subject_names. 
MON> run 
WATCH> Current Subjects: /_all /_workstation1 
/_workstation1_27709/_mon 
^C*** Received interrupt from user. *** 
MON> unwatch subject_names 
Stop watching subject_names.