16장
관리 대상 객체 속성 참조
이 장에서는 관리 대상 객체의 속성에 대한 참조 정보를 제공합니다. 이 장은 다음 내용으로 구성되어 있습니다.
대상 등록 정보
표 16-1에는 대상 관리 대상 객체를 구성하는 속성이 나열되어 있습니다.
표 16-1 대상 관리 대상 객체 속성
|
속성 이름
|
설명
|
유형
|
기본값
|
|
imqDestinationDescription
|
대상 객체의 설명
|
문자열
|
없음
|
|
imqDestinationName
|
물리적 대상의 이름
|
문자열
|
Untitled_Destination_Object
|
연결 팩토리 속성
이 절에는 연결 팩토리 관리 대상 객체를 구성하는 속성에 대한 참조 정보가 포함되어 있습니다. 속성은 다음과 같은 내용으로 분류됩니다.
표 16-2는 연결 팩토리 관리 대상 객체 속성에 대한 색인입니다. 첫 번째 열에는 각 속성이 알파벳순으로 나열되고 두 번째 열에는 해당 범주가 나열되며 세 번째 열은 속성을 설명하는 표에 대한 상호 참조입니다.
연결 처리
표 16-2에는 연결 처리를 위한 연결 팩토리 속성이 나열되어 있습니다.
표 16-2 연결 팩토리 속성: 연결 처리
|
속성 이름
|
설명
|
유형
|
기본값
|
|
imqAddressList
|
하나 이상의 메시지 서버 주소를 쉼표로 구분한 목록입니다. 사용할 연결 서비스와 포트 지정 방법과 관련된 몇 가지 주소 지정 체계가 있습니다.
주소 목록 지정 방법과 목록 항목을 설명하는 예에 대한 자세한 내용은 imqAddressList 속성 값 구문을 참조하십시오.
|
문자열
|
기존 Message Queue 3.0 주소(있는 경우) 또는 표 16-3의 첫 번째 항목(없는 경우)
|
|
imqAddressListBehavior
|
연결을 imqAddressList 속성에 있는 주소 순서(PRIORITY)로 시도할지 임의의 순서(RANDOM)로 시도할지 여부를 지정하는 문자열입니다. 많은 클라이언트가 동일한 연결 팩토리를 사용하여 연결을 시도할 경우 임의의 순서를 사용하면 모든 클라이언트가 같은 주소에 연결되는 것을 막을 수 있습니다.
|
문자열
|
PRIORITY
|
|
imqAddressListIterations
|
클라이언트 런타임이 연결을 설정 또는 재설정하기 위해 imqAddressList를 반복하는 횟수입니다. 값이 -1이면 시도 횟수에 제한이 없습니다.
|
정수
|
5
|
|
imqPingInterval
|
클라이언트 런타임이 응용 프로그램과 브로커 간의 연결을 테스트하는 빈도(초)입니다.
값이 -1 또는 0(영)이면 클라이언트 런타임이 연결을 주기적으로 테스트하지 않습니다.
|
정수
|
30
|
|
imqReconnectEnabled
|
연결이 끊겼을 때 클라이언트 런타임이 메시지 서버 또는 imqAddressList의 주소 목록에 재연결을 시도해야 하는지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
|
imqReconnectAttempts
|
클라이언트 런타임이 목록의 다음 주소를 연결하려고 시도하기 전에 imqAddressList의 각 주소에 대해 연결 또는 재연결을 시도하는 횟수입니다. 값이 -1이면 재연결 시도 횟수가 제한되지 않으므로 클라이언트 런타임이 연결에 성공할 때까지 첫 번째 주소에 연결하려고 시도합니다.
|
정수
|
0(영)
|
|
imqReconnectInterval
|
재연결 시도 간의 간격(밀리초)입니다. 이 값은 imqAddressList의 각 주소에 대한 시도와 목록의 연속적인 주소에 대해 적용됩니다. 값이 너무 작은 경우 브로커의 복구 시간이 부족합니다. 값이 너무 큰 경우 재연결 시 너무 오래 지연될 수 있습니다.
|
long
|
3000(밀리초)
|
|
imqSSLIsHostTrusted
|
클라이언트가 브로커의 자체 서명된 인증서를 승인할 수 있는지 여부를 지정하는 부울 값입니다. 인증 기관의 서명된 인증서를 사용하려면 이 값을 false로 설정합니다.
|
부울
|
true
|
imqAddressList 속성 값 구문
imqbrokerlist 값의 각 주소는 클라이언트 런타임이 연결할 수 있는 브로커 인스턴스에 해당합니다.
연결 서비스마다 다른 브로커 주소를 지정합니다. 구문은 일반적으로 다음과 같습니다.
scheme://address_syntax
목록에 주소를 추가하려면 쉼표와 다른 주소를 추가합니다. 목록에는 다음과 같은 형식으로 여러 항목이 표시될 수 있습니다.
scheme://address_syntax,scheme://address_syntax...
scheme 변수는 표 16-3에서 설명한 대로 mq, mqtcp, mqssl, http, https 중에서 사용 중인 주소 유형을 지정합니다. address_syntax 변수는 체계별 브로커 주소를 나타냅니다. 주소 지정 체계는 표 16-3에 나와 있습니다. 첫 번째 열에는 주소 지정 체계의 이름이 표시되고 두 번째 열에는 해당 이름과 연결되는 연결 서비스가 표시되며 세 번째 열에는 설명이 표시되고 네 번째 열에는 사용할 구문이 제공됩니다.
표 16-3 imqAddressList 속성의 주소 지정 체계
|
방식
|
Connection서비스
|
설명
|
구문
|
|
mq
|
ms
ssljms
|
jms 또는 ssljms 서비스와 함께 사용할 포트를 동적으로 할당합니다.
포트 매퍼 호스트와 포트를 지정합니다. 포트 매퍼는 연결에 사용되는 포트를 동적으로 지정합니다.
|
[hostName][:port][/serviceName]
jms 연결 서비스에는 다음과 같은 기본값이 적용됩니다.
hostName = localhost
port = 7676
serviceName = jms
ssljms 연결 서비스에는 기본값이 없습니다. 모든 변수를 지정해야 합니다.
|
|
mqtcp
|
jms
|
포트 번호를 지정하고 jms 연결 서비스를 사용합니다.
Message Queue 클라이언트 런타임은 지정된 호스트와 포트에 tcp 연결을 설정하여 연결합니다.
|
hostName:port/jms
|
|
mqssl
|
ssljms
|
포트 번호를 지정하고 ssljms 연결 서비스를 사용합니다.
Message Queue 클라이언트 런타임은 지정된 호스트와 포트에 보안 ssl 연결을 설정하여 연결합니다.
|
port/ssljms
|
|
http
|
httpjms
|
httpjms 연결 서비스를 사용합니다.
클라이언트 런타임은 지정된 URL의 Message Queue 터널 서블릿에 HTTP 연결을 설정합니다 브로커가 HTTP 터널 서블릿에 액세스하도록 구성해야 합니다.
|
http://hostName:port/contextRoot/tunnel
여러 브로커 인스턴스가 동일한 터널 서블릿을 사용하는 경우 다음 구문을 사용하여 임의로 선택된 인스턴스가 아니라 특정 브로커 인스턴스에 연결합니다.
http://hostName:port/contextRoot
/tunnel?ServerName=hostName:instanceName
|
|
https
|
httpsjms
|
httpsjms 연결 서비스를 사용합니다.
Message Queue 클라이언트 런타임은 지정된 Message Queue 터널 서블릿 URL에 보안 HTTPS 연결을 설정합니다. 브로커가 HTTPS 터널 서블릿에 액세스하도록 구성해야 합니다.
|
https://hostName:port/contextRoot/tunnel
여러 브로커 인스턴스가 동일한 터널 서블릿을 사용하는 경우 다음 구문을 사용하여 임의로 선택된 인스턴스가 아니라 특정 브로커 인스턴스에 연결합니다.
https://hostName:port/contextRoot/
tunnel?ServerName=hostName:instanceName
|
표 16-4에는 주소 지정 형식의 예가 포함되어 있습니다. 첫 번째 열은 연결 서비스의 이름입니다. 두 번째 열은 예에 나오는 호스트가 로컬 호스트인지, 지정되지 않은 호스트인지, 지정된 호스트인지 또는 적용할 없는 호스트인지를 지정합니다. 세 번째 열은 예에 나오는 포트가 지정되는지, 지정되지 않는지 또는 적용할 수 없는지 여부를 지정하고, 네 번째 열은 예입니다.
표 16-4 메시지 서버 주소 예
|
연결 서비스
|
브로커 호스트
|
포트
|
주소 예
|
|
지정하지 않음
|
로컬 호스트
|
지정하지 않음
|
기본값
(mq://localHost:7676/jms)
|
|
지정하지 않음
|
지정된 호스트
|
지정하지 않음
|
myBkrHost
(mq://myBkrHost:7676/jms)
|
|
지정하지 않음
|
지정하지 않음
|
지정된 포트 매퍼 포트
|
1012
(mq://localHost:1012/jms)
|
|
ssljms
|
로컬 호스트
|
지정되지 않은 포트 매퍼 포트
|
mq://localHost:7676/ssljms
|
|
ssljms
|
지정된 호스트
|
포트 매퍼 포트
|
mq://myBkrHost:7676/ssljms
|
|
ssljms
|
지정된 호스트
|
지정된 포트 매퍼 포트
|
mq://myBkrHost:1012/ssljms
|
|
jms
|
로컬 호스트
|
지정된 서비스 포트
|
mqtcp://localhost:1032/jms
|
|
ssljms
|
지정된 호스트
|
지정된 서비스 포트
|
mqssl://myBkrHost:1034/ssljms
|
|
httpjms
|
적용할 수 없음
|
적용할 수 없음
|
http://websrvr1:8085/imq/tunnel
|
|
httpsjms
|
적용할 수 없음
|
적용할 수 없음
|
https://websrvr2:8090/imq/tunnel
|
클라이언트 아이디
표 16-5에는 클라이언트 아이디에 대한 연결 팩토리 속성이 나열되어 있습니다.
표 16-5 연결 팩토리 속성: 클라이언트 아이디
|
속성 이름
|
설명
|
유형
|
기본값
|
|
imqDefaultUsername
|
브로커 인증을 위한 기본 아이디입니다.
|
문자열
|
guest
|
|
imqDefaultPassword
|
브로커 인증을 위한 기본 비밀번호입니다.
|
문자열
|
guest
|
|
imqConfiguredClientID
|
관리상 구성된 클라이언트 아이디입니다.
|
문자열
|
null
|
|
imqDisableSetClientID
|
JMS API의 setClientID() 메소드를 사용하여 클라이언트가 클라이언트 아이디를 변경하지 못하게 할지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
메시지 헤더 무시
표 16-6에는 JMS 메시지 헤더 필드 무시를 위한 연결 팩토리 속성이 나열되어 있습니다.
표 16-6 연결 팩토리 속성: 메시지 헤더 무시
|
속성 이름
|
설명
|
유형
|
기본값
|
|
imqOverrideJMSDeliveryMode
|
클라이언트에서 설정한 JMSDeliveryMode 필드를 무시할 수 있는지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
|
imqJMSDeliveryMode
|
JMSDeliveryMode의 무시하는 값입니다. 값은 1(비지속성) 또는 2(지속성)입니다.
|
정수
|
2
|
|
imqOverrideJMSExpiration
|
클라이언트에서 설정한 JMSExpiration 필드를 무시할 수 있는지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
|
imqJMSExpiration
|
JMSExpiration의 무시하는 값(밀리초)입니다.
|
long
|
0
(만료 없음)
|
|
imqOverrideJMSPriority
|
클라이언트에서 설정한 JMSPriority 필드를 무시할 수 있는지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
|
imqJMSPriority
|
JMSPriority의 무시하는 값(0에서 9까지의 정수)입니다.
|
정수
|
4 (일반)
|
|
imqOverrideJMSHeadersTo
TemporaryDestinations
|
무시가 임시 대상에 적용되는지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
안정성 및 흐름 제어
표 16-7에는 안정성 및 흐름 제어를 구성하는 연결 팩토리 속성이 나열되어 있습니다.
표 16-7 연결 팩토리 속성: 안정성 및 흐름 제어
|
속성 이름
|
설명
|
유형
|
기본값
|
|
imqAckTimeout
|
클라이언트 런타임이 브로커 응답을 기다리는 최대 시간(밀리초)입니다. 이 시간이 초과되면 예외가 발생합니다. 값이 0이면 시간 초과가 발생하지 않고 클라이언트 런타임이 계속해서 대기합니다.
이 값이 너무 낮아 클라이언트 런타임이 시간 초과하는 경우도 있습니다. 예를 들어, 브로커가 LDAP 사용자 저장소와 보안(SSL) 연결을 사용하여 인증하는 각 사용자에 대해 첫 번째 인증이 30초 이상 걸릴 수 있습니다.
|
문자열
|
0
|
|
imqAckOnProduce
|
브로커가 생성자 클라이언트의 메시지에 응답하는 방법을 지정하는 문자열입니다.
이 속성을 true로 설정하면 브로커는 생성자 클라이언트로부터 수신하는 모든 JMS 메시지(지속성 및 비지속성)에 응답합니다. 이러한 응답을 대기하는 동안에는 생성자 클라이언트 스레드가 차단됩니다.
이 속성을 지정하지 않은 경우 브로커는 지속성 메시지에만 응답합니다. 이러한 응답을 대기하는 동안에는 생성자 클라이언트 스레드가 차단됩니다.
|
문자열
|
지정안 됨
|
|
imqConnectionFlowCount
|
측정된 일괄 처리의 JMS 메시지 수입니다. 이 JMS 메시지 수가 클라이언트 런타임에 전달되면 전달이 일시적으로 중단되어 보류된 제어 메시지를 모두 전달할 수 있도록 합니다. 클라이언트 런타임의 알림 메시지가 도착하면 페이로드 메시지 전달이 다시 시작되어 지정된 수에 이를 때까지 계속됩니다.
지정된 수가 0이면 측정된 일괄 처리에서 JMS 메시지의 수에 제한이 없습니다. 0이 아닌 값을 설정하면 클라이언트 런타임에서 메시지 흐름을 측정하여 JMS 메시지 전달 폭주로 인해 Message Queue 제어 메시지가 차단되지 않도록 합니다.
|
정수
|
100
|
|
imqConnectionFlowLimit
Enabled
|
imqConnectionFlowLimit 값을 사용하여 연결 수준에서 메시지 흐름을 제한할지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
|
imqConnectionFlowLimit
|
연결을 통해 전달되고 클라이언트 런타임에 버퍼링되어 사용 대기 중일 수 있는 최대 메시지 수입니다. 하지만 imqConnectionFlowIsLimited가 사용 가능한 경우에만 이 제한을 선택할 수 있습니다.
imqConnectionFlowCount에서 관리하는 흐름 측정에 따라 클라이언트 런타임으로 전달되는 JMS 메시지의 수가 이 제한을 초과하면 메시지 전달이 중지됩니다. 사용되지 않는 메시지의 수가 이 속성의 설정 값보다 낮아지는 경우에만 메시지 전달이 다시 시작됩니다.
이 제한은 메시지 처리 시간이 오래 걸리는 사용자 클라이언트에 대기 중인 메시지가 너무 많아 메모리 부족이 발생하는 것을 방지합니다.
|
정수
|
1000
|
|
imqConsumerFlowLimit
|
연결을 통해 전달되고 클라이언트 런타임에 버퍼링되어 사용 대기 중일 수 있는 사용자별 최대 메시지 수입니다. 이 제한은 다중 사용자 대기열 전달의 경우 사용자 간의 로드 균형 조정을 향상시키는 데 사용됩니다(한 사용자에게 보내는 메시지 수의 불균형 방지). 브로커 쪽에서 대기열의 consumerFlowLimit 속성 값을 더 낮게 설정하여 이 제한을 무시할 수 있습니다(Message Queue 관리 설명서의 대상 속성 정보 참조).
또한 이 제한을 사용하면 연결된 한 사용자가 연결된 다른 사용자에 비해 메시지가 폭주하는 것을 막을 수 있습니다.
어떤 사용자에 대해서도 클라이언트 런타임에 전달되는 JMS 메시지의 수가 이 제한을 초과하면 해당 사용자에 대한 메시지 전달이 중단됩니다. 해당 사용자의 사용되지 않은 메시지 수가 imqConsumerFlowThreshold에 설정된 값 이하로 떨어져야만 메시지 전달이 재개됩니다.
특정 연결에서 모든 사용자에 대해 버퍼링된 전체 메시지 수가 imqConnectionFlowLimit을 초과하면 전체 메시지 수가 연결 제한 이하로 떨어질 때까지 해당 연결을 통한 메시지 전달이 중단됩니다.
|
정수
|
100
|
|
imqConsumerFlow
Threshold
|
클라이언트 런타임에 버퍼링된 사용자당 메시지의 수를 imqConsumerFlowLimit에 대한 백분율로 지정하는데 이 값보다 낮으면 해당 사용자에 대한 메시지 전달이 다시 시작됩니다.
|
정수
|
50
|
대기열 브라우저 동작 및 서버 세션
표 16-8에는 대기열에서 클라이언트 찾아보기에 영향을 미치는 속성이 설명되어 있습니다.
표 16-8 연결 팩토리 속성: 대기열 브라우저 동작
|
속성 이름
|
설명
|
유형
|
기본값
|
|
imqQueueBrowserMax
MessagesPerRetrieve
|
대기열 대상의 내용을 찾아볼 때 클라이언트 런타임이 한 번에 검색하는 메시지의 최대 수입니다.
|
정수
|
1000
|
|
imqQueueBrowserRetrieveTimeout
|
대기열 대상의 내용을 찾아볼 때 클라이언트 런타임이 예외를 발생하기 전에 메시지 검색을 대기하는 최대 시간(밀리초)입니다.
|
long
|
60000
|
|
imqLoadMaxToServerSession
|
JMS 응용 프로그램 서버 기능의 경우 Message Queue 연결 사용자가 ServerSession의 세션에서 maxMessages 메시지 수까지 로드해야 하는지 여부를 지정하는 부울 값입니다. 값이 false이면 클라이언트는 한 번에 하나의 메시지만 로드합니다.
|
|
true
|
JMS 정의 등록 정보 지원
JMS 정의 등록 정보는 JMS에 의해 예약되고 클라이언트 프로그래밍 기능 향상 지원을 위해 JMS 공급자가 선택할 수 있는 이름입니다. Message Queue에서 지원되는 JMS 정의 등록 정보에 대한 설명은 표 16-9에 나와 있습니다.
표 16-9 연결 팩토리 속성: JMS 정의 등록 정보 지원
|
등록 정보 이름
|
설명
|
유형
|
기본값
|
|
imqSetJMSXUserID
|
생성된 메시지에 대해 JMS 정의 등록 정보 JMSXUserID(메시지를 보내는 사용자의 아이디)를 설정할지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
|
imqSetJMSXAppID
|
생성된 메시지에 대해 JMS 정의 등록 정보 JMSXAppID(메시지를 보내는 응용 프로그램의 아이디)를 설정할지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
|
imqSetJMSXProducerTXID
|
생성된 메시지에 대해 JMS 정의 등록 정보 JMSXProducerTXID
(이 메시지를 생성한 트랜잭션의 트랜잭션 아이디)를 설정할지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
|
imqSetJMSXConsumerTXID
|
사용된 메시지에 대해 JMS 정의 등록 정보 JMSXConsumerTXID
(이 메시지를 사용한 트랜잭션의 트랜잭션 아이디)를 설정할지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
|
imqSetJMSXRcvTimestamp
|
사용된 메시지에 대해 JMS 정의 등록 정보 JMSXRcvTimestamp
(메시지가 사용자에게 전달되는 시간)를 설정할지 여부를 지정하는 부울 값입니다.
|
부울
|
false
|
SOAP 종점 속성
표 16-10에는 SOAP를 사용하는 응용 프로그램의 종점 URL을 구성하는 속성이 나열되어 있습니다. SOAP를 사용하는 응용 프로그램에 대한 자세한 내용은 Message Queue Developer’s Guide for Java Clients를 참조하십시오.
표 16-10 SOAP 종점 속성
|
속성 이름
|
설명
|
유형
|
기본값
|
|
imqSOAPEndpointList
|
메시지를 보낼 SOAP 종점을 나타내는 많은 공백으로 구분된 URL 중 하나의 목록입니다.
URL을 두 개 이상 지정하면 메시지가 목록에 있는 모든 URL로 브로드캐스트됩니다. 각 URL은 서블릿에 연결되어 있어야 SOAP 메시지를 받아서 처리할 수 있습니다.
예:
http://www.myServlet/ http://www.myServlet2/
|
문자열
|
|
|
imqEndpointName
|
SOAP 종점의 이름입니다.
예: MyTopicEndpoint
|
문자열
|
Untitled_
Endpoint_
Object
|
|
imqEndpointDescription
|
SOAP 종점에 대한 설명입니다.
예:
"imqEndpointDescription=my endpoints for broadcast"
|
문자열
|
종점 객체에 대한 설명
|
