Спецификация активации JMS [Параметры]

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

Для просмотра этой панели консоли выберите один из следующих путей:
  • Ресурсы > JMS > Спецификации активации > имя-спецификации-активации
  • Ресурсы > JMS > Поставщики JMS > провайдер_сообщений > [Дополнительные свойства] Спецификации активации > имя-спецификации-активации
С помощью этой панели можно просмотреть или изменить параметры конфигурации выбранной спецификации активации JMS для работы с провайдером обмена сообщениями по умолчанию.

Создайте спецификацию активации JMS, если необходимо использовать управляемые сообщениями объекты EJB для взаимодействия с провайдером обмена сообщениями по умолчанию с помощью Java™ Connector Architecture (JCA) 1.5. JCA обеспечивает взаимодействие Java между серверами приложений, такими как WebSphere Application Server и информационными системами предприятия. Она предоставляет стандартный способ интеграции провайдеров JMS в серверы приложений Java EE, а также среды обмена данными с информационными системами, предусматривающими передачу данных в виде сообщений.

Все свойства конфигурации спецификации активации за исключением Имя, Имя JNDI, Имя назначения JNDI и Псевдоним идентификации, переопределяются свойствами из конфигурации активации файла описания связанного объекта EJB 2.1 или более поздней версии, управляемого сообщениями. В случае объектов EJB 2.0 значениями из файла описания переопределяются свойства Тип получателя, Надежность подписки, Режим подтверждения и Селектор сообщений. В обоих случаях свойство Имя получателя JNDI можно переопределить значением из связываний объекта EJB, управляемого сообщениями.

Свойства спецификации активации влияют на то, как провайдер обмена сообщениями по умолчанию выбирает модуль обмена сообщениями, к которому подключено приложение JavaBean, управляемое сообщениями. По умолчанию среда автоматически подключает приложения к доступной в шине службе обмена сообщениями. При необходимости можно указать дополнительные параметры конфигурации для настройки процесса подключения; например, задать специальные серверы начальной загрузки или запретить подключение к отдельным службам обмена сообщениями или повысить доступность или производительность или обеспечить последовательную обработку входящих сообщений. Более подробная информация о том, как это сделать, находится в разделе Как приложения JMS подключаются к модулю обмена сообщениями в шине (в сети).


Ссылки, помеченные как (в сети), требуют подключения к Internet. Каждая ссылка вызывает поиск раздела в сетевом information center. Когда будут показаны результаты поиска, выберите раздел, наиболее соответствующий вашей конфигурации.

Проверьте наличие обновлений этого раздела (в сети)

Вкладка Конфигурация

На вкладке Конфигурация показаны свойства конфигурации объекта. Значения данных свойств сохраняются даже при остановке и перезапуске среды выполнения. Инструкции по применению изменений конфигурации к среде выполнения приведены в описании задач в справочной системе Information Center.

Общие свойства

Область

Наивысший уровень топологии, на котором серверам приложений разрешено использовать этот объект ресурса.

Обязательное Нет
Тип данных Текст

Провайдер

Провайдер JMS, который обеспечивает асинхронный обмен сообщениями с помощью Службы сообщений Java (JMS). Он предоставляет фабрики соединений J2EE для создания соединений целевых объектов очередей или разделов JMS. Административные объекты провайдера JMS применяются для управления ресурсами JMS связанного провайдера JMS.

Обязательное Нет
Тип данных Текст

Имя

Обязательный параметр - отображаемое имя ресурса.

Обязательное Да
Тип данных Текст

Имя JNDI

Имя JNDI ресурса.

Введите имя JNDI, указанное в связываниях управляемых сообщениями объектов JavaBean для этой спецификацией активации.
Обязательное Да
Тип данных Текст

Описание

Необязательное описание ресурса.

Обязательное Нет
Тип данных Область текста

Тип получателя

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

Обязательное Да
Тип данных выпадающий список
Диапазон значений
Очередь
Очередь JMS используется объектом EJB, управляемым сообщениями. Имя JNDI очереди JMS указано в параметре Имя JNDI получателя.

Раздел
Раздел JMS используется объектом EJB, управляемым сообщениями. Имя JNDI раздела JMS указано в свойстве Имя JNDI получателя.

Имя JNDI получателя

Имя JNDI получателя

