MQGet 노드

Use the MQGet node to receive messages from clients that connect to the integration node by using the WebSphere® MQ 엔터프라이즈 전송.

MQGet 노드는 다음 조작 모드에서 사용 가능합니다.
  • 개발자
  • Application Integration Suite
  • 표준
  • 고급
  • 고속
  • 배율
  • 어댑터
자세한 정보는 동작 모드의 내용을 참조하십시오.

또한 MQGet 노드를 사용하여 통합 노드 큐 관리자에 정의된 WebSphere MQ 메시지 큐에 이전에 배치된 메시지를 검색할 수 있습니다.

WebSphere MQ is available as a separate installation package, and your IBM® Integration Bus license entitles you to install and use WebSphere MQ with IBM Integration Bus. 자세한 정보는 WebSphere MQ 와의 상호작용에서 향상된 유연성 및 WebSphere MQ 설치의 내용을 참조하십시오.

이 토픽에는 다음 절이 들어 있습니다.

이 토픽은 다음 용어를 사용합니다.
입력 메시지
MQGet 노드의 In 터미널에 입력하는 메시지입니다.
큐 메시지
MQGet 노드가 큐에서 읽는 메시지입니다.

목적

MQGet 노드는 지정된 큐에서 메시지를 읽고 메시지에 대한 처리 환경을 설정합니다. 해당되는 경우, 입력 큐를 WebSphere MQ 클러스터된 큐 또는 공유 큐로 정의할 수 있습니다.

메시지 플로우의 첫 번째 노드로만 사용할 수 있는 MQInput 노드와 달리 메시지 플로우에서 MQGet 노드를 사용할 수 있습니다. MQGet 노드의 출력 메시지 트리는 MQGET 호출의 결과 트리와 입력 트리를 결합하여 구성됩니다. MQGet 노드의 특성을 설정하여 메시지가 수신되는 방법을 제어할 수 있습니다. 예를 들어, 트랜잭션 제어하에서 메시지가 처리되도록 표시하거나 결과 트리가 작성될 때 모든 입력 메시지 수신 시 데이터 변환이 수행되도록 요청할 수 있습니다.

트랜잭션에 대해 MQGet 를 구성하는 방법에 대한 정보는 트랜잭션에 대한 MQ 노드 구성의 내용을 참조하십시오.

분산 시스템에서 MQ 연결 특성을 설정하거나 정책 탭에서 MQEndpoint 정책을 지정하여 로컬 또는 리모트 큐 관리자의 WebSphere MQ 큐에서 메시지를 가져오도록 MQGet 노드를 구성할 수 있습니다.

통합 노드에 이와 연관된 큐 관리자가 있는 경우 기본적으로 MQ 메시지 플로우 노드는 해당 큐 관리자를 서버 바인딩에 연결합니다. MQ 연결 탭에서 특성을 구성하는 경우에는 이러한 특성은 지정된 큐 관리자에 연결하는 데 사용됩니다. MQEndpoint 정책을 지정하는 경우에는 정책의 값이 MQ 연결 탭에 정의된 값 대신에 사용됩니다.

z/OS®에서는 큐 관리자에 대한 로컬 연결만 지원됩니다. 통합 노드에 대해 큐 관리자가 지정되어 있어야 하지만 연결에 대한 서버 바인딩을 사용하여 MQGet 노드의 다른 로컬 큐 관리자에 연결할 수도 있습니다.

MQGet 노드의 보안 신원 특성을 사용하여 사용자 이름 및 비밀번호를 큐 관리자에 전달하여 보안 로컬 또는 리모트 큐 관리자에 연결할 수 있습니다. ID는 mqsisetdbparms 명령을 사용하여 정의됩니다. 보안 ID 특성을 사용하여 로컬 및 클라이언트 연결에서 보안 신임 정보를 제공할 수 있지만, 클라이언트 채널 정의 테이블(CCDT)을 사용하는 클라이언트 연결에는 사용할 수 없습니다. 또한 리모트 큐 관리자에 대한 클라이언트 연결이 작성될 때 SSL 프로토콜을 사용할지 여부를 선택할 수도 있습니다. SSL을 사용하여 클라이언트 연결에 기밀성을 제공하려면 MQGet 노드에서 SSL 사용하기 특성을 선택하십시오. MQEndpoint 정책를 통해 이 특성을 설정할 수도 있습니다. 보안 ID및 SSL 사용에 대한 자세한 정보는 보안 WebSphere MQ 큐 관리자에 연결의 내용을 참조하십시오.

MQGet 노드는 다음 메시지 도메인의 메시지를 처리합니다.
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

MQGet 노드는 팔레트의 WebSphere MQ 드로어에 포함되어 있으며 다음 아이콘으로 IBM 통합 툴킷 에 표시됩니다.

MQGet 노드 아이콘

메시지 플로우에서 MQGet 노드 사용

MQGet 노드의 인스턴스를 메시지 플로우에 넣으면 구성할 수 있습니다. 자세한 정보는 메시지 플로우 노드 구성하기의 내용을 참조하십시오. 노드의 특성이 특성 보기에 표시됩니다. 값을 입력해야 하는 모든 필수 특성(기본값이 정의되지 않은 특성)은 별표가 표시됩니다.

메시지 플로우에서 MQGet 노드를 사용하는 방법에 대한 정보는 MQGet 노드가 WebSphere MQ MQGet API 호출을 구현하는 방법의 내용을 참조하십시오.

터미널 연결

메시지 플로우에서 이 노드의 Out, 경고, 실패 및 메시지 없음 출력 터미널을 메시지 플로우의 다른 노드에 연결하여 메시지를 추가로 처리하고, 오류를 처리하거나 메시지를 또 다른 목적지로 보내십시오.

