MQOutput 노드

이 주제는 다음 절을 포함합니다.

목적

WebSphere MQ Enterprise Transport를 사용하여 브로커에 연결하거나 MQI 및 AMI 응용프로그램 프로그래밍 인터페이스를 사용하는 클라이언트로 메시지를 송신하려면 MQOutput 노드를 사용하십시오.

MQOutput 노드는 출력 메시지를 메시지 플로우에서 WebSphere MQ 큐로 전달합니다. 노드는 MQPUT을 사용하여 목적지 큐 또는 지정한 큐에 메시지를 넣습니다.

적절한 경우 큐를 WebSphere MQ 클러스터 큐 또는 공유 큐로 정의할 수 있습니다. WebSphere MQ 클러스터 큐를 사용하는 경우, 큐 관리자 이름을 비워 두십시오.

브로커 큐 관리자에서 액세스할 수 있는 임의의 큐 관리자에 정의된 특정 WebSphere MQ 큐에 메시지를 넣거나 메시지와 연관된 LocalEnvironment(DestinationList라고 알려져 있음)에서 식별되는 목적지에 메시지를 넣도록 MQOutput 노드를 구성할 수 있습니다.

적절한 MQPUT 옵션을 설정하여 메시지를 송신하는 방법을 제어하는 다른 등록 정보를 설정할 수 있습니다. 예를 들면, 트랜잭션 제어하에 메시지를 처리하도록 요청할 수 있습니다. WebSphere MQ가 필요한 경우 큐 관리자에서 메시지를 세그먼트로 구분하도록 지정할 수 있습니다.

서브플로우로 사용할 메시지 플로우를 작성하는 경우 표준 출력 노드를 사용할 수 없으면 Output 노드 인스턴스를 사용하여 메시지를 전달할 서브플로우의 out 터미널을 작성해야 합니다.

메시지 플로우가 메시지를 WebSphere MQ 큐로 송신하지 않게 하려면, 지원되는 다른 출력 노드를 선택할 수 있습니다.

MQOutput 노드는 Workbench에서 다음 아이콘으로 표시됩니다.

MQOutput 노드 아이콘

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

이 노드를 사용하는 방법을 보려면 다음 샘플을 참조하십시오.

이 노드를 사용하는 방법에 대한 예의 경우, 규칙적으로 주가 갱신을 publish하는 publish 응용프로그램을 작성했다고 가정합니다. 응용프로그램이 메시지를 MQInput 노드를 통해 브로커로 송신하고 메시지 플로우에서 Publication 노드를 통해 다중 subscriber가 publication을 사용할 수 있습니다. Compute 노드를 구성하여 하나의 특정 주식이 변경될 때마다 새 출력 메시지를 작성하고 이를 MQOutput 노드에 알려 이 주식에 대한 각각의 가격 변동을 기록합니다.

MQOutput 노드 구성

MQOutput 노드 인스턴스를 메시지 플로우에 넣었으면 이 노드를 구성할 수 있습니다. 편집기 보기에서 이 노드를 마우스 오른쪽 단추로 누른 후 등록 정보를 누르십시오. 노드의 기본 등록 정보가 표시됩니다.

값을 입력해야 하는 모든 필수 등록 정보(정의된 디폴트 값이 없는 등록 정보)는 등록 정보 대화 상자에서 별표(*)로 표시됩니다.

