Use the administrative commands to determine whether there are
any failed messages for business processes or human tasks, and, if there are,
to retry processing them.
Before you begin
Before you begin this procedure, the following conditions must
be met:
- The user ID that you are using must have administrative rights.
- The application server on which the messages are to be queried or replayed
must be running. That is, the -conntype none option of the
wsadmin script cannot be used, because a server connection is required.
- When security is enabled, you must have operator authority.
Why and when to perform this task
When a problem occurs while processing an internal message, this
message ends up on the retention queue or hold queue. To determine whether
any failed messages exist, and to send those messages to the internal queue
again:
Steps for this task
- Change to the Business Process Choreographer utilities directory
where the scripts are located:
On Windows
® systems,
enter:
cd install_root\ProcessChoreographer\util
On UNIX
® and Linux
® systems,
enter:
cd install_root/ProcessChoreographer/util
- Query the number of failed messages on both the retention and hold
queues.
On Windows systems,
enter one of the following commands. The differences between the commands
are emphasized:
install_root\bin\wsadmin -f queryNumberOfFailedMessages.jacl
-cluster clusterName
[ -bfm | -htm ]
[-profileName profileName]
install_root\bin\wsadmin -f queryNumberOfFailedMessages.jacl
-node nodeName
-server serverName
[ -bfm | -htm ]
[-profileName profileName]
On UNIX and Linux system,
enter one of the following commands. The differences between the commands
are emphasized:
install_root/bin/wsadmin.sh -f queryNumberOfFailedMessages.jacl
-cluster clusterName
[ -bfm | -htm ]
[-profileName profileName]
install_root/bin/wsadmin.sh -f queryNumberOfFailedMessages.jacl
-node nodeName
-server serverName
[ -bfm | -htm ]
[-profileName profileName]
Where:
- cluster clusterName
- The name of the cluster. Required if the business process container is
configured for a WebSphere® cluster.
- node nodeName
- Optional when specifying the server name. This name identifies the node.
The default is the local node.
- server serverName
- The name of the server. Required if the cluster name is not specified.
- bfm|htm
- These keywords are optional. The default, if neither option is specified
is to display all failed messages for both business processes and human tasks.
If you only want to display the number of messages in the business process
container hold and retention queues, specify bfm. If you
only want to display the number of messages in the human task container hold
queue, specify htm.
- profileName profileName
- The name of a user-defined profile. Specify this option if you are not
working with the default profile.
If you want to check for a server on the local node,
enter:
wsadmin -f queryNumberOfFailedMessages.jacl -server serverName
- Replay all failed messages on the hold queue, retention queue,
or both queues.
On Windows systems,
enter one of the following commands. The differences between the commands
are emphasized:
install_root\bin\wsadmin -f replayFailedMessages.jacl
-cluster clusterName
-queue replayQueue
[ -bfm | -htm ]
[-profileName profileName]
install_root\bin\wsadmin -f replayFailedMessages.jacl
-node nodeName
-server serverName
-queue replayQueue
[ -bfm | -htm ]
[-profileName profileName]
install_root\bin\wsadmin -f replayFailedMessages.jacl
-server serverName
-queue replayQueue
[ -bfm | -htm ]
[-profileName profileName]
On UNIX and Linux systems,
enter one of the following commands. The differences between the commands
are emphasized:
install_root/bin/wsadmin.sh -f replayFailedMessages.jacl
-cluster clusterName
-queue replayQueue
[ -bfm | -htm ]
[-profileName profileName]
install_root/bin/wsadmin.sh -f replayFailedMessages.jacl
-node nodeName
-server serverName
-queue replayQueue
[ -bfm | -htm ]
[-profileName profileName]
install_root/bin/wsadmin.sh -f replayFailedMessages.jacl
-server serverName
-queue replayQueue
[ -bfm | -htm ]
[-profileName profileName]
Where:
- 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 (only valid when the -bfm option is
specified)
- cluster clusterName
- The name of the cluster. Required if the business process container is
configured for a WebSphere cluster.
- node nodeName
- Optional when specifying the server name. This name identifies the node.
The default is the local node.
- server serverName
- The name of the server. Required if the cluster name is not specified.
- bfm|htm
- These keywords are optional and mutually exclusive. The default, if neither
option is specified is to replay failed messages for both business processes
and human tasks. If you only want to replay the messages for business processes,
specify bfm. If you only want to replay messages for human
tasks, specify htm.
- profileName profileName
- The name of a user-defined profile. Specify this option if you are not
working with the default profile.