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

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

Провайдер обмена сообщениями WebSphere MQ поддерживает интерфейсы JMS 1.1, не связанные с конкретной предметной областью, такие как унифицированная фабрика соединений JMS. Приложение, не связанное с конкретной предметной областью, может использовать один и тот же интерфейс для обмена сообщениями как по модели "точка-точка", так и по модели "публикация-подписка", и может поддерживать оба этих типа обмена сообщениями внутри одной и той же транзакции. При работе с JMS 1.1 для новых приложений рекомендуется использовать унифицированные фабрики соединений JMS, не связанные с конкретной предметной областью. Интерфейс, связанный с предметной областью, расширяет эквивалент, не связанный с конкретной предметной областью, поэтому приложение, использующее фабрики соединений очереди и темы, связанные с предметной областью, может выбрать для использования любой интерфейс.

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

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

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

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

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

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

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

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

-localAddress
-clonedSubs
-componentAuthAlias

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

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

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

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

Свойства объединенной фабрики соединений 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 раздела Использование 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 версии 8.0 или более поздней версии.

В случае применения в среде с ячейками разных версий информация из списка имен соединений доступна только, начиная с 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 для фабрики соединений очереди провайдера обмена сообщениями IBM 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

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

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

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

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

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

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

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

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

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

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

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