Введите имя JNDI, которое использует объект JavaBean, управляемый сообщениями, для поиска назначения JMS в пространстве имен JNDI.

Выберите тип назначения в свойстве Тип получателя.

Обязательное Да
Тип данных Текст

Селектор сообщений

Селектор сообщений JMS, определяющий сообщения, получаемые объектом EJB, управляемым сообщениями. В качестве значения указывается строка, применяемая для выбора отдельных доступных сообщений. Формат строки соответствует подмножеству синтаксиса условных выражений SQL 92, описанного в спецификации JMS. Подробности см. в справочной системе Information Center.

Например:
JMSType='car' AND color='blue' AND weight>2500

Строка селектора может ссылаться на поля в заголовке сообщения JMS и в свойствах сообщения. Селекторы сообщений не могут ссылаться на значения тела сообщения.

Пустое значение (пустая строка) указывает на отсутствие селектора сообщения для приемника сообщения.

Обязательное Нет
Тип данных Текст

Имя шины

Имя шины, к которой нужно подключиться.

Введите имя шины интеграции служб, с которой установлены соединения. Это должно быть имя шины, на которой определено назначение, указанное в свойстве Имя JNDI получателя.
Обязательное Нет
Тип данных Настраиваемый

Режим уведомления

Способ уведомления о получении сообщений.

Режим подтверждения приема указывает на способ подтверждения приема сообщения, полученного объектом JavaBean, управляемым сообщениями.
Прим.:

Подтверждение отправляется при удалении сообщения.

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

Сообщение удаляется при запуске объекта JavaBean, если для свойства качества службы задано значение оптимальное временное. При других значениях сообщение удаляется после выполнения объекта.

Обязательное Нет
Тип данных выпадающий список
Диапазон значений
Автоматическое уведомление
В сеансе выполняется автоматическое подтверждение доставки сообщений.

Автоматическое уведомление об успешном копировании
Подтверждение доставки сообщений выполняется сеансом с задержкой. В результате может повыситься производительность, однако некоторые сообщения могут быть доставлены в управляемый сообщениями объект EJB несколько раз.

Целевой объект

Имя целевого объекта, который идентифицирует группу служб сообщений. Указывает тип целевого объекта, использующего свойство Тип целевого объекта.

Обязательное Нет
Тип данных Текст

Тип целевого объекта

Тип целевого объекта, указанного в свойстве Целевой объект.

Обязательное Нет
Тип данных выпадающий список
Диапазон значений
Имя элемента шины
Имя элемента шины. Эта опция извлекает активные модули обмена сообщениями, расположенные в указанном элементе шины (на сервере приложений или в кластере).

Имя группы пользовательской службы сообщений
Имя пользовательской группы модулей обмена сообщениями (которые формируют самостоятельный кластер). Эта опция извлекает активные модули обмена сообщениями, зарегистрированные в указанной пользовательской группе.

Имя службы сообщений
Имя модуля обмена сообщениями. Эта опция извлекает доступные конечные точки, используемые для связи с указанным модулем обмена сообщениями.

Значимость целевого объекта

Это свойство задает значимость группы целевых объектов.

Обязательное Нет
Тип данных выпадающий список
Диапазон значений
Предпочитаемый
Рекомендуется выбирать модуль обмена сообщениями из целевой группы. Если в целевой группе уже есть модуль обмена сообщениями, то он будет выбран. Если в группе нет модулей, то будет выбран модуль вне целевой группы в той же шине интеграции служб (если он существует).

Обязательный
Необходимо выбирать модуль обмена сообщениями из целевой группы. Если в целевой группе уже есть модуль обмена сообщениями, то он будет выбран. Если в группе нет модулей, то соединение не устанавливается.

Целевая входящая транспортная цепочка

Имя входящей транспортной цепочки, используемой приложением при подключении к службе сообщений в отдельном процессе. Если выбрана служба сообщений в другом процессе, то для установления соединения принимающий сервер должен поддерживать указанную входящую транспортную цепочку. Подробности см. в справочной системе Information Center.

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

