Настройки спецификации активации провайдера обмена сообщениями IBM MQ

Эта панель позволяет просмотреть или изменить настраиваемые свойства выбранной спецификации активации для использования с провайдером обмена сообщениями IBM MQ. Эти настраиваемые свойства управляют созданием соединений с соответствующими очередями и разделами.

Для просмотра параметров спецификации активации IBM MQ с помощью административной консоли выполните следующие действия:

В области навигации выберите Ресурсы > JMS->Спецификации активации для просмотра существующих спецификаций активации.
Если это применимо, измените на панели данных параметр Область действия на тот уровень, на котором определены спецификации активации. Это ограничивает набор отображаемых спецификаций активации.
Выберите имя спецификации активации для работы.

В разделе Общие свойства существуют пять групп свойств:

Администрирование
Соединение
Назначение
Дополнительно
Параметры защиты

Внесите необходимые изменения в группы параметров Администрирование, Соединение, Приемник, Дополнительные и Защита и нажмите кнопку Применить для сохранения настроек до того, как на правой панели в разделе Дополнительные свойства использовать следующие ссылки:

Дополнительные свойства для просмотра или изменения дополнительных свойств спецификации активации IBM MQ.
Свойства посредника для просмотра или изменения свойств посредника спецификации активации IBM MQ.
Пользовательские свойства для просмотра или изменения пользовательских свойств спецификации активации IBM MQ. Например, можно настроить пользовательское свойство WAS_EndpointInitialState для спецификации активации. WAS_EndpointInitialState включает/выключает прием сообщений от целевого назначения JMS сразу после применения спецификации активации для подключения управляемого сообщениями объекта EJB к этому целевому назначению.
Свойства транспортного протокола для просмотра или изменения свойств транспортного протокола клиента вашей спецификации активации IBM MQ. Если выбранная спецификация активации не была создана с помощью таблицы определений каналов клиента (CCDT), воспользуйтесь этой ссылкой для ввода всей необходимой информации для соединения с IBM MQ. Если выбранная спецификация активации была создана с помощью CCDT, то свойства транспортного протокола клиента представлять не требуется и эта ссылка отсутствует.

Для настройки идентификационных данных, используемых с этой спецификацией активации, в разделе Связанные пункты можно выбрать пункт Идентификационные данные JAAS - J2C.

Кроме того, можно задать свойство -localAddress с помощью административной команды createWMQActivationSpec IBM MQ.

Прим.: При задании свойств IBM MQ применяются следующие ограничения:

Длина имен не должна превышать 48 символов, а имен каналов - 20 символов.
Указываемые вами значения свойств должны совпадать со значениями, указанными при настройке ресурсов JMS продукта IBM MQ. Дополнительная информация приведена в разделах Использование Java и Администрирование системы справочной системы IBM MQ Information Center.

Если функции IBM MQ были выключены в области, влияющей на ресурс провайдера сообщений IBM MQ, то отображается информационное сообщение о том, что IBM MQ выключен. В среде с одним сервером это информационное сообщение отображается только при перезапуске сервера после выключения функций IBM MQ. В среде сетевого развертывания информационное сообщение отображается немедленно. Дополнительные сведения приведены в разделе Отключение функциональности IBM MQ в WebSphere Application Server.

Спецификация активации IBM MQ имеет следующие свойства.

Администрирование

Область

Задает уровень, на котором данное определение ресурса видно для приложений.

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

Отображаемая в этой панели область используется только для информационных целей. Ее нельзя изменить. Для просмотра или изменения этого ресурса (или других ресурсов) на другой области измените область на сводной панели спецификаций активации IBM MQ, затем нажмите кнопку Применить, до того как, использовать ссылку для типа ресурса.

Информация	Значение
Тип данных	Строка

Поставщик

Провайдер JMS, определенный при создании спецификации активации.

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

Провайдер показывается только для информации.

Информация	Значение
Тип данных	Строка

Имя

Имя, под которым эта спецификация активации известна для административных целей в приложении WebSphere Application Server.

Информация	Значение
Тип данных	Строка
Диапазон	Имя должно быть уникально в пределах набора спецификаций активации, определенного для ячейки.

Имя JNDI

Это имя JNDI, которое используется для привязки спецификации активации в пространстве имен JNDI.

По соглашению, следует использовать полные имена JNDI; например, в форме jms/имя, где имя - это логическое имя ресурса.

Информация	Значение
Тип данных	Строка

