dump (SAP CC 4.1 Admin+)

dump

Definition

To display a thread dump related to one or multiple instances of the SAP CC system

Command Usage

Syntax

dump [<INST_TARGETS> ...]

Command Arguments

Name	Description
`<INST_TARGETS>`	Optional: The target instances of the command; You can specify a list of instance IDs or instance types.

Detailed Information

The dump command retrieves and displays a full dump of the threads relating to one or multiple instances of the SAP CC Core Server system. Each SAP CC system instance runs in a Java runtime. The dump contains the list of processing Java threads. For each Java thread, the information includes the executing Java methods and the stack trace of the thread.

The stack traces inform about the treatments running in an instance of the SAP CC system.

Use the <INST_TARGETS> argument to specify the instances you want to retrieve the thread dump from. If you do not specify any argument, the dump will contain information of all threads in your SAP CC Core Server system, for all running instances.

Note

As of SP 1 and if the thread dump file generation function is enabled (see the THREAD_DUMP_ENABLED system parameter), the dump command also triggers the generation of a thread dump file for each specified instance (or for all running instances when no argument is specified).

This function enriches your SAP Support Team with an advanced supportability tool.

Each thread dump file is generated in a dedicated path of each concerned instance in the SAP CC system (see the THREAD_DUMP_OUTPUT_PATH system parameter).

The file naming convention uses the following pattern: <INSTANCE_ID>_<DATE>_ondemand.zip, where:

INSTANCE_ID = <INSTANCE_TYPE>#<NUMBER> (e.g. updater#1, dispatcher#1, rater#2, and so on)
DATE corresponds to the operating system date and uses the following pattern: yyyy-MM-dd'T'HH'h'mm'm'ss's'

Tip

In your running SAP CC system, view the current settings of the thread dump file generation function to know the file retention period and the file location.

Use

A support specialist from your SAP Support Team or an expert from your operation team may ask you to retrieve a thread dump or a thread dump file to facilitate the troubleshooting of problems relating to your SAP CC system.

It identifies blocked treatments due to:

I/O issues (network, back-end database, file system)
Overloaded resources (deadlock, lock/semaphore/mutex)

Troubleshooting Operations (System)

SAP Support Team defines and adapts the procedure to perform. Consult the SAP CC Operations Guide.

Authorization

You must have a specific role in your SAP CC user profile. Refer to the SAP CC Security Guide for more information about the necessary authorizations.

Additional Information

Consult the SAP CC Operations Guide for more information about the supportability tools and the thread dump files.

Consult the SAP CC System Parameter Reference for more information about the configuration settings dedicated to the thread dump file management:

Messages

Code	Message	Action
err.bad_targets	Error: Bad target: {target}.