Транспортная цепочка представляет собой набор сетевых протоколов, с которыми работает сервер. Укажите имя одной из транспортных цепочек, доступных на сервере, где расположена служба сообщений, как указано на панели Серверы > Типы серверов > Серверы приложений WebSphere > имя-сервера > [Служба сообщений сервера] Входящие транспортные протоколы модуля обмена сообщениями. В списке будут указаны следующие транспортные цепочки. При необходимости к ним можно добавить пользовательские цепочки.
InboundBasicMessaging
Это протокол с установкой стандартного соединения TCP/IP (JFAP-TCP/IP). Он поддерживает двухфазные транзакции (удаленный XA). При этом поставщик или приемник сообщений, работающий в системе клиента или сервера, может участвовать в глобальных транзакциях этой системы. Применение потоков XA необходимо для поддержки доступа из приложения, запущенного на одном сервере, в на другом сервере, потому что на первом сервере, возможно, нет подходящего. При использовании потоков удаленного XA приложению необходим локальный координатор транзакций.
InboundSecureMessaging
Протокол InboundBasicMessaging с поддержкой SSL.
Дополнительная информация об использовании данного свойства с другими свойствами фабрики соединений для управления нагрузкой в соединениях приведена в разделе Административные параметры соединений JMS с шиной (в сети).
Обязательное Нет
Тип данных Текст

Конечные точки поставщика

Для соединения с сервером начальной загрузки используется список триплетов конечных точек через запятую со следующим синтаксисом: хост:порт:протокол. Например, Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.

Конечные точки провайдера не используются, если указанная шина не найдена в локальной ячейке. Приложения объекта управляемого сообщения (MDB) сначала пытаются подключиться к указанной шине в локальной ячейке. Если эта попытка безуспешна, конечные точки провайдера используются для разрешения приложениям загружать сообщения из удаленной ячейки.

Если имя хоста не указано, будет использовано значение по умолчанию localhost.

Если не указан номер порта, будет использовано значение по умолчанию 7276.

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

Обязательное Нет
Тип данных Область текста

Максимальный размер пакета

Максимальное число сообщений, которые можно получить от службы сообщений в одном пакете.

Максимальное число сообщений в одном пакете, доставляемых последовательно в один экземпляр bean-объекта, управляемого сообщениями. Упаковка сообщений может повысить производительность, особенно когда Режим уведомления имеет значение Автоматическое уведомление об успешном копировании. Если порядок сообщений должен сохраняться среди неудачных доставок, установите размер пакета равным 1.
Обязательное Нет
Тип данных Целое число
Диапазон значений От 1 до 2147483647

Максимальное количество параллельных вызовов MDB для конечной точки

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

Увеличение этого числа может улучшить производительность, но повысить количество нитей, используемых одновременно. Если порядок сообщений должен сохраняться среди неудачных доставок, установите максимальное число параллельных конечных точек равным 1. Порядок сообщений применяется, только если назначение, из которого загружается управляемый сообщениями bean-объект, не является назначением, разделенным на разделы. Разделенные назначения применяются в сценарии распределения рабочей нагрузки кластера.
Обязательное Нет
Тип данных Целое число
Диапазон значений От 1 до 2147483647

Автоматический останов при повторном сбое сообщений

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

Остановка конечной точки снижает число сообщений, без необходимости перемещаемых в обработчик исключительных ситуаций, если неполадка не вызвана сообщением, обработанным с ошибкой.

Когда конечная точка останавливается автоматически, ее индикатор состояния в административной консоли становится красным. Ее следует перезапустить вручную с помощью кнопки Продолжить.

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

Включить

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

Обязательное Нет
Тип данных Переключатель

Порог последовательных сбоев сообщений

Конечная точка будет остановлена при достижении заданного предела по количеству последовательных сбойных сообщений. Ввиду параллельности в MDB фактическое количество обработанных сообщений может превышать этот предел.

Это свойство неактивно, пока не включено свойство Автоматический останов при повторном сбое сообщений.

Обязательное Нет
Тип данных Целое число

Задержка между повторами при сбое сообщений

Любое сообщение, не обработанное MDB, но не достигшее максимального предела по количеству ошибок доставки, повторяется только по истечении такого времени. Другие сообщения в это время могут повторяться, если пороговое значение последовательных сбоев и максимального паралеллизма не равен 1.

Настройка задержки между повторами сообщений с ошибками снижает число сообщений, без необходимости перемещаемых в обработчик исключительных ситуаций до остановки MDB. Для минимизации числа перемещаемых сообщений укажите значение задержки больше, чем ожидаемый интервал между сообщениями, поступающими к получателю.