Описание

Описание этой спецификации активации для административных целей в приложении WebSphere Application Server.

Информация	Значение
Тип данных	Строка
Значение по умолчанию	Пусто

Соединение

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

Если выбранная спецификация активации была создана с помощью CCDT, то выводятся следующие свойства:

URL таблицы определения клиентского канала
Администратор очередей
Конфигурация SSL

Если выбранная спецификация активации не была создана с помощью CCDT, то выводятся следующие свойства:

Администратор очередей
Транспортный протокол
Если переключатель Введите информацию о хостах и портах в виде отдельных значений имени хоста и номера порта выбран, то свойство списка имен соединений использовать нельзя и следующие свойства доступны для применения:
- Имя хоста
- Порт
Если переключатель Введите информацию о хостах и портах в виде списка имен соединений выбран, то можно использовать свойство списка имен соединений и следующие свойства использовать нельзя:
- Имя хоста
- Порт
Канал соединения с сервером
Если переключатель свойства Использовать SSL для защиты соединения с IBM MQ выключен, то следующие свойства использоваться не могут:
- Центральное управление
- Определенная конфигурация
- Конфигурация SSL

За дополнительной информацией о настройке свойств SSL для IBM MQ обратитесь к подразделу Свойства SSL в разделе WebSphere MQ - Работа с Java справочной системы IBM MQ Information Center.

Прим.: Для настройки адаптер ресурсов IBM MQ, применяемого провайдером сообщений IBM MQ, доступно четыре свойства соединений IBM MQ. Эти свойства управляют пулом соединений, применяемым спецификациями активации:

maxConnections
connectionConcurrency (Задание этого свойства влияет лишь на узлы WebSphere Application Server версии 7. Свойство не влияет на узлы WebSphere Application Server версии 8 или более поздних версий.)
reconnectionRetryCount
reconnectionRetryInterval

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

URL таблицы определения клиентского канала

Этот URL определяет расположение IBM MQ CCDT.

Информация	Значение
Тип данных	Строка

Администратор очередей

Если указанная спецификация активации основана на CCDT, это свойство используется для выбора записи в CCDT. В противном случае это свойство является именем подключаемого администратора очередей или группы совместного использования очередей. Для получения сообщений соединение устанавливается с этим ресурсом IBM MQ.

Информация

Значение

Тип данных

Строка

Диапазон

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

Если спецификация активации основана на CCDT, то значением должно быть одно из следующих:

Верное имя администратора очередей
Звездочка (*), за которой указано имя группы администратора очередей¹
Звездочка (*)
Пустое значение¹

¹Если значение свойства администратора очередей указано в этом формате вместе с CCDT, отдельные соединения, устанавливаемые с помощью спецификации активации, могут быть подключены к другим администраторам очередей. Выбор из нескольких администраторов очередей выполняется, если CCDT содержит несколько определений каналов соединений с клиентам с одинаковым параметром Имя администратора очередей (QMNAME). Кроме того, в этих определениях каналов соединений должны быть указаны сведения о сетевом соединении для разных администраторов очередей.

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

При указании свойства Администратор очередей рекомендуется избегать неоднозначных значений; в значении не следует указывать звездочку (*).
Ресурсы не рекомендуется использовать с приложениями, которые обрабатывают глобальные транзакции.

Транспортный протокол

Тип транспортного протокола IBM MQ для соединения. Тип транспортного протокола используется для определения точных механизмов соединения с IBM MQ.

Информация	Значение
Тип данных	Выпадающий список
Значение по умолчанию	Привязки, затем клиент
Диапазон	Клиент Для соединения с администратором очередей IBM MQ используется сетевое соединение на основе TCP/IP. Привязки, затем клиент Производится попытка подключения к администратору очередей в режиме связывания. Если это невозможно, используется клиентский транспортный протокол. Привязки Устанавливается соединение между памятями для администратора очередей, работающего на том же узле. Следующие свойства режима клиентского транспортного протокола недоступны: Имя хоста Порт Список имен соединений Канал соединения с сервером Дополнительная информация о настройке типа транспортного протокола `Привязки, затем клиент` или `Привязки` приведена в разделах Настройка провайдера обмена сообщениями IBM MQ с помощью информации стандартных библиотек.

Введите информацию о хостах и портах в виде отдельных значений имени хоста и номера порта

Если этот переключатель включен, то соединение с администратором очередей IBM MQ устанавливается с учетом информации из свойств имени хоста и номера порта.

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

