eheapprof (Output of extended thread dump containing the Explicit heap detailed information)

Format

eheapprof [-i|-f] [-force] [-freeratio] - -p process-ID

Function

This command outputs the extended thread dump containing the Explicit heap detailed information for java processes of the process ID specified in arguments. You can also output the statistical information of an object within the Explicit memory block, and the release ratio information of the Explicit memory block to an extended thread dump.

Arguments

-i
Displays a message confirming the execution of the output processing for an extended thread dump containing the Explicit heap detailed information. You input either y or n. If you input y, the extended thread dump containing the Explicit heap detailed information will output. If you input n, no information will be displayed and the processing will terminate. Even if you omit this option, the option is valid as long as the -f option is not specified.
-f
Disables the -i option. If you omit this option, the -i option will become valid.
-force
Requests the output of an extended thread dump for the java process indicated by the process ID that is specified with the -p option, without confirming the existence of the /tmp/hsperfdata_user-name/process-ID file created in the java process.
Note that this option is for UNIX.
-freeratio
Enables the output of the object release ratio information of the Explicit memory block and outputs an extended thread dump.
When you execute the eheapprof command by specifying this option, JavaVM executes the following process and acquires the object release ratio information.
  • The full garbage collection
  • An Explicit memory block release process
The execution of these processes lead to a risk of stopping the execution of an application for a few seconds and hence we recommend that you output the object release ratio information of the Explicit memory block during system development or when operations are stopped.
-p process-ID
Specifies the process ID of the java program that outputs the extended thread dump containing the Explicit heap detailed information.

Return values

0:
Terminated normally.
1:
Terminated abnormally.
2:
There is no response indicating that the output processing has terminated within the fixed time for the extended thread dump containing the Explicit heap detailed information.

Output messages

If the following error messages or warning messages are issued, the extended thread dump containing the Explicit heap detailed information is not output:

Table 10-4 Messages issued by the eheapprof command (For Windows)

No.Error messageExplanation
1usage: eheapprof [-f|-i] [-freeratio] -p process-idThe argument specified in the eheapprof command is wrong.
2eheapprof: illegal option -- optionoption specified in the eheapprof command is invalid.
3process-ID: Now processing previous request, this request canceledThe process indicated by process-ID specified in the argument of the eheapprof command outputs the current Explicit heap detailed information.
4process-ID: Not owner0 is specified in process-ID specified in the argument of the eheapprof command.
5eheapprof: can't create work file at temporary directory , this request canceledIf the user does not have permission to reference or write data into the directory for temporary files, the extended thread dump containing the Explicit heap detailed information cannot be output. The output request for the extended thread dump containing the Explicit heap detailed information is cancelled.
6eheapprof: can't get temporary directory, this request canceledIf the directory for temporary files cannot be acquired, the extended thread dump containing the Explicit heap detailed information cannot be output. The output request for the extended thread dump containing the Explicit heap detailed information is cancelled.
7eheapprof: please delete name-of-undeleted-file in full-path-of- undeleted-fileThe internal files could not be deleted when the eheapprof command is terminated. Delete the un-deleted files that exist in the full path of the un-deleted files.
8eheapprof: unexpected error occurred: error-causeAn unexpected error occurred when executing the eheapprof command.
error-cause might display the followings:
  • When an attempt to secure the memory for an operation fails
    malloc systemcall fail (errno=Y)
  • When an attempt to close the object fails
    close systemcall fail (errno=Y)
9eheapprof: can't communicate with process process-IDThere is a problem with the process indicated by process-ID specified in the argument of the eheapprof command and an error occurred during the communication, and therefore, the communication cannot be performed. Alternatively, the process indicated by process-ID specified in the argument of the eheapprof command does not exist.
10process-ID: Timeout occurred. Java process not respondingThe process indicated by process-id specified in the argument of the eheapprof command did not return a response indicating that the output processing terminated within the fixed time for the Explicit heap detailed information.

Table 10-5 Messages issued by the eheapprof command (In UNIX)

No.Error messageDescription
1usage: eheapprof [-f|-i] [-force] [-freeratio] -p process-idThe argument specified in the eheapprof command is wrong.
2eheapprof: illegal option -- optionoption specified in the eheapprof command is invalid.
3process-ID: Now processing previous request, this request canceledThe process indicated by process-ID specified in the argument of the eheapprof command outputs the current Explicit heap detailed information.
4process-ID: No such processThe process indicated by process-ID specified in the argument of the eheapprof command is not found or the process indicated by process-ID specified in the eheapprof command is not a java process.
5process-ID: Not ownerThe user is not the owner of the process of process-ID specified in the argument of the eheapprof command.
6eheapprof: can't create work file at /tmp , this request canceledIf the user does not have permission to reference or write data into the directory for temporary files, the extended thread dump containing the Explicit heap detailed information cannot be output. The output request for the extended thread dump containing the Explicit heap detailed information is cancelled.
7eheapprof: please delete name-of-undeleted-file in full-path-of- undeleted-fileThe internal files could not be deleted when the eheapprof command ends. Delete the un-deleted files that exist in the full path of the un-deleted files.
8eheapprof: unexpected error occurred: error-causeAn unexpected error occurred when executing the eheapprof command.
error-cause might display the following:
  • When an attempt to secure the memory for the operation fails
    malloc systemcall fail (errno=Y)
  • When an attempt to close the object fails
    close systemcall fail (errno=Y)
9process-ID: Timeout occurred. Java process not respondingThe process indicated by process-id specified in the argument of the eheapprof command did not return a response indicating that the output processing has terminated within the fixed time for the Explicit heap detailed information.

Notes