다음과 같이 MQOutput 노드를 구성하십시오.

  1. 출력 메시지를 이 노드에서 정의한 단일 목적지 큐에 송신하려는 경우 메시지 플로우가 메시지를 송신하는 큐 이름을 큐 이름에 입력하십시오. 큐 관리자의 이름을 이 큐가 정의된 큐 관리자 이름에 입력하십시오. 고급 등록 정보 목적지 모드(아래 설명됨)를 큐 이름으로 설정한 경우 이러한 등록 정보를 설정해야 합니다. 목적지 모드를 다른 값으로 설정하면 이러한 등록 정보는 무시됩니다.
  2. 등록 정보 대화 상자 네비게이터에서 고급을 선택하십시오. 이 등록 정보는 메시지의 트랜잭션 제어와 메시지를 큐에 넣는 방법을 정의합니다. 이러한 등록 정보의 대부분은 MQPUT 호출 시 옵션에 맵핑됩니다.
    • 드롭다운 목록에서 목적지 모드를 선택하십시오. 이 모드는 출력 메시지를 넣을 큐를 식별합니다.
      • 큐 이름. 메시지가 큐 이름 등록 정보에 이름 지정된 큐로 송신됩니다. 이 옵션을 선택할 경우, 큐 관리자 이름큐 이름(기본 탭에 있음)은 필수입니다. 디폴트 값입니다.
      • 리플라이-투 큐. 메시지가 MQMD의 ReplyToQ 필드에 이름 지정된 큐로 송신됩니다.
      • 목적지 목록. 메시지가 메시지와 연관된 LocalEnvironment(DestinationList라고 알려져 있음)에 이름 지정된 큐 목록으로 송신됩니다.
    • 메시지를 넣는 방법을 판별하려면 드롭다운 목록에서 트랜잭션 모드를 선택하십시오.
      • 자동(디폴트)을 선택하면, 메시지 트랜잭션성은 입력 노드에 지정된 방법으로 도출됩니다.
      • 를 선택하면 메시지가 트랜잭션 방식으로 넣어집니다.
      • 아니오를 선택하면 메시지가 비트랜잭션 방식으로 넣어집니다.
      자세한 정보는 통합 트랜잭션용으로 구성을 참조하십시오.
    • 메시지를 지속적으로 넣을 것인지 판별하려면 드롭다운 목록에서 지속 모드를 선택하십시오.
      • 자동(디폴트)을 선택할 경우, 지속 여부는 수신되는 메시지에 지정된 대로 설정됩니다.
      • 를 선택할 경우, 메시지는 지속적으로 넣어집니다.
      • 아니오를 선택할 경우, 메시지는 비지속적으로 넣어집니다.
      • 큐에 대해 정의된 대로를 선택하면 메시지 지속 여부는 WebSphere MQ 큐에 대해 정의된 대로 설정됩니다.
    • 이 메시지에 대해 새 메시지 ID를 생성하려면 새 메시지 ID 선택란을 선택하십시오. 이 ID는 MQI의 MQPMO 중 MQPMO_NEW_MSG_ID 옵션에 맵핑됩니다.

      새 ID를 생성하지 않으려면 선택란을 지우십시오. 등록 정보 대화 상자의 요청 패널에서 요청 선택란을 선택하면 새 메시지 ID가 계속 생성된다는 점에 유의하십시오.

      이 등록 정보가 맵핑되는 옵션에 대한 자세한 정보는 WebSphere MQ Application Programming Reference에 나와 있습니다.

    • 이 메시지에 대해 새 상관 ID를 생성하려면 새 상관 ID 선택란을 선택하십시오. 이 ID는 MQI의 MQPMO 중 MQPMO_NEW_CORREL_ID 옵션에 맵핑됩니다. 새 ID를 생성하지 않으려면 선택란을 지우십시오.

      이 등록 정보가 맵핑되는 옵션에 대한 자세한 정보는 WebSphere MQ Application Programming Reference에 나와 있습니다.

    • WebSphere MQ가 큐 관리자 내에서 메시지를 세그먼트화하려면 세그먼트화 허용 선택란을 선택하십시오. 세그먼트화가 발생하게 하려면 MQMD의 MsgFlags 필드에 MQMF_SEGMENTATION_ALLOWED도 설정해야 합니다. 세그먼트화를 수행하지 않으려면 이 선택란을 지우십시오.

      이 등록 정보가 맵핑되는 옵션에 대한 자세한 정보는 WebSphere MQ Application Programming Reference에 나와 있습니다.

    • 원본 컨텍스트를 핸들링하는 방법을 표시하려면 메시지 컨텍스트를 선택하십시오. 다음 옵션 중 하나를 선택하십시오.
      • 모두 전달(MQI의 MQPMO 중 MQPMO_PASS_ALL_CONTEXT 옵션에 맵핑)
      • ID 전달(MQI의 MQPMO 중 MQPMO_PASS_IDENTITY_CONTEXT 옵션에 맵핑)
      • 모두 설정(MQI의 MQPMO 중 MQPMO_SET_ALL_CONTEXT 옵션에 맵핑)
      • ID 설정(MQI의 MQPMO 중 MQPMO_SET_IDENTITY_CONTEXT 옵션에 맵핑)
      • 디폴트(MQI의 MQPMO 중 MQPMO_DEFAULT_CONTEXT 옵션에 맵핑)
      • 없음(MQI의 MQPMO 중 MQPMO_NO_CONTEXT 옵션에 맵핑)

      이 등록 정보가 맵핑되는 옵션에 대한 자세한 정보는 WebSphere MQ Application Programming Reference에 나와 있습니다.

    • MQI의 열기 옵션(MQOO)에 MQOO_ALTERNATE_USER_AUTHORITY 옵션을 설정하려면 대체 사용자 권한 선택란을 선택하십시오. 이 선택란을 선택하면, 출력을 위해 큐가 열렸을 때 이 옵션이 지정됩니다. 대체 사용자 정보는 메시지의 컨텍스트 정보에서 검색됩니다. 대체 사용자 권한을 지정하지 않으려면 선택란을 지우십시오. 선택란을 지우면, 메시지를 넣을 때 브로커 서비스 사용자 ID가 사용됩니다.
  3. 등록 정보 대화 상자 네비게이터에서 요청을 선택한 후, 등록 정보를 설정하여 생성된 각 출력 메시지의 특성을 정의하십시오.
    • 요청 선택란을 선택하여 MQMD의 각 출력 메시지를 요청 메시지(MQMT_REQUEST)로 표시하고 메시지 ID 필드를 지워(MQMI_NONE로 설정) WebSphere MQ가 새 ID를 생성하도록 하십시오. 각 출력 메시지가 요청 메시지로 표시되어 있지 않다는 것을 표시하려면 선택란을 지우십시오. 리플라이-투 큐에서 목적지 모드를 선택한 경우에는 이 선택란을 선택할 수 없습니다.

      등록 정보 대화 상자 네비게이터의 고급 패널에서 새 메시지 ID 선택란을 선택하지 않아도 새 메시지 ID가 생성된다는 점에 유의하십시오.

    • 리플라이-투 큐 관리자에 큐 관리자 이름을 입력하십시오. 이 이름은 리플라이-투 큐 관리자로서 각 출력 메시지의 MQMD에 삽입됩니다.
    • 리플라이-투 큐에 큐 이름을 입력하십시오. 이 이름은 리플라이-투 큐로서 각 출력 메시지의 MQMD에 삽입됩니다.
  4. 메시지 세트로부터 생성된 사전에 대한 메시지 본문의 유효성을 검증하기 위한 MRM 구문 분석기가 필요하면, 등록 정보 대화 상자 네비게이터에서 유효성 검증을 선택하십시오. (메시지가 노드의 failure 터미널로 전달될 경우에는 유효성이 검증되지 않습니다.)

    자세한 정보는 메시지 유효성 검증MRM 도메인에서 메시지의 유효성 검증 등록 정보를 참조하십시오.

  5. 간단한 설명, 자세한 설명 또는 둘 다를 입력하려면, 등록 정보 대화 상자 네비게이터에서 설명을 선택하십시오.
  6. 적용을 누르면 등록 정보 대화 상자를 닫지 않고도 MQOutput 노드를 변경할 수 있습니다. 확인을 눌러 변경사항을 적용하고 등록 정보 대화 상자를 닫으십시오.

    대화 상자를 닫고 등록 정보에서 작성한 모든 변경을 제거하려면 취소를 누르십시오.