MQGET 호출이 생성하는 완료 코드(CC)는 각 출력 터미널에 전파되는 것을 제어합니다.
  • MQGET 호출이 성공하면 MQGet 노드는 각각의 구문 분석된 출력 메시지를 Out 터미널로 라우트합니다.
  • MQGET 호출에 실패하지만 경고를 나타내는 CC가 있는 경우에는 구문 분석되지 않은 출력 메시지가 경고 터미널로 전파됩니다.
  • MQGET 호출이 경고보다 심각한 CC로 실패하는 경우에는 입력 메시지가 실패 터미널로 전파됩니다.
  • MQGET 호출이 MQRC_NO_MSG_AVAILABLE 이유 코드로 실패하는 경우에는, 출력 메시지가 메시지 없음 터미널로(결과 본문 없이) 전파됩니다. 메시지 없음 터미널로 전파된 출력 메시지는 모드 생성, 메시지 복사 및 로컬 환경 복사 특성의 값에 따라 입력 메시지에서만 구성됩니다.
  • Out, 경고 또는 메시지 없음 터미널을 메시지 플로우의 다른 노드에 연결하지 않는 경우 이러한 터미널에 전파되는 모든 메시지가 제거됩니다.
  • 실패 터미널을 메시지 플로우의 또 다른 노드에 연결하지 않는 경우 통합 노드는 메시지가 해당 터미널에 전파될 때 예외를 생성합니다.

자세한 정보는 장애 터미널 연결의 내용을 참조하십시오.

터미널 및 특성

MQGet 노드를 메시지 플로우에 추가할 때 메시지 플로우 편집기에서 특성 보기를 사용하여 구성할 수 있습니다. 필드 도움말을 표시하려면 필드 안에서 클릭한 후 필드의 시작에서 표시되는 정보 아이콘을 클릭하십시오. 기본값이 정의되지 않은 모든 필수 특성은 별표로 표시됩니다. 일반 구성 정보는 메시지 플로우 노드 구성하기의 내용을 참조하십시오. MQ 서비스 를 사용하여 MQGet 노드를 구성할 수도 있지만, 이는 큐 관리자가 통합 노드에 지정된 경우에만 지원됩니다. MQ 서비스를 사용하여 MQ 노드 구성을 참조하십시오.

가동 정책을 작성하고 첨부하여 런타임 시 이 유형의 노드에 대한 특정 연결 특성을 제어할 수 있습니다. 정책에 대한 자세한 정보는 운영 정책 특성의 내용을 참조하십시오.

다음 표는 노드 터미널 및 메시지 플로우 편집기의 특성 보기에 있는 지정된 탭에서 설정할 수 있는 노드 특성을 설명합니다. 헤드가 M인 열은 특성이 필수(기본값이 정의되지 않을 때 값을 입력해야 하는 경우 별표로 표시)인지 여부를 표시합니다.

노드 터미널의 테이블

테이블 1. MQGet 노드의 터미널
터미널 설명
입력 메시지 플로우에서 처리할 메시지를 승인하는 입력 터미널.
경고 큐에서 메시지를 얻으려고 시도하는 동안 노드에서 오류가 발생한 경우(경고를 나타내는 CC와 함께) 출력 트리가 전파되는 출력 터미널. 메시지의 MQMD 부분이 구문 분석되며 메시지의 나머지는 구문 분석되지 않는 BLOB 요소입니다. 터미널에 연결되어 있지 않으면 경고가 제거되고 노드에서 어떤 출력도 전달되지 않습니다.
실패 큐에서 메시지를 가져오려고 시도하는 동안 노드에서 오류가 발생한 경우(경고보다 심각한 오류를 나타내는 CC와 함께) 입력 메시지가 라우트되는 출력 터미널.
Out WebSphere MQ 큐에서 메시지가 검색되는 경우 메시지가 라우트되는 출력 터미널입니다.
No Message 큐에 사용 가능한 메시지가 없는 경우에 입력 메시지가 라우팅되는 출력 터미널입니다. 메시지 없음 터미널로 전파된 출력 메시지는 모드 생성, 메시지 복사 및 로컬 환경 복사 특성의 값에 따라 입력 메시지에서만 구성됩니다.

노드 특성 테이블

테이블 2. 노드의 설명 특성
특성 M 기본값 설명
노드 이름 아니오 노드 유형, MQGet 노드의 이름입니다.
간단한 설명 아니오 공백 노드의 간략한 설명입니다.
자세한 설명 아니오 공백 메시지 플로우에서 노드의 목적을 설명하는 텍스트입니다.
테이블 3. 노드의 기본 특성
특성 M 기본값 설명
큐 이름 예 없음 이 노드가 메시지를 검색하는 WebSphere MQ 메시지 큐의 이름입니다.

