Enabling transaction logging in IBM® Rational DOORS

You can enable client logging to record transaction details to diagnose unexpected behavior on your computer.

About this task

You can enable logging for a computer to record tranasaction activity during your Rational® DOORS®

client session. When you close your session the logging is disabled.

To turn on logging you run DXL using the DXL editor before you start the operation you need to debug.

You must have write permission to the location youspecified in the output log file location. * Client logging requires that you can start RATDOORS client and log in successfully. * If you have setup DXL security Only users with Edit DXL power may edit and run DXL Procedure: 1.Log into DOORS as a user with permission to run DXL 2.Click Tools > Edit DXL 3.Type the following to the DXL input field string logfileLocation = "c:\\temp\\doorsclientlog.txt" int logLevel = 6 startLogging_(logfileLocation, logLevel) 4. Click run 5. Perform tha action that results in the issue you are trouble-shooting. 6. After the operation that requires logging is completed exit DOORS. Note: DOORS client logging is automatically disabled when you exit DOORS. You can also disable logging by running the following DXL command: stopLogging_() 7. Zip the log files and send it to Rational Support. Related links t_setupdxlsecurity

Procedure

  1. Login to Rational DOORSFor the computer that you are enabling logging for, edit the .xml configuration file. Replace the ${LOG_FOLDER_LOCATION} value of the file appender with an accessible path. For example: <param name="file" value="c:\IBM\DOORS\log\SystemTrace.log" \>
  2. Start the component by using the -logxconfig command-line switch.
    Note: When you start the component on a Windows computer, instead of using command-line parameters to enable application message logging, you can enable it by creating a registry key that is named logxconfig that uses the value of the component .xml configuration file.
    1. To enable application message logging for the server, start the Rational DOORS database server by using the -logxconfig logging_file_name command-line switch. Be sure to include -debug. For example, C:\Program Files\IBM\Rational\DOORS\9.6\doorsd -debug -logxconfig logging-config.xml.
    2. To enable application message logging for the client, start the Rational DOORS client by using the -logxconfig logging_file_name command-line switch. For example, C:\Program Files\IBM\Rational\DOORS\9.6\doors -logxconfig logging-config-client.xml.

Feedback