| :ent-list | Index Level | :ent-status |
| Syntax | :ent-mon id{,id{,..}} {(option} |
| Category | TCL |
| Type | Verb |
| Description |
monitors the data sent to an entity in the system.
"id" is the list of entity IDs to be monitored. For example 'p12' is the Pick process 12, 's45' is the serial port number 45, etc... See the section 'entity' for the structure of the entity IDs. All data sent to the specified entity is also displayed on the m onitor screen, it is sent to the monitoring terminal. By entering a '~' (tilde) on the current terminal, ":ent-mon" enters a Monitor Command Mode, where the user can enter either a TCL command, executed on the current process, or a Monitor command: continue Exit Monitor Command Mode and return to Monitor mode. Or simply type <cr> at the "Monitor:" prompt. esc Change the escape character to enter Command Mode from the Monitor Mode. The new escape character can be specified in decimal (eg 65), hexadecimal prefixed by a period (eg .41), or as a character between single quotes (eg 'A'). exit Terminate Monitor. help Display a help. mode Specify the display mode. The mode is specified by "normal" (data is displayed as is), "hex" (each character is displayed as two hexadecimal characters) or "text" (printable characters are displayed normally, Pick system delimiters are displayed by their usual representation and other characters are displayed as dots). Without argument, the current mode is displayed. search Specify a list of characters to be searched in the incoming data stream. A character can be specified in decimal (eg 65), hexadecimal prefixed by a period (eg .41), or as one or more characters between quotes (eg c'ABC'). More than one character can be specified by separating them with commas (eg .0d,.0a,'$01'). Any character found in the search list will be highlighted on the display. Without any argument, the search is deactivated. This command requires a SYS2 privilege. |
| Options | x Stop Monitoring the specified entities. This option can be used to terminate the monitor if the process doing the monitor was logged off, for example. |
| See Also | entity tandem converse mirror :ent-list dev-att :ent-status |
| Example |
:ent-mon p1,s2
Monitor all data sent to Process 1 and Serial port 2. |
| Warnings |
The terminal attached to the monitoring process is NOT deactivated. In other words, entering characters on this terminal will also be displayed.
It is important to understand that this utility is monitoring the data that is RECEIVED by an entity, not the data it is SENDING. If it is required to monitor this data, the monitoring must be done on the DESTINATION entity, not the source. When monitoring both a process and its terminal, and if the process is doing echo, data may appear to be duplicated on the monitoring terminal. When searching for non printable characters (eg NULLS), the display mode must be set to either "hex" or "text", else, since these characters no not occupy a spot on the screen, they cannot be highlighted. If one of the monitored entities receives the Command Monitor Mode escape character ('~' by default), the monitoring process will enter the monitor mode and accept commands from both the monitored entity and the monitoring terminal. |
| Compatibility | AP 6.1 |
| :ent-list | Index Level | :ent-status |