Testing WebSphere MQ Applications › Application Testing › Multi-user Diagram Trace Utility Support › Override the default trace environment variables

Override the default trace environment variables

A client transaction can transfer the host and port of the client that is executing the transaction. By providing this information, the server can establish communication with the Diagram Trace Utility running on that client workstation.

Follow these steps:

1. Build the server application that has been generated with trace (as before).
2. Leave the trace environment variables within the application.ini file that is located in the server application's model directory commented out.
3. Start your servers.
4. Invoke the Diagram Trace Utility on your client workstation.
5. Edit the application.ini file residing in your client application's executables directory.
6. Uncomment and set the trace environment variables. You can use 'localhost' for the TRACE_HOST variable.
7. Execute your client application.

   The Diagram Trace Utility on the client workstation will be used to trace the server for each transaction initiated from that client.

Note: To provide the server with the client's host and port information, these values are added to the Common Format Buffer (CFB). A CFB is used to exchange view data between the client and server. If the addition of the host and port values exceeds the allowable size of the CFB, the host and port values are not added to the CFB and the statement "Not enough space in CFB to pass Trace flags to server" is logged to the client's trace file. The end result is that no override takes place, and the values of the host and the port will be extracted from the server's application.ini file.