clearBPMEndpointServiceCache command

Use the clearBPMEndpointServiceCache command to reset the endpoint service caches of all running servers, including the endpoint service configuration cache and the endpoint service URL cache. The command can help with problem determination because you can enable endpoint service tracing for a running server and still see where the configuration is read and how the URLs are constructed.

The IBM BPM endpoint service reads and caches its configuration settings during the server start up process. If you enable endpoint service tracing com.ibm.bpm.endpoint.*=all during server runtime for problem determination, then the resulting traces do not contain the initial computation of the URLs. To ensure the URL computation for the endpoint service is part of the endpoint service trace, run the clearBPMEndpointServiceCache command to reset the endpoint service caches after enabling the com.ibm.bpm.endpoint.*=all trace.

After the URL cache has been cleared, the trace contains the computation of the URLs. If you change the endpoint service configuration, you need to synchronize the configuration changes to the managed nodes and restart the IBM Business Process Manager cluster members.

The endpoint service is configured with the following four specific BPMURL objects for backwards compatibility:

EXPOSED_ITEMS
TASK_REST_API
TASK_TEMPLATE_REST_API
LSW_SERVLET

Their assigned strategies mimic the exceptional behavior of prior releases.

To ensure consistent usage of the generic scenario configuration of RELATIVE, INTERNAL_CLIENT, and EXTERNAL_CLIENT (for example, when you configure a web server), remove the previous BPMURL objects.

The clearBPMEndpointServiceCache command is run using the AdminTask object of the wsadmin scripting client.

Prerequisites

The following conditions must be met:

The command must be run on the deployment manager node.
The wsadmin admin scripting client must be invoked in connected mode and the user must have WebSphere Application Server operator privileges.

Location

Start the wsadmin scripting client from the deployment_manager_profile/bin directory. The clearBPMEndpointServiceCache command does not write to a log file, but the wsadmin scripting client always writes a profile_root/logs/wsadmin.traceout log file where you will find exception stack traces and other information.

Syntax

clearBPMEndpointServiceCache

Parameters

The clearBPMEndpointServiceCache command does not have any parameters and it does not return a result.

Examples

Note: The examples are for illustrative purposes only. They include variable values and are not meant to be reused as snippets of code.

The following Jython example uses the clearBPMEndpointServiceCache command to clear the endpoint service caches of all running servers, including the endpoint service configuration cache and the endpoint URL cache:

wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.clearBPMEndpointServiceCache()