Control
interface is a socket which is open by JDBLabAgent if the parameter port is set:
>java -Xdebug
-Xrunjdlabagent:port=60010 ...
For
communication the jdlabctl utility from JDLabAgent
package can be used.
Control Interface
HELP
|
Displays help message. |
||
START
|
Starts tracing. This
command always starts a new trace file. |
||
STOP
|
Stops tracing. Does nothing
if tracing is already stopped. |
||
RELOAD-CONFIG [<fileName>]
|
Reloads the configuration
file <fileName>. Tracing is immediately resumed if it was enabled
before. If <fileName> is ommitted the current
configuration file is reloaded. This command always starts a new trace file. |
||
UNLOAD-CONFIG
|
Stops profiling and unloads
the configuration data, i.e. frees the memory used for the configuration
data. |
||
GET <parameter>
|
Gets information about the
state of the JDLabAgent. |
||
|
|
|
||
<parameter> :=
|
configfile | tracefile | trace | exception | log |
log_debug | log_info | log_warn
| log_error | log_to_stdout |
||
configfile
|
Gets the name of the
configuration file. |
||
tracefile
|
Gets the name of the
current trace file. |
||
trace
|
Shows if profiling is
enabled. |
||
exceptions
|
Shows if Java exceptions
are profiled. |
||
log
|
Gets the log type. |
||
log_debug
|
Shows if the profiler logs
debug messages about itself. |
||
log_info
|
Shows if the profiler logs
info messages about itself. |
||
log_warn
|
Shows if the profiler logs
warning messages about itself. |
||
log_error
|
Shows if the profiler logs
error messages about itself. |
||
log_to_stdout
|
Shows if the profiler logs
messages to stdout. |
||
|
|
|
||
SET <parameter>
|
Sets the state of the
profiler. |
||
<parameter> :=
|
exceptions=(on|off) |
log=(BasicText|MIDText) | log_debug=(on|off) | log_info=(on|off) | log_warn=(on|off)
| log_error=(on|off) | log_to_stdout=(on|off) |
||
exceptions=(on|off)
|
Enables or disables
profiling of Java exceptions. |
||
log=(BasicText|MIDText)
|
Sets the log type. |
||
log_debug=(on|off)
|
Enables or disables logging
of debug messages. |
||
log_info=(on|off)
|
Enables or disables logging
of info messages. |
||
log_warn=(on|off)
|
Enables or disables logging
of warning messages. |
||
log_error=(on|off)
|
Enables or disables logging
of error messages. |
||
log_to_stdout=(on|off)
|
Enables or disables logging
of messages to stdout. |
||
___________________________________________________________________________________