메시지 플로우가 배치되는 통합 노드를 호스팅하는 큐 관리자에 이 큐를 사전정의해야 합니다. 이 큐가 올바른 큐가 아닌 경우에는 노드가 예외를 생성하고 입력 메시지는 Failure 터미널로 전파됩니다.
[표 4] 노드의 MQ 연결 특성
특성 M 기본값 설명
연결 아니오 로컬 큐 관리자 이 특성은 WebSphere MQ에 연결하는 방법을 지정합니다.
  • 지정된 큐 관리자에 로컬 연결을 작성하려면 로컬 큐 관리자를 선택하십시오. 이 옵션이 선택되는 경우 목적지 큐 관리자 이름 특성에서 큐 관리자를 지정하십시오.

    이 특성이 대상 큐 관리자 이름 값 없이 설정되고 정책 탭에 MQEndpoint 정책이 지정되지 않은 경우, MQ 노드는 런타임 시 통합 노드에 지정된 큐 관리자의 연결 세부사항을 사용합니다. 통합 노드에 대해 큐 관리자가 지정되지 않은 경우 메시지 플로우가 배치되지 않습니다.

  • 클라이언트 연결 세부사항을 지정하여 리모트 큐 관리자에 대한 클라이언트 연결을 작성하려면 MQ 클라이언트 연결 특성을 선택하십시오. 이 옵션이 선택되면 다음 특성도 지정해야 합니다.
    • 큐 관리자 호스트 이름
    • 리스너 포트 번호
    • 채널 이름
    • 목적지 큐 관리자 이름
  • 클라이언트 채널 정의 테이블(CCDT) 파일에 지정된 클라이언트 연결 세부사항을 사용하려면 클라이언트 채널 정의 테이블(CCDT) 파일을 선택하십시오. 이 옵션이 선택되면 큐 관리자 이름도 지정해야 합니다.
    통합 노드 레지스트리 오브젝트 특성 mqCCDT을 사용하여 mqsichangeproperties 명령을 실행하여 CCDT 파일의 위치를 지정하십시오. 예를 들어, 다음 명령을 한 행에 입력하십시오.
    mqsichangeproperties IBNODE -o BrokerRegistry -n mqCCDT 
-v "C:\Program Files (x86)\IBM\WebSphere MQ\Qmgrs\QM1\@ipcc\AMQCLCHL.TAB"
    자세한 정보는 통합 노드 레지스트리 오브젝트 매개변수 값의 내용을 참조하십시오.

    CCDT와 연결하기 및 mqCCDT 를 선택하지 않으면 IBM Integration Bus 가 지정된 큐 관리자에 연결을 시도할 때 런타임 오류가 발생합니다. mqCCDT 특성은 특정 통합 노드에 적용되므로, CCDT를 사용하여 다른 큐 관리자에 연결하려는 경우 각 큐 관리자에 대한 CCDT 파일에서 별도의 클라이언트 연결 채널을 정의해야 합니다.

mqsiapplybaroverride 의 유효값은 SERVER, CLIENT및 CCDT입니다.
목적지 큐 관리자 이름 아니오   이 특성은 메시지 큐가 정의되는 큐 관리자의 이름을 지정합니다.
큐 관리자 호스트 이름 아니오   이 특성은 큐 관리자의 호스트 이름을 지정합니다.

고가용성을 달성하려면, 쉼표로 각 호스트 이름을 분리하여 둘 이상의 호스트 이름을 지정할 수 있습니다. 목록의 첫 번째 호스트 이름이 기본 호스트 이름으로 사용됩니다. 호스트 이름으로의 연결이 사용 불가능하게 되면, 다음 호스트 이름이 사용되는 방식입니다. WebSphere MQ의 고가용성에 대한 자세한 정보는 WebSphere MQ 버전 7.5제품 문서 온라인를 참조하십시오.
리스너 포트 번호 아니오   이 특성은 큐 관리자가 대기 중인 포트를 지정합니다.
채널 이름 아니오   이 특성은 메시지를 전송하고 받기 위해 큐 관리자가 사용하는 채널의 이름을 지정합니다.
보안 ID 아니오   이 특성은 보안 로컬 또는 리모트 큐 관리자로의 연결을 위한 사용자 이름과 비밀번호 신임 정보를 제공하는 데 사용되는 ID를 지정합니다. 로컬 및 클라이언트 연결에 대한 신임 정보를 제공하는 데 사용될 수 있지만, 클라이언트 채널 정의 테이블(CCDT)을 사용하여 구성되는 클라이언트 연결에는 사용할 수 없습니다.

ID는 mqsisetdbparms 명령을 사용하여 정의됩니다. 이 명령을 사용하여 보안 ID를 설정하는 경우 다음이 접두부로 사용되는지 확인하십시오.mq::. 노드 또는 MQEndpoint 정책에서 보안 ID를 설정할 때 접두부를 포함하지 마십시오.

자세한 정보는 보안 WebSphere MQ 큐 관리자에 연결의 내용을 참조하십시오.
SSL 사용 아니오 아니오 이 특성은 리모트 큐 관리자에 대한 클라이언트 연결을 작성할 때 SSL 프로토콜을 사용하는지 여부를 제어합니다. SSL을 사용하여 클라이언트 연결에 기밀성을 제공하려면 이 특성을 선택하십시오. MQEndpoint 정책를 통해 이 특성을 설정할 수도 있습니다.

MQ 클라이언트 연결 특성이나 클라이언트 채널 정의 테이블(CCDT)을 사용하여 구성되는 클라이언트 연결에 대해 SSL을 사용할 수 있습니다.

SSL 사용을 선택하고 MQ 클라이언트 연결 특성을 통해 연결 세부사항을 지정하는 경우, 다음 특성도 설정할 수 있습니다.
  • SSL 피어 이름
  • SSL 암호 스펙
SSL 피어 이름 및 SSL 암호 스펙 특성은 클라이언트 채널 정의 테이블(CCDT)을 사용하는 클라이언트 연결에 사용되지 않습니다. CCDT에서 이 정보를 지정할 수 있습니다.
SSL 사용 특성을 선택하는 경우 SSL 키 저장소의 위치도 지정해야 합니다. SSL키 저장소는 WebSphere MQ GSkit을 사용하여 작성되며, 큐 관리자에 대해 선택된 인증 정책에 적합한 필수 개인 및 공용 인증서를 보유합니다. mqsichangeproperties 명령을 사용하여 키 저장소 위치를 지정하십시오. SSL키 저장소 전체 파일 경로에서 .kdb 파일 확장자를 뺀 값으로 지정됩니다. 예를 들어, SSL 키 저장소가 C:\SSL\key.kdb에 위치하는 경우 다음 명령을 사용하여 설정할 수 있습니다.
mqsichangeproperties IB10NODE -o BrokerRegistry -n mqKeyRepository -v C:\SSL\key

