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

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

이 절차를 시작하려면 다음 조건이 충족되어야 합니다.
  • 사용할 사용자 ID에 관리 권한이 있어야 합니다.
  • 메시지를 조회하거나 재생할 Application Server가 실행 중이어야 합니다. 즉 서버 연결이 필요하기 때문에 wsadmin 스크립트의 -conntype none 옵션을 사용할 수 없습니다.
  • 보안이 활성화된 경우 운영자 권한을 갖고 있어야 합니다.
내부 메시지를 처리하는 중에 문제점이 발생하면 이 메시지는 유지 대기열 또는 보류 대기열에 놓여집니다. 실패한 메시지가 있는지 여부를 결정하고 해당 메시지를 내부 대기열로 다시 전송하려면 다음을 수행하십시오.
  1. 스크립트가 있는 Business Process Choreographer 유틸리티 디렉토리로 변경하십시오.
    Windows® 시스템에서는 다음을 입력하십시오.
    cd install_root\ProcessChoreographer\util
    UNIX® 및 Linux® 시스템에서는 다음을 입력하십시오.
    cd install_root/ProcessChoreographer/util
  2. 유지 대기열과 보류 대기열 모두에 있는 실패한 메시지 수를 조회하십시오.
    Windows 시스템에서는 다음 명령 중 하나를 입력하십시오. 다음은 각 명령의 차이를 강조해서 보여 줍니다.
    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]
    UNIX 및 Linux 시스템에서는 다음 명령 중 하나를 입력하십시오. 다음은 각 명령의 차이를 강조해서 보여 줍니다.
    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]

    여기서:

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

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

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

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

    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]

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

    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]

    여기서:

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

이용약관 |

최종 갱신: Fri Jun 2 2006

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