Using trace
MQAX includes a trace facility to help the service organization identify what is happening when you have a problem. It shows the paths taken when you run your MQAX script. Unless you have a problem, run with tracing set off to avoid any unnecessary use of system resources.
- OMQ_TRACE
- OMQ_TRACE_PATH
- OMQ_TRACE_LEVEL
Note that specifying any value for OMQ_TRACE switches the trace facilty on. Even if you set OMQ_TRACE to OFF, trace is still active.
To switch trace off, do not specify a value for OMQ_TRACE.
- Click Start
- Click Control Panel
- Double-click System
- Click Advanced
- Click Environment
- In the section titled "User variables for (username)", click New
- Enter the variable name and a valid value in the appropriate fields and click OK
- Click OK to close the Environment Variables window
- Click OK to close the System Properties window
- Close the Control Panel window
When deciding where you want the trace files written, ensure that you have sufficient authority to write to, not just read from, the disk.
With tracing switched on, it slows down the running of the MQAX, but it does not affect the performance of your ActiveX or WebSphere® MQ environments. When you no longer need a trace file, you can delete it.
You must stop MQAX running to change the status of the OMQ_TRACE variable.
Trace file name and directory
The trace file name takes the form OMQnnnnn.trc, where nnnnn is the id of the ActiveX process running at the time.
|