터미널 연결

in 터미널을 바인드된 아웃바운드 메시지가 라우트되는 노드에 연결하십시오.

메시지에 대한 추가 처리, 오류 처리 또는 메시지를 추가 목적지에 송신하려면 이 노드의 out 또는 failure 터미널을 이 메시지 플로우의 다른 노드에 연결하십시오.

이 출력 터미널 중 하나를 메시지 플로우의 다른 노드에 연결할 경우, 이 노드가 메시지를 넣은 각 목적지에 대해 다음과 같은 정보로 메시지와 연관된 LocalEnvironment가 향상됩니다.

  • 큐 이름
  • 큐 관리자 이름
  • 메시지 응답 ID(메시지 ID와 동일한 값으로 설정)
  • 메시지 ID(MQMD에서 발생)
  • 상관 ID(MQMD에서 발생)

이 값은 로컬 환경 트리 구조 내의 WrittenDestination에 기록됩니다.

터미널을 연결하지 않은 경우 로컬 환경 트리는 변경되지 않습니다.

메시지 플로우에서 집계를 사용할 경우에는 out 터미널을 사용해야 합니다.

통합 트랜잭션용으로 구성

MQOutput 노드를 정의할 경우, 트랜잭션 모드 등록 정보에 대해 선택한 옵션은 동기점 아래에 기록됩니다.

  • 일 경우, 동기점 아래(즉, WebSphere MQ 작업 단위 내)에 메시지가 기록됩니다.
  • 자동(디폴트)일 경우, 수신되는 입력 메시지가 지속으로 표시되어 있으면 메시지가 동기점 아래에 기록됩니다.
  • 아니오일 경우, 메시지가 동기점 아래에 기록되지 않습니다.

