tcl.:ent-mon Verb: Access/TCL


Command tcl.:ent-mon Verb: Access/TCL
Applicable release versions: AP 6.1
Category TCL (746)
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.
Syntax :ent-mon id{,id{,..}} {(option}
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.
:ent-mon p1,s2
  Monitor all data sent to Process 1 and Serial port 2.
Related general.entity