JMSInput 노드

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

목적

JMS 목적지에서 메시지를 수신하려면 JMSInput 노드를 사용하십시오. JMS 목적지에는 JMS 제공자와의 연결을 통해 액세스합니다. JMSInput 노드는 JMS 메시지 이용자 역할을 하며 JMS(Java Message Service) 스펙, 버전 1.1에 정의된 6개의 메시지 유형 모두를 수신할 수 있습니다. 메시지는 JMS 스펙에 설명된 메소드 호출을 사용하여 수신합니다.

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

JMSInput 노드 아이콘

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

JMS Nodes 샘플 샘플에는 JMSInput 노드가 사용되는 메시지 플로우가 있습니다. JMSInput 노드를 사용하는 방법에 대한 예는 이 샘플을 참조하십시오.

JMSInput 노드는 JMS 메시지 트리와 함께 메시지를 수신하고 전달합니다. JMS 메시지 수신 방법을 제어하는 JMSInput 노드의 등록 정보를 설정할 수 있습니다.

JMSInput 노드는 다음 메시지 도메인에 있는 메시지를 핸들링합니다.

  • BLOB
  • XML
  • XMLNS
  • XMLNSC
  • MRM
  • JMSMap
  • JMSStream
  • MIME
  • IDOC

연결에서 JMS 제공자까지 수신되는 메시지를 핸들링하는 메시지 플로우는 항상 JMSInput 노드에서 시작해야 합니다. JMSInput 노드로 시작하는 메시지 플로우에 출력 노드를 포함시킬 경우, (사용자 정의 출력 노드를 비롯하여) 지원되는 모든 출력 노드를 사용할 수 있습니다. JMSOutput 노드는 포함할 필요가 없습니다. 그러나 JMSOutput 노드를 포함시키지 않으면 JMSMQTransform 노드를 포함시켜서 출력 노드가 예상하는 형식으로 메시지를 변환해야 합니다.

JMS 메시지를 전달하고 서브플로우로 사용할 메시지 플로우를 작성하는 경우, 표준 입력 노드를 사용할 수 없기 때문에 서브플로우에 대한 In 터미널을 작성하기 위해 첫 번째 노드로서 JMSInput 노드 인스턴스를 사용해야 합니다.

제한사항: 현재 JMSInput 노드를 사용하여 Publication 토픽을 수신할 경우 제한이 있습니다. 노드는 중복 Publication의 수신을 방지하기 위해 내부적으로 메시지 플로우 등록 정보 추가 인스턴스를 0으로 제한합니다.

JMS 노드가 JMS 제공자 클라이언트를 사용할 수 있도록 만들기

분산 플랫폼의 경우, JMS 제공자 클라이언트의 모든 고유 라이브러리와 java .jar 파일을 브로커 공유 클래스 디렉토리로 복사하십시오. 예를 들면, Windows의 경우 C:\Documents and Settings\All Users\Application Data\IBM\MQSI\shared-classes. 이로서 JMS 노드의 Java 클래스 경로가 올바르게 설정됩니다.

z/OS의 경우에는 공유 클래스 디렉토리가 없습니다. 대신 브로커 PDS(Partitioned Data Set)에 있는 BIPPROF 구성원의 클래스 경로에 각 JMS 제공자 java .jar 파일을 지정해야 합니다. 그런 다음 LIBPATH를 모든 고유 라이브러리로 갱신하고 BIPGEN JCL 작업을 브로커 ENVFILE로 전송하십시오.