SSL 키 저장소 비밀번호 숨김 파일 key repository file name.sth는 키 저장소와 동일한 폴더 위치에 위치해야 합니다. 스태쉬 파일은 WebSphere MQ GSKit을 사용하여 작성됩니다.

SSL 키 저장소에 대한 변경을 선택하려면 MQSC REFRESH SECURITY 명령을 사용하십시오.

자세한 정보는 보안 WebSphere MQ 큐 관리자에 연결의 내용을 참조하십시오.
SSL 피어 이름 아니오   이 특성은 클라이언트 연결을 작성할 때 리모트 큐 관리자에 전달되는 이름을 지정합니다. 연결이 성공하려면 포지티브 매치가 있어야 합니다.

SSL 사용 특성이 선택되고 클라이언트 연결 세부사항이 MQ 클라이언트 연결 특성을 통해 지정되는 경우 이 특성을 지정할 수 있습니다. 클라이언트 채널 정의 테이블(CCDT)을 사용하는 클라이언트 연결에는 사용되지 않습니다. CCDT에서 이 정보를 지정할 수 있습니다.
SSL 암호 스펙 아니오   이 특성은 리모트 큐 관리자가 보안화되는 대칭 키 암호화 알고리즘의 이름을 지정합니다.

SSL 사용 특성이 선택되고 클라이언트 연결 세부사항이 MQ 클라이언트 연결 특성을 통해 지정되는 경우 이 특성을 지정할 수 있습니다. 클라이언트 채널 정의 테이블(CCDT)을 사용하는 클라이언트 연결에는 사용되지 않습니다. CCDT에서 이 정보를 지정할 수 있습니다.

메시지가 로컬 또는 리모트 큐 관리자의 큐에서 검색될 수 있게 하려면 연결 세부사항을 구성하십시오. MQ 연결 탭에 설정된 값은 정책 탭에 지정된 MQEndpoint 정책의 값으로 대체되지 않는 한 런타임에 사용됩니다.

[표 5] 노드의 입력 메시지 구문 분석 특성
특성 M 기본값 설명
메시지 도메인 아니오 BLOB(blob) 메시지를 구문 분석하는 데 사용되는 도메인입니다. 이 필드가 공백인 경우 기본값은 BLOB입니다.
메시지 모델 아니오 선택되지 않음 메시지가 정의되는 메시지 모델 스키마 파일의 이름 또는 위치입니다.

