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

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

Фабрика соединений темы WebSphere MQ используется для создания соединений JMS с адресатами темы, предоставленными WebSphere MQ для обмена сообщениями.

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

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

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

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

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

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

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

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

-localAddress
-clonedSubs
-componentAuthAlias

Дополнительная информация об этих свойствах приведена в разделе Команда createWMQConnectionFactory.

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

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

Фабрика соединений темы WebSphere MQ имеет следующие свойства.

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

Область

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

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

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

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

Поставщик

Провайдер JMS назначается при создании фабрики соединений темы.

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

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

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

Имя

Имя, идентифицирующее эту фабрику соединений темы для администрирования в WebSphere Application Server.

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

Имя JNDI

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

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

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

Описание

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

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

Соединение

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

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

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

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

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

Дополнительная информация о настройке параметров SSL для IBM MQ приведена в подразделе Свойства SSL раздела Использование Java в справочной системе IBM MQ Information Center.

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

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

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

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

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

Информация

Значение

Тип данных

Строка

Диапазон

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

Если эта фабрика соединений темы основана на CCDT, значением должно быть одно из следующего:

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

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

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

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

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

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

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

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

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

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

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

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

Имя хоста

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

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

Порт

Номер порта, на котором прослушивается WebSphere 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 или более поздней версии.

В случае применения в среде с ячейками разных версий информация из списка имен соединений доступна только, начиная с WebSphere Application Server версии 8.0. В этом случае в качестве замены применяется информация из полей имени хоста и номера порта с учетом первого элемента в списке имен соединений.

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

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

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

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

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

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

При использовании фабрики соединений темы провайдера обмена сообщениями WebSphere MQ в среде клиента, клиент получает информацию о конфигурации SSL из файла ssl.client.props file. Использование этого файла подробно описано в соответствующем разделе.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ИД клиента

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

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

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

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

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

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

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

Информация

Значение

Тип данных

Строка

Диапазон

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

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

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

Например, 6.0.0.0.

Поддержка протокола распределенной двухфазной фиксации

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

Если это свойство не выбрано, то поддержка протокола распределенной двухфазной фиксации выключена. Сеанс JMS по-прежнему будет включен в транзакцию, но он будет использовать локальные вызовы транзакций администратора ресурсов session.commit и session.rollback, вместо вызовов XA. Это может повысить производительность. Однако это означает, что только один ресурс может быть вовлечен в транзакцию в WebSphere Application Server.

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

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

Не включайте XA, если администратор очередей, указанный в фабрике соединений темы, является единственным ресурсом в транзакции. Если транзакции включают другие ресурсы, в том числе другие очереди или темы, включите XA.

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

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

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

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

Преобразование псевдонимов конфигурации

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

Когда значением прав доступа к ресурсу является "container", предпочтительный способ определения стратегии идентификации - это указание конфигурации входа в систему и связанных свойств по ссылке на ресурс компонента.

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

Информация	Значение
Тип данных	Выпадающий список
Значение по умолчанию	(нет)
Диапазон	Доступны следующие опции: Контейнер клиента WSLogin WSKRB5Login Преобразование субъекта по умолчанию TrustedConnectionMapping KerberosMapping

Псевдоним идентификации, управляемой контейнером

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

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

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