JMSInput 노드 구성

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

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

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

  1. 등록 정보 대화 상자 네비게이터에서 기본을 선택한 후 다음 등록 정보를 완료하십시오.
    • 초기 컨텍스트 팩토리 값을 입력하십시오. JMS 응용프로그램은 JMS 제공자에 대한 JNDI 관리 오브젝트를 확보하고 찾기 위해 초기 컨텍스트를 사용합니다. 디폴트 값은 다음과 같습니다.

      com.sun.jndi.fscontext.RefFSContextFactory. 이 값은 WebSphere MQ JMS 제공자의 파일 기반 초기 컨텍스트 팩토리를 정의합니다.

      JMS 제공자의 초기 컨텍스트 팩토리 이름을 식별하려면 JMS 제공자 문서를 참조하십시오.

    • 위치 JNDI 바인딩의 값을 입력하십시오. 이 값은 바인딩 파일의 LDAP 위치나 파일 시스템 경로를 지정합니다. 바인딩 파일에는 JMSInput 노드에 사용되는 JNDI 관리 오브젝트의 정의가 들어 있습니다.

      위치 JNDI 바인딩 값을 입력할 때 다음 지시사항을 준수하는지 확인하십시오.

      • JMSInput 노드를 포함하는 메시지 플로우를 전개하려면, 먼저 바인딩 파일을 구성해야 합니다.
      • 이 필드에 바인딩 파일의 파일 이름을 포함시키지 마십시오.
      • 인증이 필요한 LDAP 위치를 지정한 경우 LDAP 프린시펄(사용자 ID) 및 LDAP 신임(암호)을 별도록 구성해야 합니다. 이 값은 브로커 레벨에서 구성됩니다. 이 값을 구성하는 방법에 대해서는 mqsicreatebrokermqsichangebroker 명령을 참조하십시오.
      • 문자열 값에는 file:/, iiop:/ 또는 ldap:/ 중 하나인 선두 키워드가 있어야 합니다.

      JNDI 관리 오브젝트 바인딩 파일 구성에 대한 정보는 JMS 제공자와 함께 제공된 문서를 참조하십시오.

    • 연결 팩토리 이름을 입력하십시오. JMSInput 노드는 JMS 제공자와의 연결을 작성하기 위해 이 연결 팩토리 이름을 사용합니다. 이 이름은 이미 바인딩 파일에 존재해야 합니다.
    • 백아웃 목적지 이름을 입력하십시오. 입력 메시지는 오류로 인해 메시지 플로우에서 메시지를 처리할 수 없고 입력 목적지에서 메시지를 제거해야 할 경우에 이 목적지로 송신됩니다. 바인딩 파일에 백아웃 목적지 이름이 존재해야 합니다.
    • 백아웃 임계값의 값을 입력하십시오. 이 값은 입력 메시지가 백아웃 목적지에 넣어지는 시기를 판별합니다. 예를 들면, 값이 3이면 JMS 제공자는 메시지를 입력 목적지에 전달하려고 세 번 시도합니다. 세 번 시도 후에는 메시지가 입력 목적지에서 제거되어 백아웃 목적지로 송신됩니다. 디폴트 값은 0입니다.
  2. 등록 정보 대화 상자 네비게이터에서 디폴트를 선택한 후 메시지 도메인, 메시지 세트, 메시지 유형 및 메시지 형식을 설명하는 등록 정보의 값을 설정하십시오.
    • 메시지 도메인에서는 드롭다운 목록에서 사용 중인 구문 분석기의 이름을 선택하십시오. 다음 이름에서 선택할 수 있습니다.
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • JMSMap
      • JMSStream
      • MIME
      • BLOB
      • IDOC
      메시지 도메인을 공백으로 남겨두면, JMSInput 노드가 다음의 두 방법 중 하나로 도메인을 판별합니다.
      • JMS 입력 메시지의 JMSType 헤더 값에 데이터가 있는지 점검.
      • JMS 메시지의 Java 클래스에 기초.
      메시지 도메인 판별을 위한 우선 순위 관련 정보는 메시지 도메인을 도출할 우선 순위를 참조하십시오.
    • MRM 또는 IDOC 구문 분석기를 사용 중인 경우, 메시지 세트의 드롭다운 목록에서 올바른 메시지 세트를 선택하십시오. 이 목록은 MRM 또는 IDOC를 도메인으로서 선택할 때 사용 가능한 메시지 세트로 채워집니다.

      XML, XMLNS, XMLNSC, JMS, MIME 및 BLOB 구문 분석기에 대해서는 메시지 세트를 공백으로 남겨 두십시오.

    • MRM 구문 분석기를 사용 중인 경우, 메시지 유형의 드롭다운 목록에서 올바른 메시지를 선택하십시오. 이 목록은 선택한 메시지 세트에 정의되어 있는 메시지로 채워집니다.

      XML, XMLNS, XMLNSC, JMS, MIME, BLOB 및 IDOC 구문 분석기에 대해서는 메시지 유형을 공백으로 남겨 두십시오.

    • MRM 또는 IDOC 구문 분석기를 사용 중인 경우, 메시지 형식의 드롭다운 목록에서 메시지 형식을 선택하십시오. 이 목록에는 이 메시지 세트에 대해 정의한 모든 물리적 형식이 포함됩니다.

      XML, XMLNS, XMLNSC, JMSMap, JMSStream, MIME 및 BLOB 구문 분석기에 대해서는 메시지 형식을 공백으로 남겨 두십시오.

  3. 토픽에 subscribe하기 위해 JMSInput 노드를 사용할 경우 등록 정보 대화 상자 네비게이터에서 Pub/Sub를 선택하십시오.
    • Subscription 토픽의 이름을 입력하십시오.
      • 이 등록 정보를 구성할 경우, 노드는 Publish/Subscribe 메시지 도메인에서만 작동합니다.
      • 이 등록 정보는 포인트 투 포인트 등록 정보 섹션에서 소스 큐와 상호 배타적입니다.
      • Subscription 토픽 이름은 노드가 사용하는 JMS 제공자의 표준을 따라야 합니다.

    • 노드가 지속 가능 subscription 토픽으로부터 publication을 수신할 경우 지속 가능한 Subscription ID를 입력하십시오.
      • 영속성 있는 subscription을 제거하는 것은 별도의 관리 작업입니다. 지속 가능 subscription 제거에 대해서는 JMS 제공자 문서를 참조하십시오.
      • 이 등록 정보는 Subscription 토픽 문자열을 지정한 경우에만 유효합니다.
  4. 포인트 투 포인트 메시지를 수신하기 위해 JMSInput 노드를 사용할 경우, 등록 정보 대화 상자 네비게이터에서 포인트 투 포인트를 선택하십시오.
    • 소스 큐 이름을 입력하십시오. 여기서 소스 큐는 바인딩 파일에 나열된 JMS 큐입니다.
  5. 메시지 필터링이 필요하면 등록 정보 대화 상자 네비게이터에서 메시지 선택자를 선택하십시오.
    • JMS 제공자가 생성되는 JMS 클라이언트 응용프로그램에서 설정된 메시지 등록 정보를 기초로 메시지를 필터해야 할 경우, 등록 정보 이름과 선택 조건(예: OrderValue > 200)을 지정하여 응용프로그램 등록 정보의 값을 입력하십시오.

      입력 노드가 응용프로그램 등록 정보를 기초로 선택하지 않도록 하려면 이 등록 정보를 공백으로 남겨 두십시오. 메시지 선택자를 구성하는 방법에 대한 설명은 JMS 메시지 선택자를 참조하십시오.

    • JMS 제공자가 특정 시간에 생성된 메시지를 필터해야 할 경우 시간 소인 값을 입력하십시오. 값은 규정되지 않은 Java 밀리세컨드 시간(예: 105757642321)입니다. BETWEEN 또는 AND와 같은 연산자를 사용하여 선택자를 규정하십시오.

      입력 노드가 JMSTimeStamp를 기초로 선택하지 않도록 하려면 이 등록 정보를 공백으로 남겨 두십시오.

    • JMS 제공자가 JMS 메시지의 JMSDeliveryMode 헤더 값을 기초로 메시지를 필터해야 할 경우, 드롭다운 목록에서 전달 모드 옵션을 선택하십시오. 다음에서 선택할 수 있습니다.
      • 비지속 - 생성되는 JMS 클라이언트 응용프로그램에서 비지속으로 표시된 메시지를 수신할 경우. 디폴트 옵션입니다.
      • 지속 - 생성되는 JMS 클라이언트 응용프로그램에서 지속으로 표시된 메시지를 수신할 경우.
    • JMS 제공자가 JMS 메시지의 JMSPriority 헤더 값을 기초로 메시지를 필터해야 할 경우, 우선순위 값을 입력하십시오.

      메시지 우선순위의 올바른 값은 0(가장 낮음) - 9(가장 높음)입니다. 예를 들면, 5를 입력하여 우선순위가 5인 메시지를 수신할 수 있습니다. 또한 선택자를 규정할 수도 있습니다. 예를 들면, 우선순위가 4보다 큰 우선순위 메시지를 수신하려면 > 4를, 또는 우선순위 범위 4와 8사이의 우선순위 메시지를 수신하려면 BETWEEN 4 AND 8을 입력하십시오.

      입력 노드가 JMSPriority를 기초로 선택하지 않도록 하려면 이 등록 정보를 공백으로 남겨 두십시오.

    • JMS 제공자가 JMSMessageID 헤더를 기초로 메시지를 필터해야 할 경우, 메시지 ID 값을 입력하십시오.

      특정 메시지 ID를 입력하거나 조건부 선택자를 입력하십시오. 예를 들면, 메시지 ID가 >WMBRK123456보다 큰 메시지를 리턴하려면 WMBRK123456을 입력하십시오.

      입력 노드가 JMSMessageID를 기초로 선택하지 않도록 하려면 이 등록 정보를 공백으로 남겨 두십시오.

    • JMS 제공자가 JMSRedelivered 헤더를 기초로 메시지를 필터해야 할 경우, 다시 전달됨 값을 입력하십시오.

      JMS 제공자가 다시 전달하지 않은 메시지만 입력 노드가 승인할 경우 FALSE를 입력하십시오.

      JMS 제공자가 다시 전달한 메시지만 입력 노드가 승인할 경우 TRUE를 입력하십시오.

      입력 노드가 JMSRedelivered를 기초로 선택하지 않도록 하려면 이 등록 정보를 공백으로 남겨 두십시오.

    • JMS 제공자가 JMSCorrelationID 헤더를 기초로 메시지를 필터해야 할 경우, 상관 ID 값을 입력하십시오.

      특정 상관 ID를 입력하거나 조건부 문자열을 입력하십시오. 예를 들면, WMBRKABCDEFG는 상관 ID가 이 값과 일치하는 메시지를 리턴합니다.

      입력 노드가 JMSCorrelationID를 기초로 선택하지 않도록 하려면 이 등록 정보를 공백으로 남겨 두십시오.

  6. 등록 정보 대화 상자 네비게이터에서 고급을 선택하십시오.
    • 메시지를 핸들링하는 방법에 관한 트랜잭션 특성을 정의하려면 트랜잭션 모드 드롭다운 목록에서 선택하십시오. 다음 옵션 중 하나를 선택할 수 있습니다.
      • 수신하는 메시지가 비지속 메시지로 처리될 경우 없음을 선택하십시오. 이 값을 선택할 경우, Session.AUTO_ACKNOWLEDGE 플래그를 사용하여 작성되는 비트랜잭션화 JMS 세션을 사용하여 메시지를 수신합니다.
      • JMSInput 노드가 메시지 플로우 내에서 작업을 수행하는 WebSphere MQ 또는 DB2와 같은 기타 모든 자원과 함께, 수신된 JMS 메시지의 확약 또는 롤백을 통합해야 할 경우 로컬을 선택하십시오. 이 값을 선택할 경우, 노드는 트랜잭션화 JMS 세션을 사용합니다.
      • JMSInput 노드가 브로커의 외부 동기점 통합자에서 관리할 전역 메시지 플로우 트랜잭션에 참여해야 할 경우 전역을 선택하십시오. 동기점 조정자는 분산 플랫폼의 브로커 큐 관리자와 z/OS의 RRS(Resource Recovery Services)입니다. 이 값을 선택할 경우, 노드가 수신한 모든 메시지는 XA JMS 세션을 사용하여 전체적으로 통합됩니다.
  7. 등록 정보 대화 상자 네비게이터에서 유효성 검증을 선택하여 입력 메시지 유효성 검증에 관련되는 노드 등록 정보를 설정하십시오.
    • 유효성 검증 드롭다운 목록에서 옵션을 선택하십시오. 사용 가능한 옵션은 다음과 같습니다.
      • 없음
      • 컨텐츠 및 값
      • Content
      컨텐츠 또는 컨텐츠 및 값을 선택할 경우, 실패 조치 드롭다운 목록에서 옵션을 선택하십시오. 사용 가능한 옵션은 다음과 같습니다.
      • 사용자 추적
      • 로컬 오류 로그
      • 예외(디폴트 값)
      • 예외 목록

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

  8. 등록 정보 대화 상자 네비게이터에서 일반 메시지 옵션을 선택하십시오. 구문 분석 타이밍의 디폴트 값은 요청시로 설정되어 있습니다. 이에 따라 부분 구문 분석에 의해 메시지가 구문 분석될 때까지 유효성 검증이 지연됩니다.

    이 값을 즉시로 변경할 경우, 즉시 해석할 수 없는 메시지 또는 선택 작성의 복합 유형을 제외하고 부분 구문 분석이 대체되어 메시지의 모든 것이 구문 분석되고 유효성 검증됩니다.

    이를 완료로 변경할 경우, 부분 구문 분석이 대체되어 메시지의 모든 것이 구문 분석되고 유효성 검증됩니다. 당시에 해석할 수 없는 메시지 또는 선택 작성의 복합 유형이 있으면 유효성 검증에 실패합니다.

  9. 등록 정보 대화 상자 네비게이터에서 XMLNSC 구문 분석기 옵션을 선택하십시오.

    XMLNS 도메인에 대해 XMLNSC 압축 구문 분석기 사용하려면 선택란을 선택하십시오.

    혼합 컨텐츠 보유 모드, 주석 보유 모드처리 지시사항 보유 모드의 경우 드롭다운 상자에서 다음 선택사항을 제공합니다.

    • 없음
    • 모두
  10. 간단한 설명, 자세한 설명 또는 둘 다를 입력하려면, 등록 정보 대화 상자 네비게이터에서 설명을 선택하십시오.
  11. 적용을 누르면 등록 정보 대화 상자를 닫지 않고 JMSInput 노드를 변경하십시오. 확인을 눌러 변경사항을 적용하고 등록 정보 대화 상자를 닫으십시오.

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