찾아보기를 클릭하면 선택한 메시지 도메인에 사용 가능한 메시지 모델 스키마 파일의 목록이 표시됩니다.
메시지 아니오 선택되지 않음 메시지 모델 스키마 파일 내의 메시지 루트 이름 또는 위치입니다. 이 목록은 사용자가 선택한 메시지 모델에 정의된 모든 사용 가능한 메시지로 채워집니다.
물리적 형식 아니오 선택되지 않음 메시지의 물리적 형식 이름입니다. MRM 또는 IDOC 구문 분석기를 사용 중인 경우 수신되는 메시지의 물리적 형식을 목록에서 선택하십시오. 이 목록은 선택된 메시지 모델에 정의된 모든 물리적 형식을 포함합니다. 메시지 도메인 특성을 DataObject로 설정한 경우 이 특성을 XML 또는 SAP ALE IDoc로 설정할 수 있습니다. 외부 소스에서 비트스트림을 구문 분석하고 메시지 트리를 생성해야 하는 경우에는 이 특성을 SAP ALE IDoc로 설정하십시오.
큐 메시지 에 MQRFH2 헤더가 있는 경우, 입력 메시지 구문 분석 특성에 대한 값을 설정할 필요가 없습니다. 값은 다음에서 파생될 수 있기 때문입니다.<mcd>MQRFH2 헤더의 폴더. 예를 들어, 다음과 같습니다.
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type><Fmt>XML</Fmt></mcd>
값을 설정하고 값이 MQRFH2 헤더의 값과 다른 경우,<Msd>요소는 유효한 도메인이며, MQRFH2 헤더의 값이 우선합니다.
[표 6] 노드의 구문 분석기 옵션 특성
특성 M 기본값 설명
구문 분석 타이밍 아니오 요청 시 이 특성은 큐 메시지 이 구문 분석될 때 제어합니다. 올바른 값은 요청 시, 즉시 및 완료입니다. 기본적으로 이 특성은 요청 시로 설정되어 있으므로, 메시지의 구문 분석이 지연됩니다. 메시지가 즉시 구문 분석되도록 하려면 요구에 대한 구문 분석의 내용을 참조하십시오.
MQRFH2 헤더에 대해 MQRFH2C 압축 구문 분석기 사용 아니오 선택되지 않음 이 특성은 MQRFH2 헤더에 MQRFH2 구문 분석기 대신 MQRFH2C 압축 구문 분석기를 사용하는지 여부를 제어합니다. MQRFH2C 구문 분석기를 사용하려면 MQRFH2 헤더에 MQRFH2C 압축 구문 분석기 사용을 선택하십시오. 기본적으로 이 선택란은 선택 취소되고 압축 구문 분석기가 사용되지 않음을 의미합니다.
XML 스키마 데이터 유형을 사용하여 트리 빌드 아니오 선택되지 않음 이 특성은 XML 스키마에서 가져온 데이터 유형으로 메시지 트리에서 구문 요소를 작성할 것인지 여부를 제어합니다. 유효성 검증 탭의 유효성 검증 특성을 컨텐츠 또는 컨텐츠 및 값으로 설정하는 경우에만 이 특성을 선택할 수 있습니다. XMLNSC에 대한 자세한 정보는 XMLNSC 도메인에서 메시지 조작하기의 내용을 참조하십시오.
XMLNS 도메인에 대해 XMLNSC 압축 구문 분석기 사용 아니오 선택되지 않음 이 특성은 XMLNS 도메인의 메시지에 대해 XMLNSC 압축 구문 분석기가 사용되는지 여부를 제어합니다. 이 특성을 설정하면 입력 MQRFH2 헤더 또는 입력 메시지 구문 분석 특성 메시지 도메인이 XMLNS인 경우 출력 터미널에 연결되는 노드에서 XMLNSC 아래에 메시지 데이터가 표시됩니다.
혼합 컨텐츠 보유 아니오 선택되지 않음 이 특성은 XMLNSC 구문 분석기가 큐 메시지 메시지에서 혼합 텍스트를 발견할 때 메시지 트리에 요소를 작성하는지 여부를 제어합니다. 선택란을 선택하면 혼합 텍스트에 대한 요소가 작성됩니다. 선택란을 선택 취소하면 혼합 텍스트가 무시되고 요소는 작성되지 않습니다.
주석 보유 아니오 선택되지 않음 이 특성은 XMLNSC 구문 분석기가 큐 메시지 메시지의 주석을 발견할 때 메시지 트리에 요소를 작성하는지 여부를 제어합니다. 선택란을 선택하면 주석에 따라 요소가 작성됩니다. 선택란을 선택 취소하면 주석이 무시되고 요소는 작성되지 않습니다.
처리 지시사항 보유 아니오 선택되지 않음 이 특성은 XMLNSC 구문 분석기가 큐 메시지에서 처리 지시사항을 발견할 때 메시지 트리에 요소를 작성하는지 여부를 제어합니다. 선택란을 선택하면 처리 지시사항에 따라 요소가 작성됩니다. 선택란을 선택 취소하면 처리 지시사항이 무시되고 요소는 작성되지 않습니다.
오파크 요소 아니오 공백 이 특성은 XMLNSC 구문 분석기에서 구문 분석할 수 없는 큐 메시지 의 요소 목록을 지정하는 데 사용됩니다. 오파크 구문 분석은 유효성 검증을 사용할 수 없는 경우(즉, 유효성 검증이 없음인 경우)에만 수행됩니다. 유효성 검증이 사용 가능하면 오파크 요소에 지정된 입력 항목이 무시됩니다.
[표 7] 노드의 고급 특성
특성 M 기본값 설명
트랜잭션 모드 아니오 YES 이 특성은 수신되는 메시지가 동기점 아래에서 수신되는지 여부를 제어합니다.
이 메시지를 처리하는 방법의 트랜잭션 특성을 정의하려면 목록에서 트랜잭션 모드의 값을 선택하십시오.
  • 자동를 선택하면 큐 메시지 가 지속적으로 표시된 경우 동기점 아래에 수신됩니다. 메시지가 지속적으로 표시되지 않으면 이는 동기점 하에서 수신되지 않습니다. 입력 메시지의 지속성 또는 비지속성은 메시지 플로우의 출력 노드 또는 다른 후속 노드가 명시적으로 트랜잭션성을 대체하지 않는 한 출력 노드가 나중에 전파하는 파생된 메시지의 트랜잭션성을 결정합니다.
  • 예를 선택하면 큐 메시지 가 동기점 아래에 수신됩니다. 메시지 플로우의 출력 노드 또는 다른 후속 노드가 명시적으로 트랜잭션성을 대체하지 않는 한, 나중에 메시지 플로우의 동일한 인스턴스에서 출력 노드에 의해 전파되는 파생된 메시지는 트랜잭션적으로 전송됩니다.
  • 아니오를 선택하면 큐 메시지 가 동기점에서 수신되지 않습니다. 메시지 플로우의 출력 노드 또는 다른 후속 노드가 메시지가 반드시 동기점 하에 놓여야 함을 지정하지 않는 한, 나중에 메시지 플로우의 동일한 인스턴스에서 출력 노드에 의해 전파되는 파생된 메시지는 비트랜잭션적으로 전송됩니다.

자세한 정보는 트랜잭션에 대한 MQ 노드 구성의 내용을 참조하십시오.
생성 모드 아니오 메시지 이 특성은 입력 트리에서 메시지의 어느 부분이 복사되는지를 제어합니다.
MQGet 노드에서 생성되는 출력 메시지의 컴포넌트 및 입력 메시지에서 가져온 컴포넌트를 정의하려면 목록에서 생성 모드 값을 선택하십시오.
  • 없음을 선택하면 입력 트리의 메시지의 모든 컴포넌트가 변경되지 않은 상태로 전파됩니다.
  • 메시지(기본값)를 선택하는 경우 노드에서 새 메시지 컴포넌트가 작성되지만 입력 트리에서 로컬 환경, 환경, 예외 목록 컴포넌트는 변경되지 않은 상태로 전파됩니다.
  • LocalEnvironment를 선택하는 경우에는 노드에서 새 로컬 환경 컴포넌트가 작성되지만 입력 트리에서 메시지, 환경, 예외 목록 컴포넌트가 변경되지 않은 상태로 전파됩니다.
  • 메시지 및 LocalEnvironment를 선택하는 경우에는 노드에서 새 메시지와 로컬 환경 컴포넌트가 작성되지만 입력 트리에서 환경과 예외 목록 컴포넌트가 변경되지 않은 상태로 전파됩니다.
메시지 복사 아니오 NONE 이 특성은 입력 트리에서 메시지의 어느 부분이 복사되는지를 제어합니다.
생성 모드 를 메시지 또는 메시지 및 로컬 환경로 설정한 경우, 목록에서 메시지 복사 에 대한 값을 선택하여 MQGet 노드에서 생성되는 메시지 파트와 입력 메시지에서 가져온 파트를 정의하십시오.
  • 없음(기본값)을 선택하면 입력 트리의 입력 메시지의 어떤 부분도 전파되지 않습니다.
  • 헤더 복사를 선택하는 경우에는 입력 트리에서 입력 메시지의 헤더가 출력 메시지에 복사됩니다.
  • 전체 메시지 복사를 선택하는 경우에는 입력 트리의 전체 입력 메시지가 출력 메시지에 복사됩니다.
