Sun Java 로고     이전      목차      색인      다음     

Sun 로고
Sun Java System Message Queue 3 2005Q1 관리 설명서 

16장
관리 대상 객체 속성 참조

이 장에서는 관리 대상 객체의 속성에 대한 참조 정보를 제공합니다. 이 장은 다음 내용으로 구성되어 있습니다.


대상 등록 정보

표 16-1에는 대상 관리 대상 객체를 구성하는 속성이 나열되어 있습니다.

표 16-1 대상 관리 대상 객체 속성 

속성 이름

설명

유형

기본값

imqDestinationDescription

대상 객체의 설명

문자열

없음

imqDestinationName

물리적 대상의 이름

문자열1

Untitled_Destination_Object

1대상 이름은 영문자와 숫자만 포함할 수 있으며(공백 없음) 영문자 또는 "_" 문자나 "$" 문자로 시작해야 합니다.


연결 팩토리 속성

이 절에는 연결 팩토리 관리 대상 객체를 구성하는 속성에 대한 참조 정보가 포함되어 있습니다. 속성은 다음과 같은 내용으로 분류됩니다.

표 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"

문자열

종점 객체에 대한 설명



이전      목차      색인      다음     


부품 번호: 819-2218.   Copyright 2005 Sun Microsystems, Inc. 모든 권리는 저작권자의 소유입니다.