터미널 연결

수신되는 메시지마다 JMSInput 노드는 메시지를 Out 터미널로 라우트합니다. 검색에 실패하면 메시지를 재시도합니다. 재시도 임계값(노드의 BackoutThreshold 속성에 정의됨)에 도달하면 메시지가 failure 터미널로 라우트됩니다.

failure 터미널에 노드를 연결하여 이 조건을 핸들링할 수 있습니다. failure 터미널에 노드가 연결되어 있지 않으면 백아웃 목적지에 메시지가 기록됩니다. 백아웃 목적지를 제공하지 않았으면 오류 메시지가 발행되고 노드는 추가 입력 처리를 정지합니다. 오류 메시지는 bip4669입니다.

메시지 플로우에서 예외가 전달된 후 JMSInput 노드에서 메시지를 포착하면, 메시지는 catch 터미널로 라우트됩니다. catch 터미널에 노드가 연결되어 있지 않으면, 노드는 문제점이 해결되거나 백아웃 임계값에 도달할 때까지 다시 전달하기 위해 메시지를 백아웃합니다.

백아웃 목적지를 정의해야 합니다. 백아웃 목적지를 정의하지 않으면, 노드에서 bip4669 오류 메시지가 발생되고 추가 입력 처리가 정지됩니다.

통합 트랜잭션용으로 구성

