jheapprofanalyzer (CSV output of Hitachi class-wise statistical information analysis file )

Format

jheapprofanalyzer [-J option-name] [file-name]

Function

The Hitachi class-wise statistical information analysis file is output in CSV format.

For the input file used in the Hitachi class-wise statistical information analysis file, see 9.10 Class-wise statistical information analysis functionality in the uCosminexus Application Server Maintenance and Migration Guide.

Arguments

-J option-name
You can specify the following options in option name. Also, when you specify options excluding the following options, the operation is not guaranteed:
  • -Xms
    Specify the initial size of the memory allocation pool in number of bytes.
  • -Xmx
    Specify the maximum size of memory allocation pool in number of bytes.
  • -DJP.co.Hitachi.soft.jvm.tools.jheapprofanalyzer.threshold=num
    num: Specifies the threshold value of the instance total size. The range is from 0 to 263-1 (Long.MAX_VALUE). Only the classes where the instance total size is more than num are output. The default value is 1024.
File name
You can specify the extended thread dump file containing the Hitachi class-wise statistical information. There are no special rules for specifying file names. Moreover, you can specify the files in any order without any limitations on the file count.

Return values

0:
The command is terminated normally.
Above 1:
The command is terminated abnormally.

Input example

jheapprofanalyzer -J-Xms1024m -J-Xmx1024m -J-DJP.co.Hitachi.soft.jvm.tools.jheapprofanayzer.threshold=5000
javacore22356.080523161703​.txt  javacore22356.080523161711​.txt

Output format

For the output format of the Hitachi class-wise statistical information analysis file, see 9.10 Class-wise statistical information analysis functionality in the uCosminexus Application Server Maintenance and Migration Guide.

Output message

When the following error message is output, the Hitachi class-wise statistical information analysis file is not output. Also, if any error message other than the message mentioned above is output, the default exception processing is executed.

Table 10-12 Error messages output by the jheapprofanalyzer command

No.Error messageExplanationOperation after output
1usage: jheapprofanalyzer [options] file...
where options include:
-J-Xms<size> set initial Java heap size
-J-Xmx<size> set maximum Java heap size
-J-DJP.co.Hitachi.soft.jvm.tools.jheapprofanalyzer.threshold=<num> set instance total size threshold
An argument specified for the JheapprofAnalyzer class is invalid.(a)
2JheapprofAnalyzer: Illegal property value<num>. Default is assumed.A value other than an integer is specified in num of JP.co.Hitachi.soft.jvm.tools.jheapprofanalyzer.threshold or the num is out of range.(b)
3JheapprofAnalyzer: can't open input file file-namefile-name does not exist in the directory or the file does not open due to some other factors.(c)
4JheapprofAnalyzer: can't read input file file-nameFailed in loading file-name(c)
5JheapprofAnalyzer: Illegal input file format file-namefile-name is not an extended thread dump file containing the Hitachi class-wise statistical information.(c)
6JheapprofAnalyzer: can't open output file file-nameUnable to open the output file.
The following status can be considered as the reasons for error:
  • The output file is changed to a directory.
  • There is no output file.
  • Unable to open the output file due to some other reasons.
(a)
7JheapprofAnalyzer: can't write output file file-nameFailed in writing file name.(a)
Legend:
(a): The process ends abnormally.
(b): Continues executing the process assuming the default value.
(c): Continues the process and checks the error of all the specified input files.

Notes

In the Hitachi class-wise statistical information analysis functionality, the file is opened only when the date is acquired and when data is loaded. Therefore, the result is not guaranteed for updating and deleting the input data, when the command is being executed.