관리 명령을 사용하여 실패한 메시지 조회 및 재생

비즈니스 프로세스 또는 휴먼 타스크에 대해 실패한 메시지가 있는지 여부를 판별하고, 있는 경우 해당 메시지 처리를 재시도하십시오.

시작하기 전에

이 절차를 시작하려면 다음 조건이 충족되어야 합니다.
  • 메시지를 조회하거나 재생할 Application Server가 실행 중이어야 합니다. 즉 서버 연결이 필요하기 때문에 wsadmin 스크립트의 -conntype none 옵션을 사용할 수 없습니다.
  • 보안이 활성화된 경우 운영자 권한을 갖고 있어야 합니다.

이 타스크의 수행 목적 및 시기

내부 메시지를 처리하는 중에 문제점이 발생하면 이 메시지는 유지 대기열 또는 보류 대기열에 놓여집니다. 실패한 메시지가 있는지 여부를 결정하고 해당 메시지를 내부 대기열로 다시 전송하려면 다음을 수행하십시오.

이 타스크의 단계

  1. 관리 스크립트가 있는 Business Process Choreographer 하위 디렉토리로 변경하십시오.
    Windows® 시스템의 경우, 다음을 입력하십시오.
    cd install_root\ProcessChoreographer\admin
    Linux® 및 UNIX® 시스템에서는 다음을 입력하십시오.
    cd install_root/ProcessChoreographer/admin
  2. 유지 대기열과 보류 대기열 모두에 있는 실패한 메시지 수를 조회하십시오.
    Windows 시스템에서는 다음 명령 중 하나를 입력하십시오. 다음은 각 명령의 차이를 강조해서 보여 줍니다.
    install_root\bin\wsadmin –lang jython -f queryNumberOfFailedMessages.py 
                                -cluster clusterName 
                                [ -bfm | -htm ]
                                [-profileName profileName]
    
    install_root\bin\wsadmin –lang jython -f queryNumberOfFailedMessages.py 
                                -node nodeName
                                -server serverName 
                                [ -bfm | -htm ]
                                [-profileName profileName]
    UNIX 및 Linux 시스템에서는 다음 명령 중 하나를 입력하십시오. 다음은 각 명령의 차이를 강조해서 보여 줍니다.
    install_root/bin/wsadmin.sh –lang jython -f queryNumberOfFailedMessages.py 
                                -cluster clusterName
                                [ -bfm | -htm ]
                                [-profileName profileName]
    
    install_root/bin/wsadmin.sh –lang jython -f queryNumberOfFailedMessages.py 
                                -node nodeName 
                                -server serverName 
                                [ -bfm | -htm ]
                                [-profileName profileName]

    여기서:

    cluster clusterName
    클러스터의 이름. 비즈니스 프로세스 컨테이너가 WebSphere® 클러스터에 대해 구성되는 경우에는 필수입니다.
    node nodeName
    서버 이름을 지정할 경우 선택적입니다. 이 이름은 노드를 식별합니다. 기본값은 로컬 노드입니다.
    server serverName
    서버의 이름. 클러스터 이름이 지정되지 않은 경우에 필요합니다.
    bfm|htm
    이 키워드는 선택사항입니다. 어떠한 옵션도 지정하지 않은 경우 기본값이 적용되어 비즈니스 프로세스와 휴먼 타스크에 대한 모든 실패 메시지가 표시됩니다. 비즈니스 프로세스 컨테이너 보류 및 유지 대기열에 있는 메시지의 수만을 표시하려면 -bfm 옵션을 지정하십시오. 휴먼 타스크 컨테이너 보류 대기열에 있는 메시지의 수만을 표시하려면 -htm 옵션을 지정하십시오.
    profileName profileName
    사용자 정의 프로파일의 이름입니다. 기본 프로파일에 대해 작업 중이 아닌 경우 이 옵션을 지정하십시오.

    로컬 노드의 서버를 확인하려면 다음을 입력하십시오.

    wsadmin –lang jython -f queryNumberOfFailedMessages.py -server serverName
  3. 보류 대기열, 유지 대기열 또는 두 대기열에 있는 실패한 메시지를 모두 재생하십시오.

    Windows 시스템에서는 다음 명령 중 하나를 입력하십시오. 다음은 각 명령의 차이를 강조해서 보여 줍니다.

    install_root\bin\wsadmin –lang jython -f replayFailedMessages.py 
                             -cluster clusterName 
                             -queue replayQueue
                             [ -bfm | -htm ]
                             [-profileName profileName]
    
    install_root\bin\wsadmin –lang jython -f replayFailedMessages.py 
                             -node nodeName
                             -server serverName 
                             -queue replayQueue
                             [ -bfm | -htm ]
                             [-profileName profileName]
    
    install_root\bin\wsadmin –lang jython -f replayFailedMessages.py 
                             -server serverName 
                             -queue replayQueue
                             [ -bfm | -htm ]
                             [-profileName profileName]

    UNIX 및 Linux 시스템에서는 다음 명령 중 하나를 입력하십시오. 다음은 각 명령의 차이를 강조해서 보여 줍니다.

    install_root/bin/wsadmin.sh –lang jython -f replayFailedMessages.py 
                             -cluster clusterName 
                             -queue replayQueue
                             [ -bfm | -htm ]
                             [-profileName profileName]
    
    install_root/bin/wsadmin.sh –lang jython -f replayFailedMessages.py 
                             -node nodeName
                             -server serverName 
                             -queue replayQueue
                             [ -bfm | -htm ]
                             [-profileName profileName]
    
    install_root/bin/wsadmin.sh –lang jython -f replayFailedMessages.py 
                             -server serverName 
                             -queue replayQueue
                             [ -bfm | -htm ]
                             [-profileName profileName]

    여기서:

    queue replayQueue
    다시 실행할 대기열을 선택적으로 지정합니다. replayQueue는 다음 값 중 하나를 가집니다.
    • holdQueue(기본값임)
    • retentionQueue(-bfm 옵션을 지정한 경우에만 유효)
    • both(-bfm 옵션을 지정한 경우에만 유효)
    cluster clusterName
    클러스터의 이름. 비즈니스 프로세스 컨테이너가 WebSphere 클러스터에 대해 구성되는 경우에는 필수입니다.
    node nodeName
    서버 이름을 지정할 경우 선택적입니다. 이 이름은 노드를 식별합니다. 기본값은 로컬 노드입니다.
    server serverName
    서버의 이름. 클러스터 이름이 지정되지 않은 경우에 필요합니다.
    bfm|htm
    이 키워드는 선택사항이며 상호 배타적입니다. 어떠한 옵션도 지정하지 않은 경우 기본값이 적용되어 비즈니스 프로세스와 휴먼 타스크에 대한 모든 실패 메시지가 다시 실행됩니다. 비즈니스 프로세스에 대한 메시지만을 다시 실행하려면 -bfm 옵션을 지정하십시오. 휴먼 타스크에 대한 메시지만을 다시 실행하려면 -htm 옵션을 지정하십시오.
    profileName profileName
    사용자 정의 프로파일의 이름입니다. 기본 프로파일에 대해 작업 중이 아닌 경우 이 옵션을 지정하십시오.

예제

주: 사용하지 않는 스태프 정리 조회 스크립트의 jacl 버전인 replayFailedMessages.jacl은 권장되지 않습니다. ProcessChoreographer 디렉토리의 util 하위 디렉토리에서 사용 가능하며 여기서 설명한 것과 동일한 매개변수를 취하지만, –lang jython 옵션을 생략해야 합니다.

ⓒ Copyright IBM Corporation 2005, 2006.
이 Information Center는 Eclipse 기술을 기반으로 합니다. (http://www.eclipse.org)