Это свойство неактивно, пока не включено свойство Автоматический останов при повторном сбое сообщений.

Обязательное Нет
Тип данных Целое число
Диапазон значений Время в миллисекундах. Значение 0 обозначает отсутствие задержки между повторами.

Гарантированность подписки

Указывает, будет ли подписка на раздел JMS гарантированной или нет

Обычно приемник для определенной гарантированной подписки может принадлежать только одному приложению одновременно. Это свойство позволяет переопределить данное поведение чтобы разрешить гарантированной подписке одновременно иметь несколько получателей.
Обязательное Нет
Тип данных выпадающий список
Диапазон значений
Гарантированная
Сообщения хранятся в провайдере обмена сообщениями, пока управляемый сообщениями объект EJB недоступен, и доставляются, как только он становится доступным.

Негарантированная
Сообщения не хранятся в провайдере обмена сообщениями и не доставляются повторно, если управляемый сообщениями объект EJB недоступен.

Имя подписки

Имя подписки, необходимое для гарантированных подписок. При использовании гарантированной подписки на раздел это поле является необходимым.

Каждая гарантированная подписка JMS определяется именем подписки (указанным в этом свойстве). С соединением JMS связан также идентификатор клиента (указанный в свойстве Идентификатор клиента), который используется для связи соединения и его объектов со списком сообщений (в гарантированной подписке), управляемым провайдером JMS для клиента.

Это имя подписки должно быть уникальным в данном идентификаторе клиента.

Обязательное Нет
Тип данных Текст

Идентификатор клиента

Идентификатор клиента JMS необходим для гарантированных подписок разделов во всех соединениях, созданных с помощью этой спецификации активации.

Указанное значение - это уникальный идентификатор клиента (объект JavaBean, управляемый сообщениями). Идентификатор клиента применяется для связи клиентского соединения со списком сообщений (в гарантированной подписке), который храниться провайдером обмена сообщениями для клиента. После возобновления доступности клиента провайдер обмена сообщениями использует идентификатор клиента для повторной доставки хранимых сообщений верному клиенту.
Обязательное Нет
Тип данных Текст

Исходная служба сообщений гарантированной подписки

Имя службы сообщений, где хранятся сообщения, которые доставляются по гарантированным подпискам для объектов, созданных с помощью этой спецификации активации JMS. Это обязательное поле при работе с гарантированной подпиской на раздел.

Администраторы могут управлять динамическим состоянием гарантированных подписок посредством точек публикаций для этой службы обмена сообщениями.
Обязательное Нет
Тип данных Текст

Передача полезной нагрузки сообщения по ссылке

При отправке больших объектных или байтовых сообщений может заметно возрастать нагрузка на процессор и память при сериализации, десериализации и копировании сообщения.Если свойства передачи данных сообщения по ссылке включены в фабрике соединений или спецификации активации, то провайдер обмена сообщениями по умолчанию будет переопределять спецификацию JMS 1.1, и за счет этого копирование данных может быть устранено или уменьшено.
ОСТОРОЖНО:
Компоненты спецификации JMS, которые обходятся этими свойствами, предназначены для обеспечения целостности данных. Все приложения JMS, которые используют эти свойства, должны строго соблюдать правила, описанные в разделе Как и когда передавать данные сообщения JMS по ссылке (в сети), в противном случае целостность данных может быть нарушена.

Приложения, использующие эту спецификацию активации для получения сообщений, должны соблюдать следующие правила:

  • Приложение не изменяет объект данных, полученный от сообщения объекта JMS. Объект данных считается доступным только для чтения.

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

Обязательное Нет
Тип данных Переключатель

Приложения, повторно отправляющие сообщения, которые были получены посредством этой спецификации активации, должны соблюдать следующие правила:

  • Приложение может заменить объект данных в объектном сообщении JMS при условии, что объект данных не задан в сообщении. Приложение не может изменять или заменять объект данных, заданный в сообщении.
  • Приложение может заменить байтовый массив в байтовом сообщении JMS, только используя один вызов writeBytes(byte[]), и не должно изменять байтовый массив, заданный в сообщении. Приложение не может изменять или заменять байтовый массив, заданный в сообщении.

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

