The new tracing system has been updated so that it works on the bio* machines. To use the system, start at /FIG/Html/SetPassword.html on whichever version of SEED you're debugging. Contact me via EMAIL if you don't know the password. Fill your name or something similar into the Tracing Key field, then submit the form. This will take you to the Sprout debugging console. The tracing form is at the bottom.
Click here for information on how to enable your web scripts for tracing and generate trace messages. When you activate tracing using the Emergency Tracing form on the debug page, it creates a file in the FIG temporary directory. Your tracing key is stored in a cookie as long as you stay on the debug form, and the web scripts can use the cookie to find the temporary file and turn on the type of tracing indicated. There are also buttons on the form for turning off tracing and for showing the tracing file.
Most tracing commands look something like this.
Trace("$fileName found.") if T(3);
The number in the T call is the tracing level: 0 for errors, 1 for warnings, 2 for notices, 3 for information, 4 for details. If the trace command is in a high-level script, it will be considered part of the main tracing category and will always display if the tracing level is set high enough. Otherwise, the name of the package containing the command is used as the category. Thus, if you want to turn on tracing for the Subsystem.pm package, you would enter Subsystem in the Category box. There are some special tracing categories, such as SQL, nsims, and File. These have checkboxes on the form. Hold the mouse over the checkbox to see its description.
To enable tracing in a web script, use the ETracing or StandardSetup methods near the beginning of the web script. You must have use Tracer in your code to make sure the tracing methods compile properly.
Leave a comment