Acquire the performance analysis trace file beforehand for using message tracking. For details about how to acquire the performance analysis trace file, see 7. Analyzing the Performance of a System Using Performance Analysis Trace in the manual Cosminexus Application Server Function Guide - Maintenance, Migration, and Compatibility.

Start the message tracking by cscmsgtk command.

Read the performance analysis trace file and start message tracking by cscmsgtk command. After starting the message tracking, an interactive protocol (Here onwards, called as Message tracking protocol) is displayed exclusively for message tracking. Commands are executed by message tracking protocol and errors are analyzed.

For details about the cscmsgtk command and commands executed by message tracking protocol, see cscmsgtk (Starting the message tracking functionality) in the manual Cosminexus Service Platform Reference.

Few minutes might be required for starting message tracking due to machine performance and size of performance analysis trace files read while starting the message tracking.

There is normal start and range specified start in message tacking and the range for reading performance analysis trace file during startup differ accordingly. The description of normal start and range specified start is as follows:

(a) Normal start

All the performance analysis traces are read in normal start.

The execution format of cscmsgtk command when starting by normal startup is as follows:

 
cscmsgtk -prf performance-analysis-trace-file-name
 

Please note the file size as all the performance analysis traces are read at once in normal start. The standard for file size read once is approximately 140 megabytes. When the "KEOS52044-E A memory shortage occurred." occurs, start as a range specified start and adjust the read file size.

(b) Range specified start

In range specified start, specify the range and sort out the performance analysis traces to be read.

The execution format of the cscmsgtk command when starting by range specified start is as follows:

 
cscmsgtk -prf performance-analysis-trace-file-name -date start-reading-week, date-and-time, reading-completion-week, date-and-time
 

The read range is output as follows when started as range specified start:

 
start-reading-week, date-and-time - reading-completion-week, date-and-time
cscmsgtk
 

Start reading week, date and time and reading completion week, date and time is displayed in (yyyy: Year, MM: Month, dd: Date, hh:Hours, mm: Minutes, ss: Seconds, SSS: Milliseconds) format of yyyy/MM/dd hh:mm:ss.SSS.