Debugging Guide

If you have problems with one of the MultiMac drivers, the developer may ask you to install the trace version and provide a trace dump.

Installing the Trace Version of the Driver

To install the trace version, copy the following files from the trace directory of the distribution package to the directories on your boot drive as indicated below:

• driver.OS2 -> \IBMCOM\MACS
• driver.NIF -> \IBMCOM\MACS
• driver.SYM -> \IBMCOM\MACS
• TRC00F8.TFF -> \OS2\SYSTEM\TRACE

where driver is the driver that you are testing, such as R8169, NVETH, or E1000E.

To enable tracing, add these two lines to your CONFIG.SYS:

  TRACEBUF=512 /M=WRAP,QUEUED,NODTI /D=ALL
  TRACE=ON 248

You must reboot to make the new driver active and enable tracing. This assumes that you have already setup this driver using mpts.exe. You do not need to setup the driver using mpts.exe more than once, even if you copy new versions of the driver into \IBMCOM\MACS. You just need to reboot to start using the new version.

Capturing the Trace

To capture the trace dump, open a command window and type:

TRACEFMT

From the file menu choose Save Formatted... and zip that file and send it to the developer.