IBM BPM, V8.0.1, All platforms > Reference > Commands and scripts > Business Process Choreographer administrative scripts

replayFailedMessages.py administrative script

Use the replayFailedMessages.py administrative script to retry processing failed messages.

Prerequisites

The following conditions must be met:

• Run the script in the connected mode, that is, the application server must be running.

• If Business Process Choreographer is configured on a cluster, then at least one cluster member must be running.

• If WebSphere administrative security is enabled, and your user ID does not have operator authority, include the wsadmin -user and -password options to specify a user ID that has operator authority.

Location

The replayFailedMessages.py administrative script is in the Business Process Choreographer admin directory.

Syntax

 -f replayFailedMessages.py
       (([-node nodeName] -server server_name) | (-cluster cluster_name))
       -queue  replayQueue
       [ -bfm | -htm ]
 

Parameters

-node nodeName

The name of the node where Business Process Choreographer is configured. This is optional when specifying the server name. The default is the local node.

-server serverName

The name of the server where Business Process Choreographer is configured. This is required if a cluster is not specified.

-cluster clusterName

The name of the cluster where Business Process Choreographer is configured. This is required if Business Process Choreographer is configured on a cluster.

-bfm | -htm

These keywords are optional and mutually exclusive. The default, if neither option is specified is to replay failed messages for both BPEL processes and human tasks. If you only want to replay the messages for BPEL processes, specify the -bfm option. If you only want to replay messages for human tasks, specify the -htm option.

-queue replayQueue

Optionally specifies the queue to replay. replayQueue can have one of the following values:

• holdQueue (this is the default value)
• retentionQueue (only valid when the -bfm option is specified)
• both (not valid when the -htm option is specified)

Examples

Business Process Choreographer administrative scripts

Related tasks:
Querying and replaying failed messages, using administrative scripts
Refreshing people query results, using the administrative console