monitor Command

Description

Starts or stops monitoring a monitorable output of a component instance. Any raw output file of a component instance may be monitored. Additional monitorable outputs may be available also (see the listMonitors command). The monitor command is most useful in raw mode where a command ID has been assigned to the monitor start command. The current contents of the file or output will be immediately returned to the client with the same command ID. Then, as the file changes additional responses with the same command ID will be returned with the data as it is generated, much in the same way that the UNIX "tail -f" command works.

A monitor may be turned off by issuing a "monitor stop <id>" command, where <id> is the command ID that was sent with the monitor start command. The monitor stop command is only available when using a raw mode connection.

Command Syntax

monitor start <object.property>, monitor stop <id>

Example

The following Analysis Server dialog shows how to monitor a monitorable output.

>start DarwinExample de
Object destarted.
>listMonitors de
3 monitors:
stdout
stderr
outputDebugInfo
>monitor start a.stdout
------------------------------------------------------
Darwin Example Debug File
------------------------------------------------------
...