Пользовательские свойства службы обработчика сообщений

На этой панели можно просмотреть или изменить пользовательские свойства службы обработчика сообщений.

Для того чтобы открыть эту страницу административной консоли, выберите Серверы > Типы серверов > Серверы приложений WebSphere > имя_сервера > [Соединения] Служба сообщений > Служба получателя сообщений > Пользовательские свойства.

На странице Пользовательские свойства можно задать следующие свойства службы обработчика сообщений:

DYNAMIC.CONFIGURATION.ENABLED

Это свойство управляет перезапуском сервера приложений, на котором создается порт получателя. Для разрешения динамической настройки задайте значение этого свойства как true.

Информация Значение
Тип данных Булевское значение
Значение по умолчанию False (не выбрано)
[z/OS]

ENABLE.ZOS.LP.RECOVERY

Это свойство управляет работой порта обработчика, когда сервер приложений подсоединяется к IBM MQ for z/OS.

Включите это свойство, если для среды требуются следующие возможности:
  • Попытка порта обработчика восстановить соединение между сервером приложений и IBM MQ после нарушения, например, из-за остановки администратора очередей. Если это свойство выключено, то порт обработчика не будет пытаться восстановить соединение после остановки администратора очередей.
  • Настройка нескольких классификаций управления нагрузкой для порта обработчика. Если это свойство выключено, то в случае настройки нескольких классификаций управления нагрузкой для порта обработчика сообщения останутся в очереди IBM MQ.

После задания свойства перезапустите сервер.

При подсоединении к WebSphere MQ for z/OS с помощью соединений с привязками также необходимо использовать компонент WebSphere MQ APAR PK53912, включенный в WebSphere MQ версии 6.0.2.4.

Информация Значение
Тип данных Булевское значение
Значение по умолчанию Истина (включено)

MAX.RECOVERY.RETRIES

Максимальное число попыток порта приемника, управляемого этой службой, выполнить восстановление после сбоя, прежде чем отказаться от дальнейших попыток и прекратить работу. При прекращении работы порт приемника переходит в состояние Остановлен. Интервал между повторными попытками определяется свойством RECOVERY.RETRY.INTERVAL.

Возможные причины следующие:
  • При попытке порта приемника получить сообщение от провайдера JMS произошла непредвиденная ошибка.
  • Соединение между сервером приложений и провайдером JMS прервано - скорее всего, из-за ошибки сети.
Информация Значение
Тип данных Целое число
Единицы измерения Повторные попытки
Значение по умолчанию 5
Диапазон От 0 (повторные попытки не выполняются) до 2147483647

MQJMS.POOLING.THRESHOLD

Максимальное число простаивающих соединений в пуле.

MQSimpleConnectionManager выделяет соединения, начиная с соединений с наименьшим временем простоя, и уничтожает соединения, начиная с соединений с наибольшим временем простоя. По умолчанию соединение уничтожается, если в пуле больше десяти простаивающих соединений.

Информация Значение
Тип данных Целое число
Единицы измерения Число соединений
Значение по умолчанию 10

MQJMS.POOLING.TIMEOUT

Время в миллисекундах, по окончании которого соединение пула, простаивавшее в течение всего этого времени, уничтожается.

MQSimpleConnectionManager выделяет соединения, начиная с соединений с наименьшим временем простоя, и уничтожает соединения, начиная с соединений с наибольшим временем простоя. По умолчанию соединение уничтожается, если оно простаивало пять минут.

Информация Значение
Тип данных Целое число
Единицы измерения Миллисекунды
Значение по умолчанию 5 минут

NON.ASF.RECEIVE.TIMEOUT

Тайм-аут в миллисекундах для синхронного приема сообщений, выполняемого сеансами приемника объекта EJB, управляемого сообщениями, в режиме работы не-ASF.

Прим.: У службы приемника сообщений два режима работы: Application Server Facilities (ASF) и отличный от Application Server Facilities (не-ASF):
  • Режим ASF обеспечивает параллельность и поддержку транзакций для приложений. Для управляемых сообщениями объектов EJB, относящихся к публикации и подписке, режим ASF обеспечивает более высокие пропускную способность и коэффициент параллельности, поскольку в режиме не-ASF приемник работает с одной нитью.
  • Режим не-ASF в основном предназначен для работы с другими провайдерами обмена сообщениями, не поддерживающими ASF JMS, представляющее собой необязательное расширение спецификации JMS. Режим не-ASF также поддерживает транзакции, но, поскольку путь короче, чем в режиме ASF, производительность в режиме не-ASF обычно выше.

Указывать ненулевое значение в этом свойстве следует только в том случае, если на сервере приложений должен быть включен режим работы не-ASF для всех получателей сообщений для объектов EJB, управляемых сообщениями.

[z/OS] Поскольку в системах z/OS режим не-ASF не поддерживается, для этого свойства не следует указывать значение, отличное от нуля.

Если система обмена сообщениями работает в режиме без ASF, то во избежание нежелательных тайм-аутов транзакций вы должны выделить достаточное время на обработку, прежде чем будет достигнут тайм-аут общей продолжительности транзакции. Таким образом, вы должны проследить за тем, чтобы значение настраиваемого свойства службы получателей сообщений, NON.ASF.RECEIVE.TIMEOUT, было меньше значения свойства службы транзакций, Тайм-аут общей продолжительности транзакции, и разность между этими значениями превышала время, которое требуется методу onMessage() объекта EJB, управляемого сообщениями (MDB), на обработку сообщения.

