Using scripts to query and replay failed messages

Why and when to perform this task

When a problem occurs processing an internal message, this message ends up on the retention queue or hold queue. To determine if any failed messages exist, and to send them to the internal queue again:

Steps for this task

  1. Verify that you are using a user ID that has administrative rights.
  2. Change to the process choreographer utilities directory where the scripts are located:
    On Windows systems, enter:
    cd install_root\ProcessChoreographer\util
    On UNIX systems and z/OS, enter:
    cd install_root/ProcessChoreographer/util
  3. Query the number of failed messages on both the retention and hold queues. Enter one of the following commands:
    install_root\bin\wsadmin -f queryNumberOfFailedMessages.jacl 
                                  -cluster clusterName
    
    install_root\bin\wsadmin -f queryNumberOfFailedMessages.jacl 
                                  -node nodeName 
                                  -server serverName

    Where:

    clusterName
    The name of the cluster. Required if the business process container is configured for a WebSphere cluster.
    nodeName
    Optional when specifying the server name. This name identifies the node. The default is the local node.
    serverName
    The name of the server. Required if the cluster name is not specified.

    If you want to check for a server on the local node, enter:

    wsadmin -f queryNumberOfFailedMessages.jacl -server serverName
  4. Replay all failed messages on the hold queue, retention queue, or both queues by entering one of the following commands:
    install_root\bin\wsadmin -f replayFailedMessages.jacl 
                            -cluster clusterName 
                            -queue replayQueue
    
    install_root\bin\wsadmin -f replayFailedMessages.jacl 
                            -node nodeName 
                            -server serverName 
                            -queue replayQueue
    
    install_root\bin\wsadmin -f replayFailedMessages.jacl 
                            -server serverName 
                            -queue replayQueue

    Where:

    replayQueue
    Must have one of the following values: holdQueue, retentionQueue, or both.
    clusterName
    The name of the cluster. Required if the business process container is configured for a WebSphere cluster.
    nodeName
    Optional when specifying the server name. This name identifies the node. The default is the local node.
    serverName
    The name of the server. Required if the cluster name is not specified.



Searchable topic ID:   t4adreplay
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/workflow/tasks/t4adreplay.html

Library | Support | Terms of Use | Feedback