로컬 환경 복사 아니오 전체 로컬 환경 복사 이 특성은 로컬 환경이 출력 메시지에 복사되는 방법을 제어합니다.
생성 모드 를 로컬 환경 또는 메시지 및 로컬 환경로 설정한 경우, 목록에서 로컬 환경 복사 에 대한 값을 선택하여 MQGet 노드에서 생성되는 로컬 환경 파트와 입력 메시지에서 가져온 파트를 정의하십시오.
  • 전체 LocalEnvironment 복사(기본값)를 선택하는 경우 메시지 플로우의 각 노드에서 로컬 환경의 새 사본이 트리에 작성되고 선행 노드의 로컬 환경 컨텐츠로 채워집니다. 따라서 노드가 로컬 환경을 변경하는 경우 업스트림 노드에 자체 사본이 있으므로 업스트림 노드에 해당 변경사항이 표시되지 않습니다. 순서 노드를 사용하거나 계산 노드에서 전파하는 명령을 사용하는 경우 이 동작이 문제가 될 수 있습니다. 입력 메시지에 정의된 전체 로컬 환경이 출력 메시지에 복사됩니다.
  • 없음을 선택하는 경우에는 각 노드가 로컬 환경의 자체 사본을 생성하지 않고 선행 노드에서 전달된 로컬 환경을 사용합니다. 따라서 노드가 로컬 환경을 변경하는 경우 업스트림 노드에 해당 변경사항이 표시됩니다.
대기 간격(ms) 예 1000 큐 메시지 가 메시지 큐에서 확보될 때까지 대기하는 최대 시간 (밀리초) 입니다.

MQGET 호출로부터 메시지가 수신되기를 기다리는 기간(밀리초)을 지정하기 위해 대기 간격(밀리초) 특성을 제공하십시오. 0을 선택하면 대기 간격을 사용할 수 없으며 메시지의 대기 시간이 없습니다. 대기 간격(ms) 값은 음수일 수 없습니다. 값을 제공하지 않으면 1000밀리세컨드의 기본값이 사용됩니다.
최소 메시지 버퍼 크기(KB) 예 4 가져오기 버퍼의 최소 크기(KB)입니다. 이 특성의 최소값은 1입니다.

이 특성의 값을 제공하여 MQGET 호출의 초기 버퍼 크기를 지정합니다. 버퍼는 자동으로 확장되어 모든 크기의 메시지를 승인하지만 메시지가 클 가능성이 높은 경우에는 적당한 값을 지정하여 버퍼의 크기 통합 빈도를 줄이십시오. 값을 제공하지 않는 경우 버퍼 크기는 4KB입니다.
[표 8] 노드의 요청 특성
특성 M 기본값 설명
입력 MQMD 위치 아니오 InputRoot.MQMD MQGET에 사용될 MQMD를 찾을 수 있는 입력 메시지 어셈블리에서의 위치. 기본 위치는 InputRoot.MQMD입니다.
입력 MQ 매개변수 위치 아니오 InputLocalEnvironment.MQ.가져오기 입력 메시지 어셈블리에서 WebSphere MQ 매개변수 (예: 초기 버퍼 크기 및 MQGMO 대체) 를 찾을 수 있는 위치입니다. 기본 위치는 InputLocalEnvironment.MQ.GET입니다.
상관 ID별 가져오기 아니오 선택되지 않음 이 선택란을 선택하면 지정된 상관 ID가 있는 메시지만이 검색됩니다.

상관 ID로 얻기를 선택하면CorrelId검색할 메시지의 필드는 다음과 일치해야 합니다.CorrelId필드를 입력 MQMD 위치로 설정하십시오. 기본적으로, 이 선택란의 선택이 해제됩니다.

를 설정하기CorrelIdMQCI_NONE에 대한 필드는 상관 ID로 얻기를 선택하지 않는 것과 동일한 효과를 갖습니다.
메시지 ID별 가져오기 아니오 선택되지 않음 이 선택란을 선택하면 지정된 ID가 있는 메시지만이 검색됩니다.

메시지 ID로 얻기를 선택하면MsgId검색할 메시지의 필드는 다음과 일치해야 합니다.MsgId필드를 입력 MQMD 위치로 설정하십시오. 기본적으로, 이 선택란의 선택이 해제됩니다.
전체 입력 MQMD 필드 사용 아니오 선택되지 않음 모든 입력 MQMD 필드 사용을 선택하는 경우, 입력 MQMD 위치의 모든 MQMD 필드가 메시지를 검색하는 데 사용됩니다. MQMD 비트스트림이 입력 MQMD 위치에 있는 경우 비트스트림의 모든 필드가 사용됩니다. 검색될 메시지의 MQMD가 이러한 필드와 일치하는지 확인하십시오. 기본적으로, 이 선택란의 선택이 해제됩니다.

입력 MQMD를 제공하지 않으면 기본 MQMD가 사용됩니다.

입력 MQMD를 제공하지 않으면 다음과 같이 수정한 후에 기본 MQMD가 사용됩니다.
  • 특성 모든 입력 MQMD 필드 사용을 설정하는 경우, 제공된 모든 MQMD 필드는 입력 MQMD에서 기본값 MQMD로 복사됩니다.
  • 특성 모든 입력 MQMD 필드 사용을 설정하지 않고, 특성 메시지 ID로 가져오기 또는 상관 ID로 가져오기가 선택된 경우, 각 ID는 입력 MQMD로부터 기본 MQMD로 복사됩니다.
