7.10.2 Starting message tracking
This section describes the prerequisites and how to start the message tracking.
- Organization of this subsection
(1) Prerequisites
Acquire the performance analysis trace file beforehand for using message tracking. For details about how to acquire the performance analysis trace file, see 7. Performance Analysis by Using Trace Based Performance Analysis in the manual uCosminexus Application Server Maintenance and Migration Guide.
(2) How to start
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 (Invoking the message tracking function) in the manual uCosminexus Service Platform Reference Guid.
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.