MQOutput 노드의 다른 등록 정보인 지속 모드는 출력 큐에 메시지를 넣을 때 출력 메시지를 지속으로 표시할 것인지 여부를 정의합니다.

  • 일 경우, 메시지는 지속으로 표시됩니다.
  • 자동(디폴트)일 경우, 메시지 지속은 MQMD(WebSphere MQ 메시지 설명자)에 설정된 대로 수신된 메시지의 등록 정보에서 판별됩니다.
  • 아니오일 경우, 메시지는 지속으로 표시되지 않습니다.
  • 큐에 대해 정의된 대로이면, 메시지 지속 여부는 MQMD에 MQPER_PERSISTENCE_AS_Q_DEF 옵션을 지정하여 MQOutput 노드가 WebSphere MQ 큐에 대해 정의된 대로 설정합니다.

터미널 및 등록 정보

다음 표에는 MQOutput 노드 터미널이 설명되어 있습니다.

터미널 설명
In 노드가 처리할 메시지를 승인하는 입력 터미널.
Failure 메시지를 출력 큐에 넣을 때 실패가 감지될 경우 메시지가 라우트될 출력 터미널.
Out 출력 큐에 메시지를 넣었을 경우와 이 메시지 프로세스 내에서 추가 처리가 필요한 경우 메시지가 라우트될 출력 터미널.

다음 표에는 노드 등록 정보가 설명되어 있습니다. 앞에 M이 표시된 열은 등록 정보가 필수임을 나타내며(디폴트가 정의되지 않았을 때 값을 입력해야 하는 경우 등록 정보 대화 상자에 별표(*)로 표시됨) 앞에 C가 표시된 열은 등록 정보가 구성 가능함을 나타냅니다(메시지 플로우를 Bar 파일에 추가하여 전개할 때 값을 변경할 수 있음).