메시지 플로우에 JMSInput 노드가 포함되어 있는 경우, 트랜잭션 모드에 대해 설정한 값이 메시지가 동기점 아래에 수신되는지 여부를 정의합니다.

  • 이 값을 전역으로 설정한 경우, 외부 동기점 통합 아래(즉, WebSphere MQ 작업 단위 내)에 메시지가 수신됩니다. 출력 노드가 명시적으로 이 값을 대체하지 않을 경우, 향후 메시지 플로우의 동일한 인스턴스 내에 있는 출력 노드에서 송신한 모든 메시지는 동기점 아래에 넣어집니다.
  • 이 값을 로컬로 설정한 경우, 메시지는 JMSInput 노드의 로컬 동기점 제어하에 수신됩니다. 개별 출력 노드가 로컬 동기점 아래에 메시지를 넣도록 지정하지 않은 경우, 향후 플로우의 출력 노드가 송신한 모든 메시지는 로컬 동기점 아래에 넣어지지 않습니다.
  • 이 값을 없음으로 설정한 경우, 메시지는 동기점 아래에 수신되지 않습니다. 개별 출력 노드가 동기점 아래에 메시지를 넣도록 지정하지 않은 경우, 향후 플로우의 출력 노드가 송신한 모든 메시지는 동기점 아래에 넣어지지 않습니다.