MQGET 호출의 MQMD가 구성되는 방법에 대한 자세한 정보는 MQGet 노드가 WebSphere MQ MQGet API 호출을 구현하는 방법의 내용을 참조하십시오.
찾아보기 전용 아니오 선택되지 않음 이 특성은 메시지를 읽을 때 메시지가 큐에서 제거되는지 여부를 제어합니다. 이 선택란이 선택된 경우 메시지를 읽어도 큐에서 제거되지 않습니다. 메시지를 읽을 때 메시지가 큐에 보존되어야 함을 지정하려면 Browse only를 선택하십시오.
찾아보기 커서 재설정 아니오 선택되지 않음 Browse only를 선택한 경우에만 이 특성을 설정할 수 있습니다. 찾아보기 커서 재설정을 선택하는 경우 노드는 MQ 큐의 시작부터 찾아봅니다(즉, MQGMO_BROWSE_FIRST MQ get 옵션이 지정됨).

이 특성을 선택하지 않으면 노드는 MQ 큐에서 현재 커서 위치로부터 찾아봅니다(즉, MQGMO_BROWSE_NEXT MQ get 옵션이 선택됨).
[표 9] 노드의 결과 특성
특성 M 기본값 설명
출력 데이터 위치 아니오 OutputRoot 이 특성은 출력 데이터가 배치되는 위치를 지정합니다. 이 필드를 공백으로 두면 OutputRoot가 기본값으로 사용됩니다. 큐 메시지 의 비트 문자열에서 구문 분석된 요소가 저장되는 출력 메시지 트리에 시작 위치를 입력하십시오. 이 위치에 있는 모든 요소가 삭제되고 기본 동작은 입력 트리 메시지를 큐 메시지로 바꾸는 것입니다.

입력 트리에서 전파되는 응답을 메시지에 삽입하기 위해 메시지 트리에 노드를 작성하기 위한 새 필드 참조를 포함하여 올바른 ESQL 필드 참조(이 참조는 표현식을 포함할 수 있음)를 입력할 수 있습니다. 예제:OutputRoot.XMLNS.ABC.DEF및Environment.GotReply는 유효한 필드 참조이다. 자세한 정보는 MQGet 노드가 WebSphere MQ MQGet API 호출을 구현하는 방법의 내용을 참조하십시오.

큐 메시지 비트 문자열이 구문 분석되어 메시지 트리의 컨텐츠를 작성할 때 노드의 입력 메시지 구문 분석 특성으로 지정한 메시지 특성이 사용됩니다.
결과 데이터 위치 아니오 ResultRoot 이 특성은 사용할 서브트리 ( 큐 메시지의) 를 지정합니다. 이 필드를 공백으로 두면 결과 루트 가 기본값으로 사용되고 전체 큐 메시지 가 사용됩니다. 예를 들어, ResultRoot.MQMD.ReplyToQ가 지정되면 해당 서브트리만이 사용됩니다.

출력 메시지에 있는 큐 메시지 의 서브트리를 제어하려면 이 특성을 설정하십시오. 예를 들어, 큐 메시지의 MQMD만 원하는 경우에는 다음을 사용하십시오.ResultRoot.MQMD이 서브트리는 출력 데이터 위치에서 지정한 위치에 배치됩니다.
출력 MQ 매개변수 위치 아니오 OutputLocalEnvironment.MQ.가져오기 이 특성은 출력 WebSphere MQ 매개변수가 있는 위치를 지정합니다. 이 필드를 공백으로 두면, OutputLocalEnvironment.MQ.GET이 기본값으로 사용됩니다. 업데이트된 값이 다운스트림 노드에 표시되도록 하려면 LocalEnvironment를 포함하도록 생성 모드를 설정하십시오. 기본 위치는 OutputLocalEnvironment.MQ.GET입니다.

이 특성을 설정하여 CC (완료 코드), RC (이유 코드), 찾아보기 표시기 및 기타 WebSphere MQ 매개변수 (예: MQGET 호출에서 사용되는 MQMD) 가 출력 트리에 배치되는 위치를 제어하십시오.
경고 데이터 위치 아니오 OutputRoot 이 특성은 MQGET이 경고 코드를 리턴하는 경우 출력 데이터가 배치되는 위치를 지정합니다. 이 필드를 공백으로 두면 OutputRoot가 기본값으로 사용됩니다.

MQGET 호출이 경고 코드를 리턴할 때 큐 메시지 가 배치되는 위치를 제어하려면 이 특성을 설정하십시오. 올바른 ESQL 필드 참조를 입력할 수 있습니다(출력 데이터 위치 특성의 설명을 참조). 이 위치에 놓이는 데이터는 항상 BLOB 요소로 본문을 가지고 있는 전체 결과 트리입니다. 결과 데이터 위치는 경고 데이터에 사용되지 않습니다.
출력 메시지 어셈블리에 메시지 컨텐츠 포함 아니오 선택됨 이 특성은 출력 메시지 어셈블리에 결과나 경고 데이터가 필요하지 않음을 지정합니다. 이 선택란을 선택하는 경우 노드는 해당 컨텐츠를 완전히 읽거나 구문 분석하지 않고 큐에서 메시지를 얻거나 찾습니다.

출력 메시지 어셈블리에 메시지 컨텐츠 포함을 선택하면, 메시지 컨텐츠는 출력 트리에 포함된다고 보장되지 않습니다. 이 포함은 모드 생성 특성 등과 같은 다른 노드 특성에 의존하기 때문입니다.

출력 메시지 어셈블리에 결과나 경고 데이터가 필요하지 않음을 지정하려면 출력 메시지 어셈블리에 메시지 컨텐츠 포함을 지우십시오. 이 조치는 컨텐츠를 읽거나 구문 분석하지 않고 큐에서 메시지를 가져오거나 찾습니다.

