MQSC 어댑터에 대한 수신 포트 및 수신 위치를 구성하는 방법
BizTalk Server 관리 콘솔을 사용하여 WebSphere MQ용 BizTalk 어댑터에 대한 수신 포트 및 수신 위치를 구성합니다. BizTalk Server 관리자 그룹의 구성원인 계정으로 로그온해야 합니다. 또한 SSO(Single Sign-On) 데이터베이스에 적절한 권한이 있어야 합니다.
수신 포트 및 수신 위치를 구성하려면
프로그램에서Microsoft BizTalk Server 선택한 다음, BizTalk Server 관리를 선택합니다.
콘솔 트리에서 BizTalk 그룹을 확장하고 애플리케이션을 확장한 다음 수신 포트를 만들 애플리케이션을 선택합니다.
수신 포트를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 단방향 수신 포트를 클릭합니다.
수신 포트 속성 창에서 포트에 대한 속성을 구성한 다음 확인을 클릭합니다.
콘솔 트리에서 수신 위치를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 가리킨 다음 단방향 수신 위치를 클릭합니다.
수신 포트 선택 창에서 이전 단계에서 만든 수신 포트를 클릭한 다음 확인을 클릭합니다.
수신 위치 속성 창에서 MQSC 어댑터를 전송 유형으로 선택한 다음 구성을 클릭합니다.
어댑터의 전송 속성 창에서 수신 위치의 속성을 구성합니다(이 절차의 끝에 있는 테이블을 참조).
참고
수신 위치를 구성하려면 다음 속성이 필요합니다.
채널 이름 (대/소문자를 구분하는 속성입니다.)
연결 이름
전송 유형
큐 (대/소문자를 구분하는 속성입니다.)
큐 관리자 (대/소문자를 구분하는 속성입니다.)
채널 이름 속성을 지정하지 않으면 BizTalk Server 컴퓨터에 설치된 WebSphere MQ 클라이언트가 원격 큐 관리자와 통신할 수 있도록 클라이언트 채널 정의 파일을 제공해야 합니다. 트랜잭션 메시징을 사용하도록 SSL(Secure Sockets Layer)을 구성하는 경우에도 클라이언트 채널 정의 파일을 제공해야 합니다. 자세한 내용은 클라이언트 채널 정의 파일을 구성하는 방법을 참조하세요.
속성 구성을 마쳤으면 확인을 클릭합니다.
수신 위치 속성 창의 수신 처리기 목록에서 수신 위치가 실행될 BizTalk Server 호스트의 instance 선택합니다.
수신 핸들러가 이 호스트에서 실행되고 있어야 합니다.
수신 파이프라인 목록에서 이 수신 위치에서 메시지를 받는 데 사용할 수신 파이프라인을 선택합니다.
확인을 클릭합니다.
수신 위치 창의 이름 열에서 수신 위치를 마우스 오른쪽 단추로 클릭하고 사용을 선택합니다.
수신 위치 속성
전송 속성 창의 고급 섹션에서 다음 속성을 설정할 수 있습니다.
사용 항목 원하는 작업 헤더 데이터 오프셋 어댑터는 MQSeries 헤더(MQMD, MQXQH, MQIIH 및 MQCIH 구조체)의 값을 사용하고 BizTalk Server 컨텍스트 속성에서 해당 값을 채웁니다. 기본적으로 어댑터는 메시지 본문에서 MQSeries 속성을 제거합니다. 메시지 본문에 속성을 유지하려면 아니요 로 설정합니다.
기본값: 예이벤트 로그 오류 임계값 특정 오류 조건에 대해 기록할 동일한 오류의 최대 수입니다. 어댑터는 계속 작동하며 어댑터가 복구되면 애플리케이션 로그에 이벤트를 기록합니다.
기본값: 10주문됨 MQSeries 큐에서 수신되고 BizTalk Server MessageBox에 전송되는 메시지의 순서를 유지하려면 예로 설정합니다.
송신 쪽의 경우 어댑터는 메시지 상자에서 받는 순서와 동일한 순서로 메시지를 큐에 보냅니다.
메시지 순서를 유지하지 않으려면 아니요 로 설정합니다.
송신 쪽 순서 지정의 경우 오케스트레이션을 사용하지 않는 경우 송신 포트 구성의 전송 고급 옵션에서 주문 배달을 사용하도록 설정해야 합니다.
수신 쪽 순서 지정의 경우 오케스트레이션을 사용하는 경우 수신 위치에 대한 오케스트레이션에서 Ordered Delivery 속성을 True 로 설정해야 합니다.
정렬된 배달은 성능을 저하할 수 있습니다. 주문된 배달이 필요하지 않으면 권장되지 않습니다.
기본값: 아니요오류 발생 시 중지 오류가 있는 경우 처리를 중지하려면 예로 설정합니다. 이 옵션을 사용하면 오류가 있을 때 트랜잭션이 중지되고 수신 위치가 비활성화됩니다.
기본값: 아니요일시 중단됨(다시 시작 불가능) 오류가 있을 때 메시지를 일시 중단된 큐로 이동하고 다시 시작할 수 있는지 여부를 나타내려면 예로 설정합니다.
이 값을 사용하도록 설정해도 오류가 발생할 때 순서가 지정된 배달은 유지되지 않지만 수신 위치가 메시지를 계속 받을 수 있습니다.
기본값: 아니요트랜잭션 지원 예로 설정하면 MQSC 어댑터는 BizTalk Server 컴퓨터의 WebSphere MQ 확장 트랜잭션 클라이언트(확장 클라이언트)와 함께 작동하여 메시지 손실을 방지하고 한 번만 메시지 배달을 보장합니다.
아니요로 설정하면 메시지 중복이 발생할 수 있습니다. 이 경우 어댑터는 MQSeries와의 통합을 위해 트랜잭션이 아닌 WebSphere MQ 클라이언트(Base-Client)를 사용합니다.
기본값: 아니요Wait Interval(대기 간격) MQSeries 큐에서 메시지를 검색하기 위해 MQGet을 수행하면 대기 간격에 대한 MQGMO 옵션을 설정할 수 있습니다. 큐에 메시지가 없는 경우 어댑터는 클라이언트 요청을 닫기 전에 지정된 시간(초)을 기다립니다. 메시지가 큐에 도착하자마자 어댑터는 메시지 검색을 시작합니다.
기본값: 3전송 속성 창 채널 정의 섹션에서 다음 속성을 설정할 수 있습니다.
사용 항목 원하는 작업 채널 이름 클라이언트가 통신하는 MQSeries 서버 컴퓨터에 정의된 채널의 이름입니다. '서버 연결' 채널 유형이어야 합니다.
대/소문자를 구분하는 속성입니다.연결 이름 MQSC 어댑터가 메시지를 수신하는 큐 관리자 및 큐가 포함된 MQSeries 서버의 이름입니다.
TCP 전송 형식의 경우 지정할 형식은 SERVERNAME(PORT)입니다. 포트 번호는 큐 관리자와 연결된 수신기에 정의된 포트 번호와 동일합니다.
서버 이름을 IP 주소로 지정할 수도 있습니다.
LU6.2의 경우 호스트 통합 서버에 구성된 LU 이름 또는 LU 풀 이름을 지정합니다.하트비트 클라이언트/서버 연결이 작동하는지 확인하기 위한 검사 사이의 시간(초)입니다.
기본값: 300암호 원격 MCA를 사용하여 보안 LU 6.2 세션을 시작하려고 할 때 MCA에서 사용할 수 있는 암호입니다.
이 선택적 속성의 초기 값은 null입니다.SSL 암호 사양 어댑터에 구성된 엔드포인트에서 사용할 SSL 연결에 대한 단일 CipherSpec을 정의합니다. WebSphere MQ SSL 채널 정의의 양쪽 끝에는 특성이 포함되어야 하며 여기에 지정된 값은 채널의 서버 끝에 지정된 이름과 일치해야 합니다. 값은 최대 길이가 32자인 문자열입니다.
MQSeries 클라이언트와 원격 큐 관리자 간의 통신을 위해 SSL이 구성된 경우에만 필요합니다.SSL 피어 이름 WebSphere MQ 채널의 다른 쪽 끝에 있는 피어 큐 관리자 또는 클라이언트에서 인증서의 고유 이름(DN이라고도 함)을 검사 데 사용됩니다. 피어에서 받은 고유 이름이 이 값과 일치하지 않으면 채널이 시작되지 않습니다.
MQSeries 클라이언트와 큐 관리자 간의 통신을 위해 SSL이 구성된 경우에만 필요합니다.전송 유형 TCP 및 LU6.2가 지원됩니다.
기본값: TCPUser Id MQSeries 리소스에 액세스하기 위한 권한 부여를 위해 MQSeries MCA에서 사용하는 MCA 사용자 식별자입니다.
초기 값은 null입니다. 선택적 속성입니다. 이 특성이 비어 있으면 MCA는 기본 사용자 식별자를 사용합니다.전송 속성 창 MQSeries 섹션에서 다음 속성을 설정할 수 있습니다.
사용 항목 원하는 작업 문자 집합 MQSeries 큐에서 메시지를 받을 때 메시지를 변환해야 하는 문자 집합입니다. 이 속성이 None 이외의 값으로 설정된 경우 어댑터는 MQGet을 수행할 때 MQGMO CONVERT 옵션을 설정합니다.
없음: 변환하지 마세요.
UCS-2 및 UTF-16: 이러한 문자 집합으로 변환합니다. MQSeries는 이 두 문자 집합을 구분하지 않습니다.
UTF-8: UTF-8 문자 집합으로 변환합니다.
Default: None조각화 허용 조각화된 메시지를 어셈블하거나 메시지를 있는 그대로 가져오도록 MQSeries를 설정합니다. 조각화를 사용하지 않고 MQSeries 큐에서 메시지를 읽으려면 작업 없음을 사용합니다. 어댑터로 조각화된 메시지를 전달하기 전에 MQSeries에서 메시지를 어셈블하게 하려면 전체 메시지를 사용합니다.
기본값: 작업 없음전송 속성 창 성능 섹션에서 다음 속성을 설정할 수 있습니다.
사용 항목 원하는 작업 최대 일괄 처리 크기 메시지 일괄 처리의 최대 크기(KB)입니다.
이 속성과 Batch의 최대 메시지는 함께 작동하므로 어댑터가 먼저 도달하는 값에 제한이 있습니다.
Default: 100일괄 처리의 최대 메시지 수 일괄 처리의 최대 메시지 수는 1에서 10,000까지입니다.
이 속성과 최대 일괄 처리 크기 는 어댑터가 먼저 도달하는 값 중 한도가 되도록 함께 작동합니다.
기본값: 10스레드 수신 위치당 사용되는 스레드 수입니다.
기본값: 2전송 속성 창 큐 정의 섹션에서 다음 표에 나열된 속성을 설정할 수 있습니다.
사용 항목 원하는 작업 큐 어댑터가 (MQGet) 메시지를 받을 MQSeries 큐입니다.
전송 큐, 로컬 큐, 별칭 큐가 지원됩니다.
대/소문자를 구분하는 속성입니다.큐 관리자 어댑터가 메시지를 검색할 큐를 포함하는 MQSeries 큐 관리자의 이름입니다.
클러스터형 큐 관리자가 지원됩니다.
대/소문자를 구분하는 속성입니다.확인을 클릭합니다.
참고 항목
WebSphere MQ용 BizTalk 어댑터
클라이언트 채널 정의 파일을 구성하는 방법
MQSC 어댑터에 대한 송신 포트를 구성하는 방법