Этот переключатель доступен только в том случае, свойство области содержит ячейку или кластер либо узел или сервер, на котором выполняется WebSphere Application Server версии 8.0 или более поздней версии.

Информация	Значение
Тип данных	Переключатель

Имя хоста

Имя хоста, IPv4, или адрес IPv6 администратора очередей IBM MQ, с которым устанавливается соединение.

Информация	Значение
Тип данных	Строка

Порт

Номер порта, на котором прослушивается IBM MQ.

Информация	Значение
Тип данных	Целое число
Значение по умолчанию	1414
Диапазон	Значение должно принадлежать диапазону от 1 до 65536 (включительно).

Введите информацию о хостах и портах в виде списка имен соединений

Если этот переключатель включен, то соединение с администратором очередей IBM MQ устанавливается с учетом информации из свойства Список имен соединений.

Списки имен соединений можно использовать для подключения к отдельному администратору очередей или администратору очередей с несколькими экземплярами. Дополнительная информация о работе с администратором очередей с несколькими экземплярами приведена в справочной системе IBM MQ Information Center. Позволяет включить свойство списка имен соединений и выключить свойства имени хоста и номера порта. Для ввода имени хоста и номере порта выберите Введите информацию о хостах и портах в виде отдельных значений имени хоста и номера порта.

Информация	Значение
Тип данных	Переключатель

Список имен соединений

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

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

Информация

Значение

Тип данных

Строка

Значение по умолчанию

Не задано

Диапазон

В этом поле должна быть указана строка в следующем формате:

хост[(порт)][,хост(порт)]

Номер порта указывать необязательно; если он не указан, то по умолчанию применяется значение 1414.

хост - это допустимое имя хоста TCP/IP или адрес IPv4 или IPv6.

порт - это целое число в диапазоне от 1 до 65536 (включительно).

Пример: localhost(1234),remotehost1(1234),remotehost2

Если указано свойство списка имен соединений, то в качестве имени хоста и номера порта автоматически применяется информация из первой записи списка имен соединений. Если указано значение localhost(1234),remotehost1(1234),remotehost2, то будут указаны имя хоста localhost и номер порта 1234.

Это свойство доступно только в том случае, свойство области содержит ячейку или кластер либо узел или сервер, на котором выполняется WebSphere Application Server версии 8.0 или более поздней версии.

В случае применения в среде с ячейками разных версий информация из списка имен соединений для спецификаций активации кластера или ячейки доступна для узлов WebSphere Application Server 7.0. Конкретный алгоритм работы зависит от уровня пакета исправлений узла:

Для узлов с WebSphere Application Server 7.0 с пакетом исправлений 7 или более поздней версии свойство списка имен соединений можно использовать для подключения к администраторам очередей с несколькими экземплярами.
Узлы с пакетом исправлений до 7.0 не поддерживают свойство списка имен соединений и выдается предупреждение, аналогичное следующему:
```
[29/09/10 12:15:27:468 BST] 00000018 J2CUtilityCla W   
J2CA0008W: В классе com.ibm.mq.connector.inbound.ActivationSpecImpl, используемом ресурсом 
cells/L3A3316Node01Cell/resources.xml#J2CResourceAdapter_1284547647859, отсутствует 
метод setConnectionNameList. Обработка продолжена.
```
В этом случае для подключения к администратору очередей применяются свойства имени хоста и номера порта.

Канал соединения с сервером

Имя канала соединения с сервером IBM MQ, используемое при подключении к IBM MQ.

Информация	Значение
Тип данных	Строка
Значение по умолчанию	SYSTEM.DEF.SVRCONN
Диапазон	Значением должен быть канал соединения с сервером, определенный для соединения с администратором очередей IBM MQ.

Использование SSL для защиты соединений с IBM MQ

Эта опция определяет использование протокола SSL для защиты сетевых соединений с администратором очередей IBM MQ или группой совместного использования очередей.

При использовании спецификации активации провайдера обмена сообщениями IBM MQ в среде сервера приложений настройкой SSL управляет сервер приложений. Для того чтобы изменить параметры конфигурации SSL, перейдите с помощью административной консоли на панель Защита > Сертификат SSL и управление ключами.

В конфигурации SSL для спецификации активации провайдера обмена сообщениями IBM MQ можно использовать только один комплект шифров. В задано несколько наборов шифров, то используется только один из них.