MQGET 호출의 결과가 처리되는 방법을 판별하려면 결과 특성을 설정하십시오.

표 10. 노드의 유효성 검증 특성
특성 M 기본값 설명
유효성 검증 아니오 NONE 이 특성은 유효성 검증의 수행 여부를 제어합니다. 올바른 값: 없음, 컨텐츠, 컨텐츠 및 값, 상속.
실패 조치 아니오 예외 이 특성은 유효성 검증에 실패한 경우 발생하는 상황을 제어합니다. 유효성 검증을 컨텐츠 또는 컨텐츠 및 값으로 설정한 경우에만 이 특성을 설정할 수 있습니다. 올바른 값은 사용자 추적, 로컬 오류 로그, 예외, 예외 목록입니다.

이러한 특성에 대한 전체 설명은 유효성 검증 특성의 내용을 참조하십시오.

표 11. 노드의 정책 특성
특성 M 기본값 설명
정책 URL 아니오   이 MQ 노드에 대해 해당 정책에 정의된 연결 세부사항을 사용하려면 이 필드의 값을 MQEndpoint 정책의 위치로 설정하십시오.

MQEndpoint 정책이 지정되면 정책에 설정된 특성 값이 런타임에 사용됩니다. 정책에서 설정되는 특성이 MQ 연결 탭에서 설정되는 대응하는 특성을 대체합니다. MQEndpoint 정책이 지정되지 않은 경우, MQ 연결 탭에 설정된 특성 값이 사용됩니다.

MQEndpoint 정책이 지정되지 않고 MQ 연결 탭의 연결 특성이 지정된 큐 관리자가 없는 로컬 큐 매니저 (기본 상태) 로 설정된 경우, MQ 노드는 통합 노드에 지정된 큐 관리자에 대한 연결 세부사항을 사용합니다. 통합 노드에 대해 큐 관리자가 지정되지 않은 경우 메시지 플로우가 배치되지 않습니다.

MQEndpoint 정책이 지정된 경우, MQ 연결 탭에 설정된 모든 동등한 특성은 런타임 시 무시됩니다. MQ 노드에 적용할 수 있는 운영 정책에 대한 자세한 정보는 MQEndpoint 정책의 내용을 참조하십시오.

표 12. 노드의 모니터링 특성
특성 M 기본값 설명
이벤트 아니오   노드에 대해 정의한 이벤트가 이 탭에 표시됩니다. 기본적으로, 메시지 플로우의 어떤 노드에도 모니터링 이벤트가 정의되지 않습니다. 추가, 편집및 삭제 를 사용하여 노드의 모니터링 이벤트를 작성, 변경 또는 삭제하십시오. 자세한 내용은 모니터링 특성을 사용하여 모니터링 이벤트 소스 구성 의 내용을 참조하십시오.

사용 선택란을 선택하거나 선택 취소해서 여기에 표시되는 이벤트를 사용 및 사용 안함으로 설정할 수 있습니다.

구성 가능한 특성

다음 표는 구성 가능한 노드 특성을 설명합니다(mqsiapplybaroverride 명령을 사용하여 배치용 BAR 파일에 메시지 플로우를 추가할 때 특성 값을 변경할 수 있음). 표는 메시지 플로우 노드 특성을 mqsiapplybaroverride 명령의 대응하는 특성에 맵핑합니다.

구성 가능 특성에 대한 자세한 정보는 BAR 파일의 구성 가능한 특성의 내용을 참조하십시오.

구성 가능 특성 표

표 13. mqsiapplybaroverride 명령을 사용하여 구성할 수 있는 노드 특성의 목록
특성 mqsiapplybaroverride 명령 특성
큐 이름 queueName
연결 유형 연결
목적지 큐 관리자 이름 destinationQueueManagerName
큐 관리자 호스트 이름 queueManagerHostname
리스너 포트 번호 listenerPortNumber
채널 이름 channelName
보안 ID securityIdentity
SSL 사용 useSSL
SSL 피어 이름 SSLPeerName
SSL 암호 스펙 SSLCipherSpec
유효성 검증 validateMaster
정책 URL policyUrl

가동 정책 특성

MQEndpoint 정책을 작성하고 MQ 노드에 첨부하여 런타임 시 노드의 동작을 제어할 수 있습니다. 다음 표는 메시지 플로우 노드의 조작 특성을 노드 정책 문서의 대응하는 특성에 맵핑합니다. 조작 특성은 조작 정책을 사용하여 런타임 시에 값을 제어할 수 있는 특성입니다.

CCDT 파일을 사용하도록 정책 문서의 ccdt 특성을 설정하는 경우 CCDT 파일 경로를 지정하려면 mqsichangeproperties 도 실행해야 합니다. 다음 양식을 사용하십시오. 여기에서 file_path는 CCDT 파일에 대한 경로를 나타냅니다.
mqsichangeproperties IBNODE -o BrokerRegistry -n mqCCDT -v file_path

운영 정책 및 메시지 플로우에서 정책을 사용하는 방법에 대한 자세한 정보는 운영 정책 및 MQEndpoint 정책의 내용을 참조하십시오.

조작 특성 표

표 14. MQEndpoint 정책을 사용하여 런타임 시 제어할 수 있는 노드 특성 목록
특성 정책 문서 특성
연결 유형 연결
목적지 큐 관리자 이름 destinationQueueManagerName
큐 관리자 호스트 이름 queueManagerHostname
리스너 포트 번호 listenerPortNumber
채널 이름 channelName
보안 ID securityIdentity
SSL 사용 useSSL
SSL 피어 이름 SSLPeerName
SSL 암호 스펙 SSLCipherSpec