MQ 메시지 넣기 활동

런타임 중에 MQ 메시지 넣기 활동은 지정된 큐에 메시지를 보냅니다.

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

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

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

큐 및 메시지 세부사항

아래 표에 있는 필드를 사용하여 큐 및 메시지 세부사항을 지정하십시오. 필수 필드는 별표로 표시되어 있습니다.
필드 설명
큐 이름 * 메시지를 넣을 큐의 이름을 지정합니다.
페이로드 데이터 유형 메시지 페이로드의 데이터 유형을 2진 또는 문자열로 지정합니다.
메시지 유형 데이터그램 - 메시지를 전송하고 회신이 필요없을 경우 이 옵션을 선택하십시오.

요청 - 메시지에 회신이 필요한 경우 이 옵션을 선택하십시오. 요청 메시지의 큐에 회신 특성을 설정해야 합니다.

응답 - 메시지가 이전 요청의 회신일 경우 이 옵션을 선택하십시오.

큐에 회신 요청 메시지에 대한 회신을 전송해야 하는 큐를 지정합니다.
큐 관리자에 회신 큐(큐에 회신 필드에 지정됨)가 속해 있는 큐 관리자의 이름을 지정합니다.
지속적
  • True - 큐 관리자가 중단되는 경우 메시지가 큐에 복원됩니다.
  • False - 큐 관리자가 중단되는 경우 메시지가 큐에서 유실됩니다.
  • 기본값 - 메시지가 큐에 지속성 설정(기본값)을 사용합니다.
우선순위 메시지의 우선순위를 지정합니다. 메시지 우선순위의 기본값은 큐의 기본 우선순위로 설정됩니다. 큐에서 우선순위를 사용하여 메시지의 순서를 지정하고 이 메시지에 특정 우선순위를 설정해야 할 경우 지정을 선택하고 우선순위를 입력하십시오. 우선순위 범위는 1(가장 낮음)부터 9(가장 높음)까지입니다.
주: 우선순위는 MQ 큐에 설정된 최대 우선순위 숫자를 초과하지 않아야 합니다. 이 정보에 대해서는 MQ 시스템 관리자에게 문의하십시오.
메시지 만기 메시지가 만기되기 전에 큐에서 유지되는 시간(초)입니다. 기본값은 수행 안함으로서, 메시지가 전달되고 소요되는 시간과 관계없이 검색될 때까지 큐에서 대기합니다.

일정 시간 경과 후에 이 큐의 메시지가 만기되어 사용되지 않도록 해야 할 경우, 지정을 선택하고 메시지가 큐에 유지되는 최대 시간(초)을 입력하십시오.

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

전달 규칙

필드 설명
메시지 전달 여기에서 사용 가능한 옵션은 다음과 같습니다.
  • 한 번 이상 - 메시지가 한 번 이상 전달되도록 지정합니다. 연결 또는 통합 어플라이언스에 실패하면 메시지가 검색되어 두 번 이상 처리될 수 있습니다. 이 전달 옵션은 일반적으로 검색 시스템이 중복 메시지를 발견하거나 허용하는 경우에 사용됩니다.
  • 최대 한 번 - 메시지가 한 번만 전달되거나 전달되지 않도록 지정합니다. 연결 또는 통합 어플라이언스에 실패하면 메시지가 누락될 수 있습니다. 이 전달 옵션은 일반적으로 검색 시스템이 중복 메시지를 허용하지 않지만 메시지 유실은 허용하는 경우에 사용됩니다.

재시도 옵션

MQ 서버에 연결하는 데 사용할 재시도 옵션을 구성하십시오. 다음 표에서는 MQ 서버에 연결하는 데 사용할 재시도 옵션에 대해 설명합니다.

재시도 옵션 설명
1) 각 재시도 사이에 __초 동안 대기합니다. 통합 어플라이언스가 큐 관리자에 연결하여 MQ 서버에 메시지를 다시 보내기 전에 대기하는 시간(초)입니다.
2) 실패 전에 __번 연결을 시도합니다. 오류가 발생하여 현재 오케스트레이션 작업 처리가 중지되기 전에 통합 어플라이언스가 큐 관리자에 연결하여 MQ 서버에 메시지를 보내려고 시도하는 최대 재시도 횟수를 지정합니다.

MQ 메시지 넣기 활동이 포함된 오케스트레이션을 배치한 상태에서 통합 어플라이언스가 지정된 MQ 서버의 큐 관리자에 연결할 수 없는 경우, 통합 어플라이언스는 재시도 횟수 값에 도달할 때까지 시스템 및 오케스트레이션 로그에 오류를 경고로 로그합니다. 재시도 횟수에 도달하면 통합 어플라이언스가 시스템 및 오케스트레이션 로그에 오류를 로그하고 현재 오케스트레이션 작업 처리를 중지합니다.

예를 들어, 재시도 횟수를 3으로 설정한 경우 첫 번째, 두 번째 및 세 번째 연결 오류가 시스템 로그에 경고로 나타납니다. 통합 어플라이언스가 네 번째 오류를 오류로 로그하고 현재 오케스트레이션 작업 처리를 중지합니다.

입력 맵핑

이 활동의 입력 매개변수를 맵핑해야 합니다. 다음 매개변수는 필수입니다. 구성을 완료하려면 매개변수를 순서대로 맵핑해야 합니다. 기타 모든 매개변수는 선택사항입니다. 자세한 정보는 맵 작성을 참조하십시오.
필수 입력 매개변수:
payload

입력 맵핑 분할창의 활동으로 패널에서 선택적 입력 매개변수를 보려면, 도구 모음 메뉴에서 맵 > 선택적 매개변수 표시를 선택하거나 활동으로 패널을 마우스 오른쪽 단추로 클릭하고 선택적 매개변수 표시 옵션을 선택하십시오. 도구 모음 메뉴에서 맵 > 선택적 매개변수 표시 옵션을 선택할 수 없는 경우 입력 맵핑 패널에서 노드를 클릭하여 이 옵션을 활성화하십시오.