Обязательное Нет
Тип данных Переключатель

Совместное использование гарантированных подписок

Указывает, являются ли гарантированные подписки общими для соединений с элементами кластера серверов.

Обычно TopicSubscriber для определенной гарантированной подписки может принадлежать только одному сеансу одновременно. Это свойство позволяет переопределить данное поведение чтобы разрешить гарантированной подписке одновременно иметь несколько получателей, по одному на каждый сервер приложений в кластере серверов.

For WebSphere Application Server ExpressFor WebSphere Application Server base edition Эта опция допустима только в средах WebSphere Application Server с поддержкой кластеров.

Обязательное Нет
Тип данных выпадающий список
Диапазон значений
В кластере
Разрешает общее использование гарантированных подписок при установке подключений из кластера сервера.

Всегда общее
Гарантированные подписки могут использоваться разными соединениями совместно.

Никогда не общее
Гарантированные подписки не могут совместно использоваться соединениями.

Совместное использование источника данных с CMP

Разрешает совместное использование соединений между JMS и сущностными объектами EJB CMP.

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

Дополнительная информация об использовании данной опции приведена в главе Настройка сущностных объектов EJB CMP и хранилищ данных модулей обмена сообщениями для совместного использования соединений с базой данных. (в сети).

Обязательное Нет
Тип данных Переключатель

Упреждающее чтение

Упреждающее чтение — способ оптимизации, при котором сообщения присваиваются приемникам в приоритетном порядке. Такой подход сократить время обработки запросов приемников.

Присвоенные приемнику сообщения заблокированы на сервере. Они недоступны для обработки другими приемниками данного пункта назначения. Если в отключенном приемнике остались присвоенные ему необработанные сообщения, то с них снимается блокировка, чтобы их могли получить другие приемники.

Это свойство можно заменить для отдельных пунктов назначения JMS. Для этого задайте свойство Упреждающее чтение в нужном пункте назначения JMS.

Обязательное Нет
Тип данных выпадающий список
Диапазон значений
По умолчанию
Провайдер обмена сообщениями присваивает сообщения приемникам с негарантированными подписками или личными гарантированными подписками в приоритетном порядке. Это значит, что режим оптимизации "упреждающее чтение" включен только в случае с одним приемником.

Включено
Провайдер обмена сообщениями присваивает сообщения приемникам в приоритетном порядке. Такой подход позволяет сократить время обработки запросов приемников.

Выключено
Провайдер обмена сообщениями не присваивает сообщения приемникам в приоритетном порядке.

Обязательно активировать MDB на всех серверах

Это свойство используется только при выполнении приложения MDB на сервере, который является элементом целевой шины приложения. Оно не имеет силы, если MDB выполняется на сервере, который не является элементом целевой шины.

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

For WebSphere Application Server Network Deployment Для приложений MDB, подключенных к элементу шины кластера, эту опцию можно также использовать для включения следующих дополнительных конфигураций:
  • Все серверы, входящие в состав кластера, могут принимать сообщения от приложения MDB. Такой подход позволяет в полной мере использовать вычислительную мощность кластера.
  • Для обеспечения последовательной обработки сообщений одновременно сообщения от приложения MDB может принимать только один сервер.
Для того чтобы позволить всем серверам в кластере получать сообщения от приложения MDB, выберите эту опцию. Чтобы разрешить только одному серверу в один момент времени получать сообщения от приложения MDB, отмените выбор этой опции и выберите опцию исключающее получение в назначении.

For WebSphere Application Server Network Deployment См. главу Как EJB, управляемый сообщениями, подключается к другим компонентами кластера (в сети).

Обязательное Нет
Тип данных Переключатель

Периодичность опроса

Задержка (в секундах) между попытками соединиться со службой сообщений, как для начального соединения, так и для последующих попыток установить более надежное соединение.

Обязательное Нет
Тип данных Целое число
Диапазон значений От 1 до 2147483647

Псевдоним идентификации

Имя псевдонима идентификации J2C, применяемого для идентификации, управляемой компонентами, в шине интеграции служб.

Псевдоним идентификации Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) задает ИД пользователя и пароль, которые применялись для идентификации при создании соединения с провайдером JMS.

Обязательное Нет
Тип данных выпадающий список



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