Информация	Значение
Тип данных	Переключатель. Если этот переключатель выключен, то следующие свойства SSL недоступны: Центральное управление Определенная конфигурация Конфигурация SSL

Центральное управление

При использовании протокола SSL для связи с IBM MQ выберите этот переключатель, чтобы указать, что конфигурация SSL получается из централизованно управляемой конфигурации SSL WebSphere Application Server.

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

Информация	Значение
Тип данных	Переключатель

Определенная конфигурация

Включите этот переключатель для указания конкретной конфигурации SSL, используемой при защите сетевых соединений с администратором очередей или группой совместного использования очередей IBM MQ.

Информация	Значение
Тип данных	Переключатель

Конфигурация SSL

Конфигурация SSL, используемая при защите сетевых соединений с администратором очередей или группой совместного использования очередей IBM MQ.

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

Это свойство всегда включено, если ресурс провайдера обмена сообщениями IBM MQ основан на CCDT.

Если этот ресурс провайдера обмена сообщениями IBM MQ основан на CCDT, то данный параметр используется только в том случае, если соответствующие записи CCDT настроены на применение SSL.

Кроме того, если для конфигурации SSL выбрана опция нет, то для провайдера обмена сообщениями IBM MQ по умолчанию используется централизованно управляемая конфигурация SSL WebSphere Application Server.

Информация	Значение
Тип данных	Выпадающий список

Назначение

Прим.: Свойство WAS_EndpointInitialState является пользовательским свойством. Оно позволяет разрешить или запретить прием сообщений из получателя JMS, если объект MDB подключается к получателю с помощью спецификации активации. Для задания пользовательских свойств после внесения изменений на панели содержимого и сохранения конфигурации с помощью кнопки Применить, перейдите по ссылке Пользовательские свойства в разделе Дополнительные свойстве на панели содержимого.

Имя JNDI места назначения

Имя JNDI приемника JMS, из которого извлекаются сообщения для отправки управляемому сообщениями объекту EJB (MDB), настроенному на использование этой спецификации активации.

Информация	Значение
Тип данных	Строка

Выбор сообщений

Выражение селектора сообщений, определяющего, какие сообщения подлежат отправке.

Информация	Значение
Тип данных	Строка

Тип приемника

Тип назначения (очередь или раздел), из которого принимаются сообщения.

Информация	Значение
Тип данных	Выпадающий список
Диапазон	Очередь Это имя JNDI назначения определяет назначение JMS, которым является очередь. Тема Это имя JNDI назначения определяет назначение JMS, которым является раздел.

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

Эта опция определяет использование гарантированной или негарантированной подписки, используемой для отправки сообщений MDB, подписанному на этот раздел.

Информация	Значение
Тип данных	Переключатель
Значение по умолчанию	Переключатель не включен (негарантированная)
Диапазон	Не выбран Негарантированная. Переключатель включен Гарантированная.

Имя подписки

Имя гарантированной подписки. Доступно только при включенном переключателе Гарантированная подписка.

Информация	Значение
Тип данных	Строка

Дополнительно

ИД клиента

Идентификатор клиента, используемый при подключении к провайдеру обмена сообщениями IBM MQ.

Информация	Значение
Тип данных	Строка

Разрешение дублированных гарантированных подписок

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

Информация	Значение
Тип данных	Переключатель
Значение по умолчанию	Не выбран
Диапазон	Переключатель включен Разные серверы могут параллельно получать доступ к нескольким экземплярам гарантированной подписки. Не выбран Разные серверы не могут параллельно получать доступ к нескольким экземплярам гарантированной подписки.

Версия провайдера

Версия провайдера обмена сообщениями IBM MQ. Она используется для определения того, должно ли подключение производиться к определенной версии администратора очередей. Также служит для определения типа функциональных возможностей, требуемых клиентом.

Информация

Значение

Тип данных

Строка

Диапазон

Введите пустую строку или значение в одном из следующих форматов:

n.n.n.n
n.n.n
n.n
n

где n - численное значение, большее или равное нулю.

Например, 6.0.0.0.

Параметры защиты

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

Имя пользователя и пароль, используемые для соединения с IBM MQ.

Информация	Значение
Тип данных	Выпадающий список
Значение по умолчанию	(нет)
Диапазон	Все псевдонимы идентификации, определенные для ячейки, и значение "(none)", которое указывает, что идентификационные данные не передаются в IBM MQ.

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