JMS 제공자는 트랜잭션 지원을 위해 필요한 추가 jar 파일을 제공할 수 있습니다. JMS 제공자 문서를 참조하십시오. 예를 들면, 분배된(z/OS 이외) 플랫폼에서 WebSphere MQ JMS 제공자는 추가 jar 파일 com.ibm,mqetclient.jar을 제공합니다. 이 jar도 브로커 shared_classes 디렉토리에 추가해야 합니다. 이 주제에서 JMS 노드에 JMS 제공자 클라이언트 사용 가능을 참조하십시오.

메시지를 외부 동기점 아래에서 수신하려면 추가 구성 단계가 필요합니다. 특정 JMS 제공자의 브로커에 처음 JMSOutput 또는 JMSInput을 전개할 경우에만 이 단계를 적용해야 합니다.
  • 분산 플랫폼에서, 브로커의 외부 동기점 조정자는 WebSphere MQ입니다. 트랜잭션 통합전역으로 설정된 메시지 플로우를 전개하기 전에, 전체적으로 통합된 트랜잭션에 참여하는 JMS 제공자 자원 관리자마다 추가 정의가 포함되도록 큐 관리자 .ini 파일을 수정하십시오.
    • Windows에서, WebSphere MQ 버전 5를 설치한 경우 WebSphere MQ 서비스를 시작하고 큐 관리자 이름을 마우스 오른쪽 단추로 누르십시오. 등록 정보를 선택하고 자원 등록 정보 탭을 누르십시오. WebSphere MQ 버전 6을 설치한 경우 WebSphere MQ 탐색기를 시작하고 왼쪽 분할창에 있는 큐 관리자 이름을 마우스 오른쪽 단추로 누르십시오. 등록 정보를 선택하고 왼쪽 분할창에서 XA 자원 관리자를 선택하십시오. 자세한 정보는 WebSphere MQ 시스템 관리 안내서를 참조하십시오.
      SwitchFile 등록 정보는 다음 값으로 설정하십시오.
      install_dir/bin/ JMSSwitch.dll  
      XAOpenString=Initial Context,location JNDI,Optional_parms
          ThreadOfControl=THREAD 
    • Linux 및 UNIX 플랫폼에서, JMS 제공자마다 큐 관리자 ini 파일에 스탠자를 추가하십시오. 자세한 정보는 WebSphere MQ 시스템 관리 안내서를 참조하십시오.
      예를 들면, 다음과 같습니다.
      XAResourceManager:
      Name=Jms_Provider_Name 
      SwitchFile=/install_dir/bin/ JMSSwitch.so
      XAOpenString=Initial Context,location JNDI,Optional_parms
      ThreadOfControl=THREAD
      여기서:

      이름은 JMS 제공자 자원 관리자를 식별하는 설치 시 정의된 이름입니다.

      SwitchFile은 브로커의 bin 디렉토리에 제공되는 JMSSwitch 라이브러리의 파일 시스템 경로입니다.

      XAOpenString의 값은 다음과 같습니다.
      • 초기 컨텍스트는 JMSInput 노드 기본 등록 정보인 초기 컨텍스트 팩토리에 설정된 값입니다.
      • 위치 JNDI는 JMSInput 노드 기본 등록 정보인 JNDI의 위치에 설정된 값입니다. 이 값에는 선두 키워드인 file:/, iiop:/ 또는 ldap:/가 있어야 합니다.
      다음 매개변수는 선택사항입니다.
      • mqsicreatebroker 또는 mqsichangebroker 명령을 사용하여 브로커에 대해 설정한 값과 일치하는 LDAP 프린시펄.
      • mqsicreatebroker 또는 mqsichangebroker 명령을 사용하여 브로커에 대해 설정한 값과 일치하는 LDAP 신임.
      • 바인딩 파일에 정의한 JNDI 관리 연결 팩토리인 복구 연결 팩토리 이름. 값을 지정하지 않으면 recoverXAQCF의 디폴트 값이 바인딩 파일에 추가됩니다. 어느 경우든지, 초기 컨텍스트 팩토리와 연관되는 JMS 제공자에 대해 복구 연결 팩토리를 XA 큐 연결 팩토리로 정의해야 합니다.

      선택 매개변수는 쉼표로 분리되며 위치가 지정되어 있습니다. 따라서 누락된 모든 매개변수는 쉼표로 표시해야 합니다.

      1. xarecovery.jar에 대한 참조를 포함하도록 브로커 큐 관리자의 Java CLASSPATH 환경 변수를 갱신하십시오. 예를 들면, 다음과 같습니다.
        install_dir/classes/xarecovery.jar
      2. 스위치 파일이 있는 위치에 해당되는 bin 디렉토리를 지시하도록 브로커 큐 관리자의 Java PATH 환경 변수를 갱신하십시오. 예를 들면 다음과 같습니다.
        install_dir/bin

      XA는 WebSphere MQ 버전 5.3, CSD12 및 WebSphere MQ 버전 6 픽스 팩 1 이전에는 브로커와 제공자 둘 다에 대해 동일한 큐 관리자를 사용할 수 없습니다.

    • z/OS에서는 외부 동기점 관리자가 RRS(Resource Recovery Services)입니다. z/OS에서 지원되는 유일한 JMS 제공자는 WebSphere MQ JMS입니다. z/OS의 WebSphere MQ JMS에 대해 지원되는 유일한 전송 옵션은 바인드 옵션입니다.

      JMS 제공자에 대한 동기점 제어는 브로커 큐 관리자의 RRS 동기점 통합으로 관리됩니다. .ini 파일을 수정할 필요는 없습니다.

