IBM MQ 서비스 정의 특성
새 서비스 정의를 작성 중이거나 기존 서비스 정의를 편집할 때 서비스 정의에 대한 특성 및 속성을 설정할 수 있습니다.
일부 속성은 서비스 정의가 특정 바인딩 유형 또는 메시지 교환 패턴인 경우에만 사용 가능합니다. 서비스 정의의 개별 특성 페이지에 대한 특성을 보려면 다음 링크를 참조하십시오.
각 속성을 구성해야 하는 경우에 대한 간략한 설명이 속성별로 나와 있습니다.
일반 페이지
다음 표에는 서비스 정의 특성 대화 상자의 일반 페이지에서 설정할 수 있는 속성이 나열되어 있습니다.
속성 | 설명 |
---|---|
네임스페이스 | 서비스의 네임스페이스를 지정합니다. 임시 기본 값이 이미 지정되어 있습니다. |
이름 | 새 서비스 정의의 고유 이름입니다. 서비스 정의 이름은 대소문자가 구분되지 않지만 대소문자가 혼합된 서비스 정의 이름은 계속 유지됩니다. |
메시지 교환 패턴 | 메시지 교환 패턴은 서비스 호출 중에
송신 및 수신되는 메시지의 방향을 설명합니다. 가능한 선택사항은 다음 두 가지입니다.
|
바인딩 유형 | IBM® MQ 서비스 정의 스펙의 버전을 지정합니다. |
주석 | WSDL 파일의 서비스를 설명하기 위한 주석을 지정합니다. |
조작 페이지
다음 표에는 서비스 정의 특성 대화 상자의 조작 페이지에서 설정할 수 있는 속성이 나열되어 있습니다. 각 서비스 정의에는 하나의 조작만 있습니다.
속성 | 설명 |
---|---|
조작 이름 | 조작 이름을 지정합니다. 서비스 정의를 작성하려면 이 특성에 값이 있어야 합니다. |
조치 | 서비스 제공자에서 서비스 요청을 디스패치하는 데 사용됩니다.
예: 다중 서비스를 단일 목적지를 사용하여 배치할 수 있음,
서비스 공급업체에서 목적지에 도착하는 요청을 적절하게
디스패치할 수 있음. 바인딩 유형이 MQ인 경우, 조치는 targetAction을 지정합니다. |
주석 | WSDL 파일의 조작을 설명하기 위한 주석을 지정합니다. |
입력 목적지 페이지
다음 표에는 서비스 정의 특성 대화 상자의 입력 목적지 페이지에서 설정할 수 있는 속성이 나열되어 있습니다. 입력 페이지는 서비스가 예상하는 메시지의 자세한 내용 및 해당 메시지를 검색할 목적지를 정의합니다.
속성 | 설명 |
---|---|
입력 목적지 이름 | 요청이 송신되는 목적지 큐 또는 목적지 토픽의 이름을
지정합니다. 예: IBM MQ IRI의 큐-목적지 또는 토픽-목적지 단위입니다. 다음과 같습니다.
|
목적지 큐 관리자 이름 | 목적지 큐 관리자의 이름을 지정합니다. |
연결 큐 관리자 | 요청 서비스가 연결되는 큐 관리자의 이름을 지정합니다. 이는 MQCONN() 및 MQCONNX() 호출에 사용되는 QmgrName 매개변수에 해당합니다. |
클라이언트 연결 특성 | 클라이언트 연결 특성은 서비스 요청자가 특정 시스템 또는 채널에 바인딩하는 방법에 대한 정보를 포함할 수 있는 자세한 바인딩을 지정합니다. 클라이언트 바인딩 및 채널 이름을 설정할 수 있다는 점이 일부 환경에서는 유용하지만, 서비스를 너무 자세하게 지정하면 제한적일 수 있습니다. 이러한 문제점을 해결하는 방법은 서비스 정의에 통합되는 바인딩 정보의 양을 최소화하고, 가능한 경우 기본 인프라 또는 IBM MQ가 메시지를 라우트하도록 허용하는 것입니다. |
채널 테이블 이름 | 채널 연결을 식별하는 데 사용되는 클라이언트 채널
테이블 파일의 이름을 지정합니다.
|
채널 테이블 라이브러리 | 클라이언트 채널 테이블의 경로를 지정합니다.
|
클라이언트 채널 연결 이름 | 서비스 요청자가 IBM MQ MQI 클라이언트 바인딩 연결을
만들 때 사용하는 연결 문자열을 지정합니다. TCP/IP의 경우, 연결 양식은
호스트 이름 뒤에 포트 번호가 붙습니다. 다음과 같습니다. 포트 번호가
지정되지 않는 경우, 기본 값인 1414가 사용됩니다.
|
클라이언트 채널 이름 | IBM MQ 서비스 요청자가
IBM MQ MQI 클라이언트 바인딩 연결을 만들 때
사용하는 채널을 지정합니다.
|
클라이언트 채널 전송 유형 | IBM MQ 서비스 요청자가
IBM MQ MQI 클라이언트 바인딩 연결을 만들 때 사용하는 전송 유형을 지정합니다.
|
입력 메시지 스키마 페이지
다음 표에는 서비스 정의 특성 대화 상자의 입력 메시지 스키마 페이지에서 설정할 수 있는 속성이 나열되어 있습니다. 이를 사용하여 메시지 페이로드(payload)에 대한 스키마를 정의할 수 있습니다.
속성 | 설명 |
---|---|
인바운드 데이터 유형 | 예상 인바운드 데이터 유형을 지정합니다. 단순 유형의 경우,
xsd:string 또는 xsd:int 와 같은 내장 XML xsd 유형을 사용하여 이를 모델화할 수 있습니다.
더 복잡한 유형의 경우 데이터 유형에 대해 스키마 파일 가져오기 및
네임스페이스 가져오기를 지정하여 외부 파일에서 데이터 유형을 가져올 수 있습니다. |
스키마 파일 가져오기 | 스키마 파일을 가져오도록 지정합니다. |
네임스페이스 가져오기 | 네임스페이스를 가져오도록 지정합니다. |
입력 메시지 헤더 페이지
다음 표에는 서비스 정의 특성 대화 상자의 입력 메시지 헤더 페이지에서 설정할 수 있는 속성이 나열되어 있습니다. 입력 페이지는 서비스가 예상하는 메시지의 자세한 내용 및 해당 메시지를 검색할 목적지를 정의합니다. 일부 특성은 MQ 바인딩 유형의 서비스 정의에만 적용됩니다.
속성 | 설명 |
---|---|
CCSID | MQMD 구조의 CodedCharSetId 필드에 해당하는 코드화 문자 세트 ID를 지정합니다. 이 값이 지정되지 않은 경우, 서비스 요청자 및 서비스 제공자는 메시지 데이터의 문자 세트에 해당하는 값을 사용합니다. |
형식 | 메시지 데이터의 형식 이름을 지정합니다. 이 특성은
MQRFH2 형식 필드에 해당하며 MQRFH2가
없는 경우에는 MQMD 형식 필드에 해당합니다. 값은
A - Z 및 0 – 9 문자로 구성된 0 - 8자 길이의 문자열이어야 합니다. 형식 필드의 지침에 따라 형식의 값을 설정할 수 있습니다. |
사용자 특성 | IBM MQ 서비스 메시지로 전달되는 사용자 정의 데이터를 지정합니다.
값은 RFH2 폴더 요소에 허용되는
형식으로서 XML 유사 구문을 사용하여 인코드된 세 가지 값으로
지정해야 합니다. 예:
dt="datatype "
요소는 선택적이며 생략되는 경우 문자열로 처리되어 요소를 다음과 같이
지정할 수 있습니다. 예:
허용되는
데이터 유형 및 형식에 대한 추가 정보는 IBM Knowledge Center에서 NameValueData(MQCHARn)의 내용을 참조하십시오.
사용자 ID 또는 비밀번호와 같은 보안에 민감한 특성은
포함하지 않는 것이 좋습니다. |
메시지 유형 | 송신되는 메시지의 유형을 지정합니다. 이 특성은
MQMD 구조의 MsgType에 해당합니다.
다음 다섯 가지 값이 가능합니다.
|
지속 | 메시지가 지속적인지 아닌지를 지정하며
MQMD 구조의 Persistence 필드에 해당합니다.
세 가지 값이
가능합니다.
|
메시지 ID | MQMD 구조의 MsgId
필드에 해당하는 메시지 ID를 지정합니다. 메시지 ID를 사용하여 특수화된 특정 IBM MQ 애플리케이션을 서비스로 설명할 수 있습니다(예: 입력 큐를 공유하고 사전정의된 msgId 값을 기반으로 적합한 메시지를 선택하는 애플리케이션). 서비스 정의에 사전정의된 msgId는 요청-응답 메시지 교환 패턴이 요청의 msgId를 리턴할 때와 같은 경우에 문제점을 일으킬 수 있습니다. 메시지 ID는 문자열 또는 2진 값일 수 있습니다. 2진 값은 최대 24쌍의 2자 16진 값 문자열이어야 합니다.편집을 클릭하여 대화 상자를 열고 텍스트 또는 바이트로 값을 입력하십시오. |
상관 ID | MQMD 구조의 CorrelId 필드에 해당하는
상관 ID를 지정합니다. 상관 ID는 문자열 또는
2진 값일 수 있습니다. 2진 값은
최대 24쌍의 2자 16진 값 문자열이어야 합니다. 편집을 클릭하여 대화 상자를 열고 텍스트 또는 바이트로 값을 입력하십시오. |
만기 | 메시지 지속 기간을 지정합니다. 이는 부호가 있는
정수여야 하며 10분의 수 초(x/10)로 측정됩니다. 만기 범위는
1 - 2,147,483,647입니다. 특수 값 무제한은 메시지가 만기되지 않음을 표시하는 데 사용됩니다. -1 값이 WSDL 파일에 기록됩니다. 지정되지 않음 값은 WSDL 파일에 값이 기록되지 않음을 의미합니다. 이것이 기본값입니다. |
우선순위 | 메시지와 연관된 우선순위를 지정하며 MQMD 구조의 우선순위 필드에 해당합니다.
0 - 9 사이의 정수로 지정해야 하며 최저 우선순위는 0이고
최고 우선순위는 9입니다. 특수 값 무제한은 메시지를 넣은 첫 번째 큐의 정의에서 메시지 우선순위를 가져옴을 표시하는 데 사용됩니다. -1 값이 WSDL 파일에 기록됩니다. 지정되지 않음 값은 WSDL 파일에 값이 기록되지 않음을 의미합니다. 이것이 기본값입니다. |
인코딩 | 메시지 데이터의 숫자 인코딩을 지정하며
MQMD 구조의 인코딩 필드에 해당합니다.
|
보고서 옵션 | 서비스 제공자가 응답 메시지 또는 결함 메시지의
메시지 및 상관 ID를 설정하는 방법을 지정합니다. 이 특성은
MQMD 구조의 보고서 필드에 해당합니다.
가능한 값은 다음 네 가지입니다.
|
출력 목적지 페이지
다음 표에는 서비스 정의 특성 대화 상자의 출력 목적지 페이지에서 설정할 수 있는 속성이 나열되어 있습니다. 출력 페이지는 서비스가 입력 메시지에 대한 응답으로 송신할 메시지의 자세한 내용 및 해당 메시지를 넣을 목적지를 정의합니다. 출력 목적지 이름에는 큐의 경우 'msg/queue/', 토픽의 경우 'msg/topic/'이 접두부로 지정되어야 합니다.
속성 | 설명 |
---|---|
출력 목적지 이름 | 응답 메시지가 송신되고 MQMD 구조의 ReplyToQ 및 ReplyToQMgr 필드에 해당하는
목적지 큐 또는 목적지 토픽의 이름을 지정합니다. 목적지 이름은 IBM MQ URI의
큐 목적지 또는 토픽 목적지 단위 형식을 사용해야 합니다. 그 예로는 다음과 같습니다.
|
목적지 큐 관리자 이름 | 목적지 큐 관리자의 이름을 지정합니다. |
연결 큐 관리자 | 요청 서비스가 연결되는 큐 관리자의 이름을 지정합니다. 이는 MQCONN() 및 MQCONNX() 호출에 사용되는 QmgrName 매개변수에 해당합니다. |
클라이언트 연결 특성 | 클라이언트 연결 특성은 서비스 요청자가 특정 시스템 또는 채널에 바인딩하는 방법에 대한 정보를 포함할 수 있는 자세한 바인딩을 지정합니다. 클라이언트 바인딩 및 채널 이름을 설정할 수 있다는 점이 일부 환경에서는 유용하지만, 서비스를 너무 자세하게 지정하면 제한적일 수 있습니다. 이러한 문제점을 해결하는 방법은 서비스 정의에 통합되는 바인딩 정보의 양을 최소화하고, 가능한 경우 기본 인프라 또는 IBM MQ가 메시지를 라우트하도록 허용하는 것입니다. |
채널 테이블 이름 | 채널 연결을 식별하는 데 사용되는 클라이언트 채널
테이블 파일의 이름을 지정합니다.
|
채널 테이블 라이브러리 | 클라이언트 채널 테이블의 경로를 지정합니다.
|
클라이언트 채널 이름 | 서비스 요청자가 IBM MQ MQI 클라이언트 바인딩 연결을
만들 때 사용하는 연결 문자열을 지정합니다. TCP/IP의 경우, 연결 양식은
호스트 이름 뒤에 포트 번호가 붙습니다. 다음과 같습니다. 포트 번호가
지정되지 않는 경우, 기본 값인 1414가 사용됩니다.
|
클라이언트 채널 연결 이름 | IBM MQ 서비스 요청자가
IBM MQ MQI 클라이언트 바인딩 연결을 만들 때
사용하는 채널을 지정합니다.
|
클라이언트 채널 전송 유형 | IBM MQ 서비스 요청자가
IBM MQ MQI 클라이언트 바인딩 연결을 만들 때 사용하는 전송 유형을 지정합니다.
|
출력 메시지 스키마 페이지
다음 표에는 서비스 정의 특성 대화 상자의 출력 메시지 스키마 페이지에서 설정할 수 있는 속성이 나열되어 있습니다. 이를 사용하여 메시지 페이로드(payload)에 대한 스키마를 정의할 수 있습니다.
속성 | 설명 |
---|---|
아웃바운드 데이터 유형 | 예상 아웃바운드 데이터 유형을 지정합니다. |
스키마 파일 가져오기 | 스키마 파일을 가져오도록 지정합니다. |
네임스페이스 가져오기 | 네임스페이스를 가져오도록 지정합니다. |
출력 메시지 헤더 페이지
다음 표에는 서비스 정의 특성 대화 상자의 출력 메시지 헤더 페이지에서 설정할 수 있는 속성이 나열되어 있습니다. 출력 페이지는 서비스가 입력 메시지에 대한 응답으로 송신할 메시지의 자세한 내용 및 해당 메시지를 넣을 목적지를 정의합니다. 일부 특성은 MQ 바인딩 유형의 서비스 정의에만 적용됩니다.
속성 | 설명 |
---|---|
CCSID | MQMD 구조의 CodedCharSetId 필드에 해당하는 코드화 문자 세트 ID를 지정합니다. 이 값이 지정되지 않은 경우, 서비스 요청자 및 서비스 제공자는 메시지 데이터의 문자 세트에 해당하는 값을 사용합니다. |
형식 | 메시지 데이터의 형식 이름을 지정합니다. 이 특성은
MQRFH2 형식 필드에 해당하며 MQRFH2가
없는 경우에는 MQMD 형식 필드에 해당합니다. 값은
A - Z 및 0 – 9 문자로 구성된 0 - 8자 길이의 문자열이어야 합니다. 형식 필드의 지침에 따라 형식의 값을 설정할 수 있습니다. |
사용자 특성 | IBM MQ 서비스 메시지로 전달되는 사용자 정의 데이터를 지정합니다.
값은 RFH2 폴더 요소에 허용되는
형식으로서 XML 유사 구문을 사용하여 인코드된 세 가지 값으로
지정해야 합니다. 예:
dt="datatype "
요소는 선택적이며 생략되는 경우 문자열로 처리되어 요소를 다음과 같이
지정할 수 있습니다. 예:
허용되는
데이터 유형 및 형식에 대한 추가 정보는 IBM Knowledge Center에서 NameValueData(MQCHARn)의 내용을 참조하십시오.
사용자 ID 또는 비밀번호와 같은 보안에 민감한 특성은
포함하지 않는 것이 좋습니다. |
메시지 유형 | 송신되는 메시지의 유형을 지정합니다. 이 특성은
MQMD 구조의 MsgType에 해당합니다.
다음 다섯 가지 값이 가능합니다.
|
지속 | 메시지가 지속적인지 아닌지를 지정하며
MQMD 구조의 Persistence 필드에 해당합니다.
세 가지 값이
가능합니다.
|
메시지 ID | MQMD 구조의 MsgId
필드에 해당하는 메시지 ID를 지정합니다. 메시지 ID를 사용하여 특수화된 특정 IBM MQ 애플리케이션을 서비스로 설명할 수 있습니다(예: 입력 큐를 공유하고 사전정의된 msgId 값을 기반으로 적합한 메시지를 선택하는 애플리케이션). 서비스 정의에 사전정의된 msgId는 요청-응답 메시지 교환 패턴이 요청의 msgId를 리턴할 때와 같은 경우에 문제점을 일으킬 수 있습니다. 메시지 ID는 문자열 또는 2진 값일 수 있습니다. 2진 값은 최대 24쌍의 2자 16진 값 문자열이어야 합니다.편집을 클릭하여 대화 상자를 열고 텍스트 또는 바이트로 값을 입력하십시오. |
상관 ID | MQMD 구조의 CorrelId 필드에 해당하는
상관 ID를 지정합니다. 상관 ID는 문자열 또는
2진 값일 수 있습니다. 2진 값은
최대 24쌍의 2자 16진 값 문자열이어야 합니다. 편집을 클릭하여 대화 상자를 열고 텍스트 또는 바이트로 값을 입력하십시오. |
만기 | 메시지 지속 기간을 지정합니다. 이는 부호가 있는
정수여야 하며 10분의 수 초(x/10)로 측정됩니다. 만기 범위는
1 - 2,147,483,647입니다. 특수 값 무제한은 메시지가 만기되지 않음을 표시하는 데 사용됩니다. -1 값이 WSDL 파일에 기록됩니다. 지정되지 않음 값은 WSDL 파일에 값이 기록되지 않음을 의미합니다. 이것이 기본값입니다. |
우선순위 | 메시지와 연관된 우선순위를 지정하며
MQMD 구조의 우선순위 필드에 해당합니다.
0 - 9 사이의 정수로 지정해야 하며 최저 우선순위는 0이고
최고 우선순위는 9입니다. 특수 값 무제한은 메시지를 넣은 첫 번째 큐의 정의에서 메시지 우선순위를 가져옴을 표시하는 데 사용됩니다. -1 값이 WSDL 파일에 기록됩니다. 지정되지 않음 값은 WSDL 파일에 값이 기록되지 않음을 의미합니다. 이것이 기본값입니다. |
인코딩 | 메시지 데이터의 숫자 인코딩을 지정하며
MQMD 구조의 인코딩 필드에 해당합니다.
|
보고서 옵션 | 서비스 제공자가 응답 메시지 또는 결함 메시지의
메시지 및 상관 ID를 설정하는 방법을 지정합니다. 이 특성은
MQMD 구조의 보고서 필드에 해당합니다.
가능한 값은 다음 네 가지입니다.
|