MQSeries 어댑터 구성 속성
다음 표는 MQSeries 어댑터 수신 위치에 대해 프로그래밍 방식으로 설정할 수 있는 구성 속성을 보여 줍니다.
| 속성 이름 | Type | 설명 | 제한 | 의견 |
|---|---|---|---|---|
| uri | VT_BSTR | 수신 위치에서 모니터링하는 위치의 전체 경로를 지정합니다. | 송신 포트나 수신 위치의 URI는 256자를 초과할 수 없습니다. | 없음 |
| queueDetails | VT_BSTR | 서버, 큐 관리자 및 큐를 비롯한 소스 MQSeries 큐에 대한 정보를 지정합니다. | - None | 이 속성 앞에 MQS://가 추가되어 URI 속성이 만들어집니다. |
| transactionSupported | VT_BSTR | MQSeries 어댑터가 BizTalk Server와 MQSeries 서버 간에 Microsoft Distributed Transaction Coordinator(DTC) 트랜잭션을 시작하는지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
no로 설정하면 메시지 배달이 보장되지 않습니다. 기본값은 yes입니다. |
| suspendAsNonResumable | VT_BSTR | 일시 중단된 메시지가 다시 시작 불가능으로 표시될지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 no입니다. |
| dataOffsetForHeaders | VT_BSTR | 어댑터는 MQSeries 헤더(MQXQH, MQIIH 및 MQCIH 구조)의 값을 사용하여 BizTalk Server 컨텍스트 속성의 해당 값을 채웁니다. 기본적으로 어댑터는 메시지 본문에서 MQSeries 속성을 제거합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
메시지 본문에서 해당 속성을 유지하려면 이 속성을 no로 설정합니다. 기본값은 yes입니다. |
| pollingInterval | VT_BSTR | 수신 구성 요소에서 MQSeries 큐 폴링에 사용하는 간격을 지정합니다. | 유효한 값은 1에서 10000까지입니다. | pollingInterval은 어댑터에 기본적으로 하드 코드된 3초의 대기 간격과 함께 사용됩니다. pollingInterval 값이 3초보다 작으면 대기 간격은 pollingInterval 값으로 설정됩니다. 기본값은 3입니다. |
| pollingUnit | VT_BSTR | 폴링 간격의 시간 단위를 지정합니다. | 유효한 값은 다음과 같습니다. -시간 -분 -초 |
기본값은 seconds입니다. |
| maximumBatchSize | VT_BSTR | 메시지 일괄 처리의 최대 크기(KB)를 지정합니다. | 유효한 값은 1-10485760입니다. | 기본값은 100입니다. |
| maximumNumberOfMessages | VT_BSTR | 일괄 처리의 최대 메시지 수를 지정합니다. | 유효한 값은 1-100000입니다. | 기본값은 100입니다. |
| threadCount | VT_BSTR | 수신 위치당 사용되는 스레드 수를 지정합니다. | 유효한 값은 1에서 64까지입니다. | 기본값은 2입니다. |
| fragmentationSize | VT_BSTR | 메시지가 MQSAgent와 어댑터 간에 송신될 때 메시지 청크 크기(KB)를 지정합니다. | 유효한 값은 1에서 1048576. | 기본값은 500입니다. |
| characterSet | VT_BSTR | MQSeries에서 수신 위치로 메시지를 보내기 전에 문자를 변환할지 여부와 문자 집합을 지정합니다. | 유효한 값은 다음과 같습니다. -없음. 변환하지 않습니다. - UCS-2 및 UTF-16. 이러한 문자 집합으로 변환합니다. MQSeries는 이 두 문자 집합을 구분하지 않습니다. - UTF-8. UTF-8 문자 집합으로 변환합니다. |
기본값은 none입니다. |
| errorThreshold | VT_BSTR | 기록할 최대 오류 수를 지정합니다. 어댑터는 계속 작동하며, 어댑터가 복구된 경우 해당 이벤트를 이벤트 로그에 기록합니다. | 유효한 값은 1에서 1000까지입니다. | 기본값은 10입니다. |
| 세그먼트화 | VT_BSTR | MQSeries에서 조각화된 메시지를 어셈블할지, 아니면 메시지를 있는 그대로 가져올지 지정합니다. | 유효한 값은 다음과 같습니다. -없음 -완료 |
조각화를 사용하지 않고 MQSeries 큐에서 메시지를 읽으려면 none을 지정합니다. 어댑터로 조각화된 메시지를 전달하기 전에 MQSeries에서 메시지를 어셈블하게 하려면 complete를 지정합니다. 기본값은 none입니다. |
| ordered | VT_BSTR | MQSeries에서 MQSeries 큐로부터 받은 메시지 순서를 유지할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. -아니요 - noStop - yesStop - yesSuspend |
메시지 순서를 무시하려면 no를 지정합니다. 오류가 있을 때 메시지 순서를 무시한 후 수신 위치를 해제하려면 noStop을 지정합니다. 정렬을 사용하려면 yesStop을 지정합니다. 이 옵션을 사용하면 오류가 있을 때 트랜잭션이 중지되고 수신 위치가 비활성화됩니다. 정렬을 사용하려면 yesSuspend를 지정합니다. 이 옵션을 사용하면 오류가 있을 때 일시 중단된 큐로 메시지가 이동됩니다. 이 값은 오류가 있을 때 정렬 순서를 유지하지 않지만 수신 위치에서 메시지를 계속 수신할 수 있도록 허용합니다. 기본값은 no입니다. |
다음 코드는 속성을 설정하는 데 사용하는 문자열의 형식을 보여 줍니다.
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><uri>MQS://TESTMQServer/DQM1/RQ0</uri><queueDetails>TESTMQServer/DQM1/RQ0</queueDetails><transactionSupported>yes</transactionSupported><suspendAsNonResumable>no</suspendAsNonResumable><dataOffsetForHeaders>yes</dataOffsetForHeaders><pollingInterval>1</pollingInterval><pollingUnit>seconds</pollingUnit><maximumBatchSize>100</maximumBatchSize><maximumNumberOfMessages>100</maximumNumberOfMessages><threadCount>2</threadCount><fragmentationSize>500</fragmentationSize><characterSet>none</characterSet><errorThreshold>10</errorThreshold><segmentation>none</segmentation><ordered>no</ordered></Config></AdapterConfig></CustomProps>
다음 표는 MQSeries 어댑터 송신 포트에 대해 설정할 수 있는 구성 속성을 보여 줍니다.
| 속성 이름 | Type | 설명 | 제한 | 의견 |
|---|---|---|---|---|
| uri | VT_BSTR | 데이터를 보낼 위치의 전체 경로를 지정합니다. | 송신 포트나 수신 위치의 URI는 256자를 초과할 수 없습니다. | 없음 |
| queueDetails | VT_BSTR | 서버, 큐 관리자 및 큐를 비롯한 대상 MQSeries 큐에 대한 정보를 지정합니다. | 송신 포트나 수신 위치의 URI는 256자를 초과할 수 없습니다. | 이 속성 앞에 MQS://가 추가되어 URI 속성이 만들어집니다. |
| transactionSupported | VT_BSTR | MQSeries 어댑터가 BizTalk Server와 MQSeries 서버 간에 Microsoft Distributed Transaction Coordinator(DTC) 트랜잭션을 시작하는지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
no로 설정하면 메시지 배달이 보장되지 않습니다. 기본값은 yes입니다. |
| dataConversion | VT_BSTR | 메시지를 Windows 서버용 MQSeries의 ANSI 코드 페이지로 변환할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 no입니다. |
| segmentationAllowed | VT_BSTR | 개별 메시지가 MQSeries 큐 최대 메시지 길이를 초과할 경우 MQSeries 큐 관리자 조각화를 사용할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 no입니다. |
| fragmentationSize | VT_BSTR | 메시지가 어댑터와 MQSAgent 간에 송신될 때 메시지 청크 크기(KB)를 지정합니다. | 유효한 값은 1에서 1048576. | 기본값은 500입니다. |
| ordered | VT_BSTR | MQSeries에서 MQSeries 큐로 보낸 메시지 순서를 유지할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 no입니다. |
다음 코드는 속성을 설정하는 데 사용하는 문자열의 형식을 보여 줍니다.
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><uri>MQS://TESTMQServer/DQM1(QM1)/SQ0</uri><queueDetails>TESTMQServer/DQM1(QM1)/SQ0</queueDetails><transactionSupported>yes</transactionSupported><dataConversion>no</dataConversion><segmentationAllowed>no</segmentationAllowed><fragmentationSize>500</fragmentationSize><ordered>no</ordered></Config></AdapterConfig></CustomProps>
참고
어댑터 프레임워크를 사용하여 빌드된 어댑터에 대한 TransportTypeData 구성 데이터를 지정할 때 사용되는 이름/값 쌍은 모두 AdapterConfig> 요소에 <저장되어야 합니다. <AdapterConfig> 요소는 VT_BSTR(vt="8") 데이터 형식 <> 을 지정하므로 데이터의 문자를 이스케이프해야 합니다.