터미널 및 등록 정보

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

터미널 설명
Failure 오류가 발생할 경우 메시지가 라우트될 출력 터미널. 유효성 검증 등록 정보가 설정되어 있어도 이 터미널로 전달된 메시지는 유효성이 검증되지 않습니다.
Out WebSphere MQ 큐에서 검색이 완료되었을 경우 메시지가 라우트될 출력 터미널.
Catch 예외에서 다운스트림이 전달되어 이 노드에서 포착되었을 경우 메시지가 라우트될 출력 터미널.

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

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

등록 정보 M C 디폴트 설명
초기 컨텍스트 팩토리   com.sun.jndi.fscontext.RefFSContextFactory JNDI 네임스페이스의 시작 지점입니다. JMS 응용프로그램은 JMS 제공자에 대한 연결 팩토리 및 큐 또는 토픽 오브젝트를 확보하고 찾기 위해 초기 컨텍스트를 사용합니다.

디폴트 값은 WebSphere MQ Java가 JMS 제공자로 사용될 경우 사용되는 값입니다.

위치 JNDI 바인딩     바인딩 파일에 대한 시스템 경로 또는 LDAP 위치.
연결 팩토리 이름     JMSInput 노드가 JMS 제공자와의 연결을 작성하기 위해 사용하는 연결 팩토리의 이름.
백아웃 목적지 아니오     메시지의 오류로 인해 메시지 플로우에서 메시지를 처리할 수 없을 때 JMSInput 노드에서 사용되는 목적지.
백아웃 임계값 아니오   0 다시 전달된 입력 메시지를 백아웃 목적지에 넣는 시점을 제어하는 값.

