Converting log files to use IBM unique Message IDs

The convertlog command creates a new log file with either new or old message IDs substituted in place of the message IDs in the source file.

Before you begin

Deprecated feature: Prior to Version 6.x, components were assigned message IDs that are not necessarily unique across IBM® software products. In Version 6.0, a system property was provided to map the message IDs in output logs to a set of IBM unique message IDs (all WebSphere® Application Server message IDs now start with CW) that do not conflict with other IBM software products. The default runtime behavior still uses the old message IDs.

About this task

To facilitate the migration of logging tools that are reliant on the old message IDs, the convertlog command is provided to convert the message IDs of log entries from the old standard to the new standard, or the new standard back to the old. By default, the software is configured to use the old message IDs when logging, but you can change the default output with the com.ibm.websphere.logging.messageId.version system property. Read Changing the message IDs used in log files for more information.

Procedure

Use the convertlog command to convert the log output:

convertlog <source file name> <destination file name> [options]
        options: -newMessageFormat convert message IDs to CCCCCnnnnS format
                  (cannot be used with -m5)
                 -oldMessageFormat convert message IDs to CCCCnnnnS format
                  (cannot be used with -m6)

Results

After using the convertlog command you have a new file with message IDs in the chosen format.