이 주제는 다음 절을 포함합니다.
WebSphere MQ Mobile Transport 프로토콜을 사용한 브로커에 연결한 클라이언트에서 메시지를 수신하려면 MQeInput 노드를 사용하십시오.
MQeInput 노드가 브로커의 WebSphere MQ Everyplace 큐 관리자에 지정된 브릿지 큐에서 메시지 플로우에 들어 있는 메시지를 수신합니다. 노드는 이 메시지에 대한 처리 환경도 설정합니다. 이 노드를 포함하는 메시지 플로우를 전개하기 전에 WebSphere MQ Everyplace 큐 관리자를 작성하여 구성해야 합니다.
WebSphere MQ Everyplace 연결을 통해 수신된 메시지를 핸들링하는 메시지 플로우는 항상 MQeInput 노드로 시작해야 합니다. 메시지 수신 방법을 제어하는 MQeInput 노드의 등록 정보를 설정할 수 있습니다. 예를 들면, 트랜잭션 제어하에 메시지를 처리하도록 표시할 수 있습니다.
WebSphere MQ Everyplace 노드를 포함하는 메시지 플로우를 브로커로 전개할 경우, 메시지 플로우의 수에 관계없이 단일 실행 그룹으로 메시지 플로우를 전개해야 합니다. 플로우 내의 WebSphere MQ Everyplace 노드는 모두 동일한 WebSphere MQ Everyplace 큐 관리자 이름을 지정해야 합니다. 이 제한사항을 충족하지 못하면 전개 시 오류가 발생합니다.
MQeInput 노드는 다음 메시지 도메인에 있는 메시지를 핸들링합니다.
MQeInput 노드로 시작하는 메시지 플로우에 출력 노드를 포함시킬 경우, 노드는 사용자 정의 출력 노드를 비롯하여; 지원되는 어떤 출력 노드도 가능합니다. MQeOutput 노드는 포함시키지 않아도 됩니다. 메시지 플로우를 구성하여 브로커에 필요한 변환을 제공해 달라고 요청할 수 있으므로, WebSphere MQ Everyplace 클라이언트에서 메시지를 수신한 다음 지원되는 모든 전송 방식을 사용하여 브로커에 연결하는 클라이언트용 메시지를 생성하는 메시지 플로우를 작성할 수 있습니다.
WebSphere MQ Everyplace 버전 1.2.6은 WebSphere Message Broker에서 사용합니다. 이는 WebSphere MQ Everyplace의 최신 버전과 호환됩니다. 버전 2.0과 같이 WebSphere MQ Everyplace 이상의 버전을 사용하는 클라이언트는 이들 노드에 연결시 올바르게 작동하지만, 버전 1.2.6에서 지원하지 않는 추가 기능(예: JMS 지원)은 작동하지 않습니다.
큐 관리자는 서로 다른 WebSphere MQ Everyplace 버전 간에 상호교환되지 않습니다. 노드는 버전 1.2.6으로 작성한 큐 관리자를 사용해야 합니다. 이와 유사하게, 클라이언트는 큐 관리자 작성 시 자체 코드 레벨을 사용해야 합니다.
z/OS 시스템으로 전개하는 메시지 플로우에서는 MQeInput 노드를 사용할 수 없습니다.
서브플로우로 사용하기 위한 메시지 플로우를 작성하는 경우, 표준 입력 노드를 사용할 수 없기 때문에 서브플로우에 대한 터미널에서 작성할 첫 번째 노드로서 입력 노드 인스턴스를 사용해야 합니다.
메시지 플로우가 WebSphere MQ 연결을 통해 메시지를 수신하지 못할 경우, 다음과 같이 기타 다른 입력 노드 중 하나를 선택할 수 있습니다.
MQeInput 노드는 Workbench에서 다음 아이콘으로 표시됩니다.
이 노드를 사용할 수 있는 방법의 예로 밭에 얼마나 급수가 잘되고 있는지를 점검하는 농부를 고려해 봅시다. 농부는 WebSphere MQ Everyplace가 설치되어 있는 PDA를 휴대하고 있습니다. 농부는 급수가 잘 안되는 지역을 알게 되므로, PDA 및 전역 위성 탐색 링크를 사용하여 MQeInput 노드로 메시지를 송신합니다. Compute 노드를 사용하여 데이터를 가공하면, 리모트 SCADA 디바이스가 메시지를 선택하여 급수 스프링쿨러를 트리거할 수 있도록 메시지가 발행됩니다. 농부는 메시지를 보낸 후 몇 분 후에 밭에 물이 뿌려지는 것을 볼 수 있습니다.
WebSphere MQ 웹 페이지에 있는 WebSphere MQ Everyplace 문서에서 WebSphere MQ Everyplace에 대한 자세한 정보 및 노드 등록 정보를 찾을 수 있습니다.
MQeInput 노드 인스턴스를 메시지 플로우에 넣었으면 이 노드를 구성할 수 있습니다. 편집기 보기에서 이 노드를 마우스 오른쪽 단추로 누른 후 등록 정보를 누르십시오. 등록 정보 대화 상자에 노드의 디폴트 등록 정보가 표시됩니다.
값을 입력해야 하는 모든 필수 등록 정보(정의된 디폴트 값이 없는 등록 정보)는 등록 정보 대화 상자에서 별표(*)로 표시됩니다.
다음과 같이 MQeInput 노드를 구성하십시오.
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type> <Fmt>XML</Fmt></mcd>
값을 설정할 경우, 이 값이 MQRFH2 헤더의 값과 다르면 MQRFH2 헤더 값에 우선권이 있습니다.
XML, XMLNS, XMLNSC, JMS, MIME 및 BLOB 구문 분석기에 대해서는 메시지 세트를 공백으로 남겨 두십시오.
XML, XMLNS, XMLNSC, JMS, MIME, BLOB 및 IDOC 구문 분석기에 대해서는 메시지 유형을 공백으로 남겨 두십시오.
XML, XMLNS, XMLNSC, JMS, MIME 및 BLOB 구문 분석기에 대해서는 메시지 형식를 공백으로 남겨 두십시오.
추적 레벨을 디버그 또는 전체로 설정할 경우, WebSphere MQ Everyplace의 성능에 영향을 주며 중요한 추적 파일이 생성될 수 있습니다. 단기간인 경우에만 이 옵션을 사용하십시오.
선택란을 선택할 경우, 모든 등록 정보의 정의는 구성 파일 이름(아래에 설명됨)에서 식별된 파일에서 추출됩니다. 다음과 같은 예외가 있습니다.
하나의 WebSphere MQ Everyplace 큐 관리자만이 지원될 수 있습니다. 하나의 실행 그룹만이 MQeInput 또는 MQeOutput 노드를 포함할 수 있습니다. 따라서, 이 등록 정보는 동일한 브로커로 전개하는 모든 메시지 플로우에 포함된 모든 MQeInput 노드에서 동일한 값으로 설정되어 있어야 합니다.
채널은 단일 큐 관리자 요청보다 오래 지속되는 지속 논리 엔티티이기 때문에, 일정 기간 동안 비활성화되어 있는 채널은 시간 종료시켜야 합니다.
대화 상자를 닫고 등록 정보에서 작성한 모든 변경을 제거하려면 취소를 누르십시오.
MQeInput은 검색한 메시지를 out 터미널로 라우트합니다. 검색에 실패하면 메시지를 재시도합니다. 재시도 시간 종료가 만기되면(입력 큐의 BackoutThreshold 속성에 정의된 대로) 메시지가 failure 터미널로 라우트됩니다. 이 조건을 핸들링하기 위해 이 터미널에 노드를 연결할 수 있습니다. failure 터미널이 연결되어 있지 않으면 백아웃 큐에 메시지가 기록됩니다.
메시지 플로우에서 추가적인 예외가 전달된 후 이 노드에서 메시지가 포착되면, 메시지가 catch 터미널로 라우트됩니다. catch 터미널이 연결되어 있지 않으면, 문제점이 해결될 때까지 메시지는 노드를 통해 계속해서 루프를 순환합니다. 노드를 통해 메시지가 계속해서 루핑되는 것을 방지하려면 백아웃 큐 또는 데드-레터 큐(DLQ)를 정의해야 합니다.
메시지 플로우에 MQeInput 노드가 포함되어 있는 경우, 트랜잭션 모드 등록 정보에 대해 설정한 값이 동기점 아래에서 메시지를 수신하는지 여부를 정의합니다.
(MQOutput 노드는 이 옵션을 대체하기 위해 구성할 수 있는 유일한 출력 노드입니다.)
다음 표에는 MQeInput 노드 터미널이 설명되어 있습니다.
터미널 | 설명 |
---|---|
Failure | 오류가 발생할 경우 메시지가 라우트될 출력 터미널. |
Out | WebSphere MQ Everyplace 큐에서 검색이 완료되었을 경우 메시지가 라우트될 출력 터미널. |
Catch | 예외에서 다운스트림이 전달되어 이 노드에서 포착되었을 경우 메시지가 라우트될 출력 터미널. |
다음 표에는 노드 등록 정보가 설명되어 있습니다. 앞에 M이 표시된 열은 등록 정보가 필수임을 나타내며(디폴트가 정의되지 않았을 때 값을 입력해야 하는 경우 등록 정보 대화 상자에 별표(*)로 표시됨) 앞에 C가 표시된 열은 등록 정보가 구성 가능함을 나타냅니다(메시지 플로우를 Bar 파일에 추가하여 전개할 때 값을 변경할 수 있음).
다음 표에는 MQeInput 노드 디폴트 등록 정보가 설명되어 있습니다.
등록 정보 | M | C | 디폴트 | 설명 |
---|---|---|---|---|
메시지 도메인 | 아니오 | 아니오 | 들어오는 메시지를 구문 분석하는 데 사용하는 도메인 | |
메시지 세트 | 아니오 | 아니오 | 들어오는 메시지를 정의하는 메시지 세트의 이름 또는 ID | |
메시지 유형 | 아니오 | 아니오 | 들어오는 메시지의 이름 | |
메시지 형식 | 아니오 | 아니오 | 들어오는 메시지의 물리적 형식 이름 | |
토픽 | 아니오 | 예 | 입력 메시지의 디폴트 토픽. |
다음 표에는 MQeInput 노드의 일반 등록 정보가 설명되어 있습니다.
등록 정보 | M | C | 디폴트 | 설명 |
---|---|---|---|---|
큐 이름 | 예 | 예 | 이 노드가 이 메시지 플로우에서 처리할 메시지를 검색할 WebSphere MQ Everyplace 브릿지 큐의 이름. | |
추적 | 예 | 아니오 | 없음 | 이 노드에 필요한 추적 레벨. 올바른 값은 없음, 표준, 디버그 및 전체입니다. |
추적 파일 이름 | 예 | 예 | \MQeTraceFile.trc | 추적 레코드를 기록할 파일의 이름. |
트랜잭션 모드 | 예 | 아니오 | 예 | 수신되는 메시지가 동기점 아래에 수신되는지 여부. 올바른 값은 자동, 예 및 아니오입니다. |
구성 파일 사용 | 예 | 아니오 | 지우기 | 이 노드의 구성 파일을 사용합니다. 이 선택란을 선택하면 이 조치가 수행됩니다. |
구성 파일 이름 | 예 | 예 | \MQeconfig.ini | 구성 파일 사용 선택란을 선택한 경우 구성 파일의 이름. |
큐 관리자 이름 | 예 | 예 | ServerQM1 | WebSphere MQ Everyplace 큐 관리자의 이름. |
다음 표에는 MQeInput 노드 채널 등록 정보가 설명되어 있습니다.
등록 정보 | M | C | 디폴트 | 설명 |
---|---|---|---|---|
최대 채널 | 예 | 아니오 | 0 | WebSphere MQ Everyplace 큐 관리자가 지원하는 최대 채널 수. |
다음 표에는 MQeInput 노드 레지스트리 등록 정보가 설명되어 있습니다.
등록 정보 | M | C | 디폴트 | 설명 |
---|---|---|---|---|
유형 | 예 | 예 | 파일 레지스트리 | 사용할 레지스트리 정보 유형. 올바른 값은 파일 레지스트리 및 개인 레지스트리입니다. |
디렉토리 | 예 | 예 | \ServerQM1\registry | 레지스트리 파일이 있는 디렉토리(파일 레지스트리를 선택한 경우에만 유효) |
PIN | 예 | 예 | WebSphere MQ Everyplace 큐 관리자과 연관된 PIN(개인용 레지스트리를 선택한 경우에만 유효) | |
인증서 요청 PIN | 예 | 예 | 인증 요청에 사용되는 PIN(개인용 레지스트리를 선택한 경우에만 유효) | |
키링 암호 | 예 | 예 | 암호화 키를 보는 데 사용되는 암호(개인용 레지스트리를 선택한 경우에만 유효) | |
인증서 호스트 | 예 | 예 | 인증 서버의 이름(개인용 레지스트리를 선택한 경우에만 유효) | |
인증서 포트 | 예 | 예 | 인증 서버의 포트(개인용 레지스트리를 선택한 경우에만 유효) |
다음 표에는 MQeInput 노드 리스너 등록 정보가 설명되어 있습니다.
등록 정보 | M | C | 디폴트 | 설명 |
---|---|---|---|---|
리스너 유형 | 예 | 예 | Http | 리스너의 어댑터 유형. 올바른 값은 Http, 길이 및 히스토리입니다. |
호스트 이름 | 예 | 예 | 127.0.0.1 | 서버의 호스트 이름. |
포트 | 예 | 예 | 8081 | WebSphere MQ Everyplace가 대기하는 포트. |
시간 간격 | 예 | 예 | 300 | WebSphere MQ Everyplace 폴링 간격(초 단위). |
다음 표에는 MQeInput 노드 설명 등록 정보가 설명되어 있습니다.
등록 정보 | M | C | 디폴트 | 설명 |
---|---|---|---|---|
간단한 설명 | 아니오 | 아니오 | 노드에 대한 간략한 설명. | |
자세한 설명 | 아니오 | 아니오 | 메시지 플로우에서 노드의 목적을 설명하는 텍스트. |