DB2 Server for VSE & VM: Operation

Stopping a Trace

In single user mode, the trace ends when the application server ends. (Remember, you cannot enter operator commands in single user mode.) To deactivate a trace in multiple user mode, enter the following operator command:

.-CLOSE---. >>-TRACE OFF----+---------+---+-----------+-------------------->< '-NOCLOSE-' '-TRCPURGE--'

OFF

indicates trace deactivation.

CLOSE

specifies that the trace file is to be closed. In DB2 Server for VSE it also specifies that the trace file is to be unassigned. The default is CLOSE. If you specify the CLOSE parameter, the trace file will be overwritten when issuing a subsequent TRACE ON command.

NOCLOSE

specifies that the trace file is to be left open for further tracing into the same file with a subsequent TRACE ON.

If you are tracing to tape, specify either CLOSE or NOCLOSE and then TRACE ON to create multiple trace output files.

In DB2 Server for VM you must specify the LEAVE option on the ARITRAC FILEDEF command.

Note:

You can use the LEAVE option to process these files sequentially when you are formatting trace output.

TRCPURGE

Specify this optional parameter if you want to purge the contents of the trace buffer when the TRACE OFF command is processed. In this instance an output trace file will not be created for the trace buffer. Otherwise the contents of the trace buffer, if it exists, will be flushed out to the trace output file. The TRCPURGE parameter is ignored if there is no trace buffer in use when TRACE OFF is issued.

If you end normally, the trace file is closed automatically. If the application server is ended abnormally, the file may not be closed successfully. A message is displayed whenever the trace file is closed successfully.

If the trace file is a tape and is not closed successfully, you can still try to format it. Information near the end of the trace might not be processed, however, and the trace formatting utility will probably terminate abnormally. You can also try to write a tape mark on the trace tape before you attempt to format it. (The trace tape is not automatically rewound.)