다음 표에는 JMSInput 노드의 디폴트 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
메시지 도메인 아니오 아니오   들어오는 메시지를 구문 분석하는 데 사용하는 도메인
메시지 세트 아니오 아니오   들어오는 메시지를 정의하는 메시지 세트의 이름 또는 ID
메시지 유형 아니오 아니오   들어오는 메시지의 이름
메시지 형식 아니오 아니오   들어오는 메시지의 물리적 형식 이름

다음 표에는 JMSInput 노드의 Pub/Sub 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
Subscription 토픽 아니오 아니오   노드가 subscribe되는 토픽의 이름.
지속 가능 Subscription ID 아니오 아니오   지속 가능 subscription 토픽의 ID.

다음 표에는 JMSInput 노드의 포인트 투 포인트 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
소스 큐       노드가 들어오는 메시지를 수신하는 큐의 이름.

다음 표에는 JMSInput 노드의 메시지 선택자 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
응용프로그램 등록 정보 아니오     응용프로그램 등록 정보 값에 따라 메시지를 필터할 메시지 선택자.
시간 소인 아니오     JMSTimestamp에 따라 필터할 메시지 선택자.
전달 모드 아니오     메시지 전달 모드에 따라 메시지를 필터할 메시지 선택자.
우선순위 아니오     메시지 우선순위에 따라 메시지를 필터할 메시지 선택자.
메시지 ID 아니오     메시지 ID에 따라 메시지를 필터할 메시지 선택자.
상관 ID 아니오     상관 ID에 따라 메시지를 필터할 메시지 선택자.

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

