run

Name

run — process one or more messages

Synopsis

Supported for RTmon:

run 
run num_msgs [timeout] 

Description

The run command causes the RT process to process one or more messages.

If run is called without any arguments, it processes messages indefinitely.

For RTserver, the command run numloops (where numloops is an integer) causes RTserver to run through its processing loop the specified number of times. This loop waits for data to arrive from another process or for a process to connect, and then processes all available data and new connections.

For RTmon, the command run num_msgs (where num_msgs is a positive integer) causes RTmon to run through num_msgs messages. By default, RTmon waits indefinitely for each message to arrive. This can be overridden by specifying a timeout (in seconds). If timeout is reached, the run command stops and returns control to the command interface. To process all messages that are available within timeout seconds, use a command such as run 1000000 timeout.

Caution

The run command cannot be used in rtserver.cm startup command files, it is only available to RTserver once RTserver is fully initialized and ready to run.

The run command causes RTmon to connect to RTserver if it has not already done so.

See Also

poll, watch, unwatch

Examples

MON> watch client_names 
Start watching client_names. 
MON> run 2 5 /* wait up to 5 seconds for each message */ 
WATCH> Current Clients: 
 /_workstation1_27497 [Runtime_RTmon: ssuser@workstation1] 
   connected to RTserver /_workstation1_8055 
Processed a mon_client_names_status message. 
Timeout of 5 was reached. 
MON> watch subject_names 
Start watching subject_names. 
MON> run 1 
WATCH> Current Subjects: /_all /_workstation1 /_workstation127497 
/_mon 
Processed a mon_subject_names_status message.