다음 표에는 MQOutput 노드 기본 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
큐 관리자 이름 아니오   큐 이름에 지정된 출력 큐가 정의되어 있는 WebSphere MQ 큐 관리자의 이름.
큐 이름 아니오   이 노드가 MQPUT을 사용하여 메시지를 넣을 WebSphere MQ 출력 큐 이름.

다음 표에는 MQOutput 노드 고급 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
목적지 모드 아니오 큐 이름 출력 메시지를 송신할 큐. 올바른 값은 목적지 목록, 리플라이-투 큐큐 이름입니다.
트랜잭션 모드 아니오 자동 메시지를 트랜잭션 방식으로 넣는지 여부. 올바른 값은 자동, 아니오입니다.
지속 모드 아니오 자동 메시지를 지속적으로 넣는지 여부. 올바른 값은 자동, , 아니오큐에 대해 정의된 대로입니다.
새 메시지 ID 아니오 지우기 WebSphere MQ가 MQMD의 MsgId 필드의 컨텐츠를 바꾸기 위해 새 메시지 ID를 생성하는지 여부. 이 선택란을 선택하면 이 조치가 수행됩니다.
새 상관 ID 아니오 지우기 WebSphere MQ가 MQMD의 Correlld 필드의 컨텐츠를 바꾸기 위해 새 상관 ID를 생성하는지 여부. 이 선택란을 선택하면 이 조치가 수행됩니다.
세그먼트화 허용 아니오 지우기 적절한 경우, WebSphere MQ가 큐 관리자에서 메시지를 세그먼트로 구분. 이 선택란을 선택하면 이 조치가 수행됩니다.
메시지 컨텍스트 아니오 모두 전달 원본 컨텍스트 핸들링 방법. 올바른 값은 모두 전달, ID 전달, 모두 설정, ID 설정디폴트입니다.
대체 사용자 권한 아니오 지우기 출력 메시지를 넣을 때 대체 권한을 사용할지 여부. 이 선택란을 선택하면 이 조치가 수행됩니다.

다음 표에는 MQOutput 노드 요청 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
요청 아니오 지우기 각 출력 메시지를 요청 메시지로 생성할지 여부. 이 선택란을 선택하면 이 조치가 수행됩니다.
리플라이-투 큐 관리자 아니오   리플라이-투 큐에 지정된 출력 큐가 정의되어 있는 WebSphere MQ 큐 관리자의 이름.
리플라이-투 큐 아니오   이 요청에 대한 응답을 넣기 위한 WebSphere MQ 큐의 이름.

다음 표에는 MQOutput 노드의 유효성 검증 등록 정보가 설명되어 있습니다.

이 등록 정보에 대한 자세한 설명은 MRM 도메인에서 메시지의 유효성 검증 등록 정보를 참조하십시오.

등록 정보 M C 디폴트 설명
유효성 검증 상속 유효성 검증이 발생하는지의 여부. 올바른 값은 없음, 컨텐츠 및 값, 컨텐츠상속입니다.
실패 조치 아니오 예외 유효성 검증에 실패한 경우의 조치. 유효성 검증컨텐츠 또는 컨텐츠 및 값으로 설정한 경우에만 이 등록 정보를 설정할 수 있습니다. 올바른 값은 사용자 추적, 로컬 오류 로그, 예외예외 목록입니다.
모든 값 제한조건 포함 아니오 선택 이 등록 정보는 편집할 수 없습니다. 선택될 선택란에 표시되는 디폴트 조치는 컨텐츠 및 값 유효성 검증 내에 기본 값 제한조건 점검이 포함되어 있는 것입니다.
수정사항 아니오 없음 이 등록 정보는 편집할 수 없습니다.

다음 표에는 MQOutput 노드 설명 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
간단한 설명 아니오 아니오   노드에 대한 간략한 설명.
자세한 설명 아니오 아니오   메시지 플로우에서 노드의 목적을 설명하는 텍스트.
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
ac04570_