Например, если метод onMessage() объекта EJB, управляемого сообщениями, обычно выполняется максимум за 10 секунд, а тайм-аут транзакции задан равным 120 секундам, то укажите в свойстве NON.ASF.RECEIVE.TIMEOUT значение не более 110000 миллисекунд (110 секунд).

Информация Значение
Тип данных Целое число
Единицы измерения Миллисекунды
Значение по умолчанию Режим ASF (пользовательское свойство не создается)
Диапазон 0 или большее значение в миллисекундах
0
Режим вместо ASF выключен
1 или выше
Тайм-аут в миллисекундах для синхронного приема сообщений, выполняемого сеансами приемника объекта EJB, управляемого сообщениями, в режиме не-ASF

NON.ASF.BMT.ROLLBACK.ENABLED

Если режиме без поддержки ASF (для свойства NON.ASF.RECEIVE.TIMEOUT указано значение, отличное от нуля) объект, управляемый сообщениями, использующий транзакции, управляемые объектами EJB, выбросит исключение, то свойство NON.ASF.BMT.ROLLBACK.ENABLED управляет возвратом сообщений получателю.

Прим.: У службы приемника сообщений два режима работы: Application Server Facilities (ASF) и отличный от Application Server Facilities (не-ASF):
  • Режим ASF обеспечивает параллельность и поддержку транзакций для приложений. Для управляемых сообщениями объектов EJB, относящихся к публикации и подписке, режим ASF обеспечивает более высокие пропускную способность и коэффициент параллельности, поскольку в режиме не-ASF приемник работает с одной нитью.
  • Режим не-ASF в основном предназначен для работы с другими провайдерами обмена сообщениями, не поддерживающими ASF JMS, представляющее собой необязательное расширение спецификации JMS. Режим не-ASF также поддерживает транзакции, но, поскольку путь короче, чем в режиме ASF, производительность в режиме не-ASF обычно выше.

[z/OS] В системах z/OS режим не-ASF не поддерживается

Когда это свойство имеет значение false (применяется по умолчанию), сообщение перед передачей управляемому сообщениями объекту EJB автоматически подтверждается.

Когда это свойство имеет значение true, служба обработчика сообщений отправляет подтверждение получения сообщения клиенту после успешной обработки сообщения управляемым сообщениями объектом EJB и запрашивает восстановление сообщений, при которых объект EJB вызвал исключительную ситуацию.

Информация Значение
Тип данных Булевское значение
Значение по умолчанию Ложь

RECOVERY.RETRY.INTERVAL

Время в секундах между повторными попытками порта приемника выполнить восстановление после сбоя. Максимальное число повторных попыток определяется свойством MAX.RECOVERY.RETRIES.

Возможные причины следующие:
  • При попытке порта приемника получить сообщение от провайдера JMS произошла непредвиденная ошибка.
  • Соединение между сервером приложений и провайдером JMS прервано - скорее всего, из-за ошибки сети.
Информация Значение
Тип данных Целое число
Единицы измерения сек
Значение по умолчанию 60
Диапазон От 1 до 2147483647

SERVER.SESSION.POOL.REAP.TIME

Это время в секундах между проверками пулов сеансов сервера. Для отслеживания пулов сеансов сервера задайте этому свойству неотрицательное значение.

Пользовательское свойство SERVER.SESSION.POOL.REAP.TIME применимо только в том случае, если система обмена сообщениями работает в режиме ASF.

Информация Значение
Тип данных Целое число
Единицы измерения сек
Значение по умолчанию -1 (выключено)
Диапазон От -2147483648 до 2147483647

SERVER.SESSION.POOL.UNUSED.TIMEOUT

Это тайм-аут пула сеансов сервера по умолчанию в секундах.

Если для этого свойства указано неотрицательное значение, то оно сравнивается с временем, прошедшим с момента использования сеанса сервера. Если значение тайм-аута меньше прошедшего времени, то сеанс сервера удаляется из пула сеансов сервера и его сеанс JMS возвращается в пул сеансов JMS. Например, если значение тайм-аута одна секунда, а время с момента использования конкретного сеанса сервера равно двум секундам, то этот сеанс сервера удаляется из пула сеансов сервера и его сеанс JMS возвращается в пул сеансов JMS.

Пользовательское свойство SERVER.SESSION.POOL.UNUSED.TIMEOUT применимо только в том случае, если система обмена сообщениями работает в режиме ASF.

Информация Значение
Тип данных Целое число
Единицы измерения сек
Значение по умолчанию -1 (выключено)
Диапазон От -2147483648 до 2147483647

SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname

Это свойство переопределяет значение SERVER.SESSION.POOL.UNUSED.TIMEOUT по умолчанию для порта обработчика с именем lpname. Оно применяется ко всем управляемым сообщениями объектам EJB, использующим данный порт обработчика.

Если это значение неотрицательное, то оно переопределяет значение SERVER.SESSION.POOL.UNUSED.TIMEOUT, даже если значение SERVER.SESSION.POOL.UNUSED.TIMEOUT отрицательное.

Если же это значение отрицательное, то отслеживание пулов сеансов сервера для данного порта обработчика выключается.

Пользовательское свойство SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname применимо только в том случае, если система обмена сообщениями работает в режиме ASF.

Информация Значение
Тип данных Целое число
Единицы измерения сек
Значение по умолчанию Не задан
Диапазон От -2147483648 до 2147483647


Имя файла: umb_prolscp.html