메시지 리스너 서비스 사용자 정의 특성
이 분할창을 사용하여 메시지 리스너 서비스의 사용자 정의 특성을 보거나 변경하십시오.
이 관리 콘솔 페이지를 보려면 을 클릭하십시오.
- DYNAMIC.CONFIGURATION.ENABLED
ENABLE.ZOS.LP.RECOVERY
- MAX.RECOVERY.RETRIES
- MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH
- MQJMS.POOLING.THRESHOLD
- MQJMS.POOLING.TIMEOUT
- NON.ASF.RECEIVE.TIMEOUT
- NON.ASF.BMT.ROLLBACK.ENABLED
- RECOVERY.RETRY.INTERVAL
- SERVER.SESSION.POOL.REAP.TIME
- SERVER.SESSION.POOL.UNUSED.TIMEOUT
- SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname
DYNAMIC.CONFIGURATION.ENABLED
이 특성은 리스너 포트가 작성되는 애플리케이션 서버를 다시 시작해야 하는지 여부를 제어합니다. 동적 구성을 사용 가능하게 하려면 이 특성을 true로 설정하십시오.
정보 | 값 |
---|---|
데이터 유형 | 부울 |
기본값 | False(선택하지 않음) |
![[z/OS]](../images/ngzos.gif)
ENABLE.ZOS.LP.RECOVERY
이 특성은 애플리케이션 서버가 WebSphere MQ for z/OS에 연결된 경우 리스너 포트 동작을 제어합니다.
- 애플리케이션 서버와 WebSphere MQ 간의 연결이 끊어진 경우(예: 큐 관리자가 중지된 경우) 복구를 시도하는 리스너 포트입니다. 이 특성을 사용하지 않을 경우 큐 관리자가 중지된 후에 리스너 포트가 복구를 시도하지 않습니다.
- 리스너 포트에 대해 다중 워크로드 관리 분류 구성. 이 특성을 사용하지 않을 경우 리스너 포트에 대한 다중 워크로드 관리 분류가 구성되어 있으면 메시지가 WebSphere MQ 큐에 남아 있습니다.
특성을 추가한 후 서버를 다시 시작하십시오.
바인딩 연결을 통해 WebSphere MQ for z/OS에 연결된 경우 WebSphere MQ 버전 6.0.2.4에서 제공된 WebSphere MQ APAR PK53912도 적용해야 합니다.
정보 | 값 |
---|---|
데이터 유형 | 부울 |
기본값 | True(사용 가능) |
MAX.RECOVERY.RETRIES
이 서비스로 관리되는 리스너 포트가 포기하고 중지하기 전에 실패로부터 복구하려고 시도하는 최대 횟수입니다. 중지되면 연관된 리스너 포트가 중지 상태로 변경됩니다. RECOVERY.RETRY.INTERVAL 특성에서 재시도 간격을 정의합니다.
- 리스너 포트가 JMS 제공자로부터 메시지를 가져올 때 예기치 않은 오류가 발생했습니다.
- 대개 네트워크 오류때문에 애플리케이션 서버와 JMS 제공자 간의 연결이 끊어졌습니다.
정보 | 값 |
---|---|
데이터 유형 | 정수 |
단위 | 재시도 횟수 |
기본값 | 5 |
범위 | 0(재시도 안함) - 2147483647 |
MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH
낮은 메시지 임계값에 도달할 때 제어기 메시지 처리가 계속될 수 있게 하는 감속 표시기입니다. 사용자 정의 특성 MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH의 값을 "true"로 설정하여 메시지 리스너 서비스를 구성한 경우 낮은 임계값은 높은 임계값(리스너 포트의 외부에서 설정된 최대 세션 수 특성임)으로 내부에서 설정됩니다.
정보 | 값 |
---|---|
데이터 유형 | 문자열 |
기본값 | true |
MQJMS.POOLING.THRESHOLD
풀의 사용되지 않는 최소 연결 수.
MQSimpleConnectionManager는 가장 최근에 사용된 연결을 할당하고 가장 늦게 사용된 연결을 제거합니다. 기본적으로 풀에서 사용되지 않은 연결이 10개 이상 있는 경우 연결이 제거됩니다.
정보 | 값 |
---|---|
데이터 유형 | 정수 |
단위 | 연결의 수 |
기본값 | 10 |
MQJMS.POOLING.TIMEOUT
연결을 사용하지 않는 경우, 풀에서 연결이 제거된 후의 시간(밀리초)입니다.
MQSimpleConnectionManager는 가장 최근에 사용된 연결을 할당하고 가장 늦게 사용된 연결을 제거합니다. 기본값으로, 연결이 5분 동안 사용되지 않는 경우 연결은 제거됩니다.
정보 | 값 |
---|---|
데이터 유형 | 정수 |
단위 | 밀리초 |
기본값 | 5분 |
NON.ASF.RECEIVE.TIMEOUT
비ASF 모드 조작에서 메시지 구동 Bean 리스너 세션이 수행한 동기 메시지 수신의 제한시간(밀리초)입니다.
- ASF 모드는 애플리케이션에 동시성과 트랜잭션 지원을 제공합니다. 공개/등록 메시지 구동 Bean의 경우, 비ASF 모드에서 리스너는 단일 스레드되기 때문에 ASF 모드는 더 나은 처리량 및 동시성을 제공합니다.
- 비ASF 모드는 주로 JMS 스펙에 대한 선택적 확장인 JMS ASF를 지원하지 않는 써드파티 메시징 제공자와 함께 사용됩니다. 비ASF 모드 또한 트랜잭션형이지만 경로 길이가 ASF 모드보다 짧기 때문에 일반적으로 향상된 성능을 제공합니다.
애플리케이션 서버의 모든 메시지 구동 Bean 리스너에 대해 비ASF 모드 조작을 사용 가능하게 하려면 이 특성을 0이 아닌 값으로 설정하십시오.
비ASF 모드는 z/OS 시스템에서 선택할 수 없으므로 이 경우 이 특성에 0이 아닌 값은 설정하지 마십시오.
메시징 시스템을 비ASF 모드로 실행 중인 경우에 트랜잭션 제한시간이 원치 않게 초과되지 않도록 하려면 전체 트랜잭션 지속 시간 제한시간에 도달하기 전에 처리가 완료될 수 있을 정도로 처리 시간이 충분해야 합니다. 그러므로 NON.ASF.RECEIVE.TIMEOUT 메시지 리스너 서비스 사용자 정의 특성에 지정하는 값이 전체 트랜잭션 지속 시간 제한시간에 지정하는 값보다 더 작은지, 그리고 이 두 가지 특성 값 간의 차이가 MDB(Message-Driven Bean)의 onMessage() 메소드가 메시지를 처리하는 데 필요한 시간보다 더 큰지를 확인해야 합니다.
예를 들어 메시지 구동 Bean onMessage() 메소드에 일반적으로 최대 10초가 걸리고 트랜잭션 제한시간이 120초로 설정된 경우 NON.ASF.RECEIVE.TIMEOUT 특성을 110000밀리초(110초)로 설정할 수 있습니다.
정보 | 값 |
---|---|
데이터 유형 | 정수 |
단위 | 밀리초 |
기본값 | ASF 모드(사용자 정의 특성을 작성하지 않음) |
범위 | 0 이상 밀리초
|
NON.ASF.BMT.ROLLBACK.ENABLED
NON.ASF.RECEIVE.TIMEOUT 특성을 0이 아닌 값으로 설정했기 때문에 비ASF(애플리케이션 서버 Facilities) 모드 조작을 사용하고 있고 Bean 관리 트랜잭션을 사용하는 메시지 구동 Bean에서 런타임 예외를 생성하는 경우 NON.ASF.BMT.ROLLBACK.ENABLED 특성은 메시지가 대상으로 리턴되는지 여부를 판별합니다.
- ASF 모드는 애플리케이션에 동시성과 트랜잭션 지원을 제공합니다. 공개/등록 메시지 구동 Bean의 경우, 비ASF 모드에서 리스너는 단일 스레드되기 때문에 ASF 모드는 더 나은 처리량 및 동시성을 제공합니다.
- 비ASF 모드는 주로 JMS 스펙에 대한 선택적 확장인 JMS ASF를 지원하지 않는 써드파티 메시징 제공자와 함께 사용됩니다. 비ASF 모드 또한 트랜잭션형이지만 경로 길이가 ASF 모드보다 짧기 때문에 일반적으로 향상된 성능을 제공합니다.
z/OS 시스템에서는 비ASF 모드를 선택할 수 없습니다.
이 특성을 false(기본값)로 설정한 경우 이 메시지가 메시지 구동 Bean에 전달되기 전에 자동으로 수신확인됩니다.
이 특성을 true로 설정한 경우 메시지 구동 Bean에서 메시지를 성공적으로 처리한 후 메시지 리스너 서비스가 메시지 수신확인을 클라이언트에 전송하고, 메시지 리스너 서비스가 Bean에서 예외를 생성한 메시지의 복구를 요청합니다.
정보 | 값 |
---|---|
데이터 유형 | 부울 |
기본값 | false |
RECOVERY.RETRY.INTERVAL
실패로부터 복구하기 위해 리스너 포트가 수행하는 재시도 사이의 시간(초)입니다. MAX.RECOVERY.RETRIES 특성에서 최대 재시도 횟수를 정의합니다.
- 리스너 포트가 JMS 제공자로부터 메시지를 가져올 때 예기치 않은 오류가 발생했습니다.
- 대개 네트워크 오류때문에 애플리케이션 서버와 JMS 제공자 간의 연결이 끊어졌습니다.
정보 | 값 |
---|---|
데이터 유형 | 정수 |
단위 | 초 |
기본값 | 60 |
범위 | 1 - 2147483647 |
SERVER.SESSION.POOL.REAP.TIME
서버 세션 풀의 검사 간 시간(초)입니다. 서버 세션 풀 모니터링을 활성화하려면 이 특성을 음수가 아닌 값으로 설정하십시오.
메시징 시스템이 비ASF 모드에서 실행 중인 경우 SERVER.SESSION.POOL.REAP.TIME 사용자 정의 특성을 적용할 수 없습니다.
정보 | 값 |
---|---|
데이터 유형 | 정수 |
단위 | 초 |
기본값 | -1(사용 안함) |
범위 | -2147483648 - 2147483647 |
SERVER.SESSION.POOL.UNUSED.TIMEOUT
기본 서버 세션 풀 제한시간(초)입니다.
이 특성을 음수가 아닌 값으로 설정하면 서버 세션을 사용한 이후 경과한 시간과 비교합니다. 제한시간 값이 경과한 시간보다 작을 경우 서버 세션 풀에서 서버 세션이 제거되고 해당 JMS 세션이 JMS 세션 풀로 리턴됩니다. 예를 들어 제한시간 값이 1초이고 특정 서버 세션을 시작한 후 경과한 시간이 2초일 경우 해당 서버 세션이 서버 세션 풀에서 제거되고 해당 JMS 세션이 JMS 세션 풀로 리턴됩니다.
메시징 시스템이 비ASF 모드에서 실행 중인 경우 SERVER.SESSION.POOL.UNUSED.TIMEOUT 사용자 정의 특성을 적용할 수 없습니다.
정보 | 값 |
---|---|
데이터 유형 | 정수 |
단위 | 초 |
기본값 | -1(사용 안함) |
범위 | -2147483648 - 2147483647 |
SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname
lpname에 정의된 이름을 가진 리스너 포트의 경우 이 특성이 기본 SERVER.SESSION.POOL.UNUSED.TIMEOUT 값을 대체합니다. 이 값은 지정된 리스너 포트를 사용하는 모든 메시지 구동 Bean에 적용됩니다.
이 특성이 음수가 아닌 값으로 설정된 경우 SERVER.SESSION.POOL.UNUSED.TIMEOUT 특성이 음수 값을 갖고 있더라도 이 특성이 SERVER.SESSION.POOL.UNUSED.TIMEOUT 특성을 대체합니다.
이 특성이 음수 값으로 설정된 경우 지정된 리스너 포트의 서버 세션 풀 모니터링이 비활성화됩니다.
메시징 시스템이 비ASF 모드에서 실행 중인 경우 SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname 사용자 정의 특성을 적용할 수 없습니다.
정보 | 값 |
---|---|
데이터 유형 | 정수 |
단위 | 초 |
기본값 | 설정되지 않음 |
범위 | -2147483648 - 2147483647 |