MQ 큐 폴 활동

런타임 중에 MQ 큐 폴링 활동은 지정된 재시도 간격을 기반으로 메시지의 MQ 큐를 주기적으로 확인합니다.

주: 활동을 구성하기 전에 MQ 활동의 엔드포인트를 작성해야 합니다.
구성 태스크는 다음과 같은 세 개의 섹션이 있습니다.

구성 태스크를 완료한 후, 활동의 출력 맵핑을 수행합니다.

주: 최대 메시지 크기는 100MB입니다.

큐 및 메시지 세부사항

아래 표에 있는 필드의 큐 및 메시지 세부사항을 지정하십시오. 필수 필드는 별표로 표시되어 있습니다.
필드 설명
큐 이름 * 메시지에 폴링되는 큐의 이름을 지정합니다.
페이로드 데이터 유형 메시지 페이로드의 데이터 유형을 2진 또는 문자열로 지정합니다.
MQRFH2 헤더의 스키마 단편 MQRFH2 헤더가 메시지에 포함되는지 여부를 지정합니다. 메시지가 XML 메시지이고 MQRFH2 헤더를 포함할 경우 이 선택란을 선택하고 [...]를 클릭하십시오. 스키마 유형 요소 찾아보기 대화 상자에서 헤더를 정의하는 XML 스키마를 찾아보려면, XML 스키마에서 NameValueData 요소를 선택하고 확인을 클릭하십시오. 스키마 단편은 NameValueData 요소 및 모든 하위 요소입니다.
주: 헤더를 정의하는 XML 스키마를 먼저 작성하고 프로젝트에 로드해야 이 스키마를 선택할 수 있습니다. 자세한 정보는 MQRFH2 헤더에 대한 XML 스키마 정의 및 로드를 참조하십시오.

전달 규칙

필드 설명
변경사항 폴링 간격 통합 어플라이언스가 변경사항에 큐를 폴링하는 빈도를 지정합니다. 자세한 정보는 폴링 간격 동작을 참조하십시오.
메시지에 고유 ID가 있는 위치 큐의 메시지에 고유 ID 사용 여부를 지정합니다.
메시지 전달 여기에서 사용 가능한 옵션은 고유 ID 선택란이 선택되어 있는지 여부에 따라 다릅니다. 선택란이 선택되어 있으면 3개 옵션 모두를 사용할 수 있습니다. 선택되어 있지 않으면 한 번 이상만 표시됩니다.
  • 한 번 이상 - 메시지가 한 번 이상 전달되도록 지정합니다. 연결 또는 통합 어플라이언스에 실패하면 메시지가 검색되어 두 번 이상 처리될 수 있습니다. 이 전달 옵션은 일반적으로 검색 시스템이 중복 메시지를 발견하거나 허용하는 경우에 사용됩니다.
  • 최대 한 번 - 메시지가 한 번만 전달되거나 전달되지 않도록 지정합니다. 연결 또는 통합 어플라이언스에 실패하면 메시지가 누락될 수 있습니다. 이 전달 옵션은 일반적으로 검색 시스템이 중복 메시지를 허용하지 않지만 메시지 유실은 허용하는 경우에 사용됩니다.
  • 정확히 한 번 - 메시지가 한 번만 전달되도록 지정합니다. 연결 또는 통합 어플라이언스에 실패해도 이 옵션을 사용하는 전달 방식에는 영향을 주지 않습니다. 통합 어플라이언스가 MQ 메시지 ID를 사용하여 모든 메시지가 검색되어 정확히 한 번 처리되도록 합니다.
    주: 정확히 한 번 옵션을 선택하는 경우 지속성을 사용 가능하도록 설정해야 합니다. 자세한 정보는 지속성 사용을 참조하십시오.

재시도 옵션

다음 표에 정의된 대로 MQ 큐 폴링 활동의 재시도 옵션을 구성하십시오.

재시도 옵션 설명
1) 각 재시도 사이에 __초 동안 대기합니다. 통합 어플라이언스가 MQ 서버에서 메시지를 다시 검색하기 전에 대기하는 시간(초)입니다.
2) 실패 전에 __번 연결을 시도합니다. 실패하기 전에 통합 어플라이언스가 MQ 서버에서 메시지를 검색하려고 시도하는 최대 횟수를 지정합니다.

MQ 큐 폴링 활동으로 시작되는 오케스트레이션이 배치된 상태에서 통합 어플라이언스가 지정된 MQ 서버에 연결할 수 없거나 큐에서 메시지를 검색할 수 없는 경우, 통합 어플라이언스는 재시도 횟수 값에 도달할 때까지 시스템 로그에 오류를 경고로 로그합니다. 재시도 횟수에 도달하면 통합 어플라이언스가 시스템 로그에 오류를 로그하고, 현재 재시도 횟수가 0으로 재설정되며, MQ 서버와의 연결을 설정하려고 계속 시도합니다.

예를 들어 재시도 횟수를 3으로 설정한 경우 첫 번째, 두 번째 및 세 번째 오류가 시스템 로그에 경고로 나타납니다. 통합 어플라이언스가 네 번째 오류를 오류로 로그하고 현재 재시도 횟수를 0으로 재설정합니다. 따라서 다섯 번째 연결 오류는 시스템 로그에 경고로 표시됩니다. 통합 어플라이언스는 큐에서 메시지를 검색하려고 계속 시도합니다.

출력 맵핑

이 활동의 출력 매개변수를 맵핑할 필요가 없습니다. 하지만 이러한 매개변수를 맵핑할 경우 다음과 같은 사항에 유의하십시오.
매개변수:
  • payloadmqmdheader 매개변수는 큐에서 수신되는 메시지에서 가져옵니다.
  • rfh2header는 RFH2 헤더 스키마가 구성 태스크에 지정된 경우에 가져옵니다.