등록 정보 M C 디폴트 설명
트랜잭션 모드 아니오 없음 이 등록 정보는 들어오는 메시지가 외부 동기점이나 로컬 동기점 하에 수신되는지, 아니면 동기점 외부에서 수신되는지 여부를 판별하는 데 사용됩니다. 올바른 값은 없음, 로컬전역입니다.

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

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

다음 표에는 JMSInput 노드의 일반 메시지 옵션 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
구문 분석 타이밍 아니오 요청시 이 등록 정보는 입력 메시지를 구문 분석하는 시기를 제어합니다. 올바른 값은 요청시, 즉시완료입니다.

이 등록 정보에 대한 자세한 설명은 요청시 구문 분석을 참조하십시오.

다음 표에는 JMSInput 노드의 XMLNSC 구문 분석기 옵션 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
XMLNS 도메인에 XMLNSC 압축 구문 분석기 사용 지우기 아니오 변경 시작이 등록 정보는 XMLNS 도메인의 메시지에 대해 XMLNSC 압축 구문 분석기를 사용하는지 여부를 제어합니다. 이 등록 정보를 설정하면 입력 RFH2 헤더 또는 디폴트 등록 정보 도메인이 XMLNS일 때 출력 터미널에 연결되는 노드의 XMLNSC 아래에 메시지 데이터가 표시됩니다. 변경 끝
혼합 컨텐츠 보유 모드 아니오 없음 이 등록 정보는 XMLNSC 구문 분석기가 입력 메시지에서 혼합 텍스트를 발견할 경우 메시지 트리에서 요소를 작성하는지 여부를 제어합니다. 올바른 값은 없음모두입니다. 모두를 선택하면 혼합 텍스트에 대해 요소가 작성됨을 의미합니다. 없음을 선택하면 혼합 텍스트가 무시되고 요소가 작성되지 않음을 의미합니다.
주석 보유 모드 아니오 없음 이 등록 정보는 XMLNSC 구문 분석기가 입력 메시지에서 주석을 발견할 경우 메시지 트리에서 요소를 작성하는지 여부를 제어합니다. 올바른 값은 없음모두입니다. 모두를 선택하면 주석에 대해 요소가 작성됨을 의미합니다. 없음을 선택하면 주석이 무시되고 요소가 작성되지 않음을 의미합니다.
처리 지시사항 보유 모드 아니오 없음 이 등록 정보는 XMLNSC 구문 분석기가 입력 메시지에서 처리 지시사항을 발견할 경우 메시지 트리에서 요소를 작성하는지 여부를 제어합니다. 올바른 값은 없음모두입니다. 모두를 선택하면 처리 지시사항에 대해 요소가 작성됨을 의미합니다. 없음을 선택하면 처리 지시사항이 무시되고 요소가 작성되지 않음을 의미합니다.

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

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