Свойства темы кластера

Можно задать свойства тем кластера. Однако некоторые свойства можно изменить только при создании новой темы кластера. После создания темы кластера эти свойства недоступны для изменения.

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

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

Приводятся краткое описание каждого свойства и его настройка. Кроме того, в таблице указан эквивалентный параметр MQSC, который можно использовать, например, в команде DISPLAY TCLUSTER. Дополнительная информация о командах MQSC приведена в разделе Администрирование с помощью команд MQSC в документации по продукту IBM Knowledge Center.

Общие

В следующей таблице перечислены свойства со страницы Общие окна Свойства темы кластера.
Свойство Назначение Параметр MQSC
Имя темы Это значение можно изменить только при создании темы. Это обязательный параметр, который не может быть пустой строкой.

Уникальный идентификатор создаваемого административного определения темы. Допускается до 48 символов.

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

TOPNAME
Тип темы Это значение изменять нельзя. Оно указывает, является ли тема локальной (Локальная) или кластерной (Кластер). н/д
Строка темы Это значение можно изменить только при создании темы. Это обязательный параметр, который не может быть пустой строкой.

Символ / в этой строке имеет особое значение. Он разделяет элементы в дереве темы. Строка темы может начинаться с символа "/", но это не обязательно. Строка, начинающаяся с символа "/", отличается от строки, с него не начинающейся.

Строка темы не должна совпадать с какой-либо строкой темы, присутствующей в другом определении. Максимальная длина строки темы 10240 символов.

TOPICSTR
Описание Это значение вводит администратор. Содержит описание темы. Должно содержать только отображаемые символы. Допускается до 64 символов.

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

DESC
Опубликовать Это свойство определяет, могут ли сообщения публиковаться в данной теме. Значением по умолчанию является Как у родительского объекта. Предусмотрены еще две опции:

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

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

PUB
Подписаться Это свойство определяет, могут ли сообщения подписываться на данную тему. Значением по умолчанию является Как у родительского объекта. Предусмотрены еще две опции:

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

Запрещено, означающая, что сообщения не могут подписываться на данную тему.

SUB
Гарантированная подписка Это свойство определяет, может ли осуществляться гарантированная подписка для данной темы. Значением по умолчанию является Как у родительского объекта. Предусмотрены еще две опции:

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

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

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

Приоритет по умолчанию может быть от 0 (низший) до 9 (высший).

DEFPRTY
Сохранение по умолчанию По умолчанию значение сохранения - В качестве родителя. Выберите Сохраняемые, чтобы указать, что необходимо сохранять сообщения, создаваемые приложениями, которые используют MQPER_PERSISTENCE_AS_Q_DEF. Выберите Несохраняемые, чтобы указать, что нет необходимости сохранять сообщения, создаваемые приложениями, которые используют MQPER_PERSISTENCE_AS_Q_DEF. DEFPSIST
Тип ответа по умолчанию при добавлении сообщения в очередь Тип ответа по умолчанию для ввода сообщений. Значение по умолчанию - В качестве родителя. Предусмотрены еще две опции:

Синхронно - ответ добавляется в очередь синхронно.

Асинхронно - асинхронное добавление ответа в очередь.

DEFPRESP
Доставка несохраняемых сообщений Способ доставки несохраняемых сообщений, публикуемых в теме. Предусмотрены четыре опции:

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

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

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

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

NPMSGDLV
Доставка сохраняемых сообщений Способ доставки сохраняемых сообщений, публикуемых в теме. Предусмотрены четыре опции:

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

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

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

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

PMSGDLV
Использование символа подстановки Это значение определяет поведение подписок с символом подстановки вместо темы. Существуют два значения:

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

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

Распределенная публикация/подписка

В следующей таблице перечислены свойства со страницы Распределенная публикация/подписка окна Свойства темы кластера.
Свойство Назначение Параметр MQSC
Обработка прокси-подписок Прокси-подписки связаны с именем создавшего их администратора очередей. Если существует прокси-подписка, включающая в себя тему публикации, то она пересылается только администраторам очередей с прямым соединением. Для этого значения существуют две опции:

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

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

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

PROXYSUB
Область публикаций
Областью публикаций можно управлять административно с помощью атрибута темы PUBSCOPE. Атрибуту может быть присвоено одно из трех значений:
  • Как у родительского объекта. Это значение используется по умолчанию. Область публикаций совпадает с родительским администратором очередей.
  • Администратор очередей. Публикация доставляется только локальным подписчикам.
  • Все. Публикация доставляется локальным подписчикам и удаленным подписчикам с помощью администраторов очередей с непосредственным подключением.
PUBSCOPE
Область подписки
Областью подписки можно управлять административно с помощью атрибута темы SUBSCOPE. Атрибуту может быть присвоено одно из трех значений:
  • Как у родительского объекта. Это значение используется по умолчанию. Область подписки совпадает с родительским администратором очередей.
  • Администратор очередей. Подписка принимает только локальные публикации, а прокси-подписки не передаются удаленным администраторам очередей.
  • Все. Прокси-подписка передается удаленным администраторам очередей, а подписчик принимает локальные и удаленные публикации.
SUBSCOPE

Кластер

В следующей таблице перечислены свойства со страницы Свойства темы кластера окна Свойства темы кластера.
Свойство Назначение Параметр MQSC
Имя кластера Для того чтобы сделать тему темой кластера, необходимо настроить это свойство. После такой настройки все используемые сервером публикации или подписчиком темы в этой точке и в дереве тем становятся общими для всех администраторов очередей кластера, а сообщения, публикуемые в кластерную ветвь дерева тем, автоматически направляются в подписки остальных администраторов очередей кластера. CLUSTER
Состояние объекта кластера
Текущее состояние этого объекта темы в данном кластере. Допустимые значения:
ACTIVE
Тема кластера правильно настроена и связывается данным администратором очередей.
PENDING
Доступна только для владеющего администратора очередей. Тема находится в этом состоянии, когда она уже создана, но полное хранилище еще не передало ее в кластер. Причиной этого может быть то, что администратор очередей хоста не подключен к полному хранилищу или полное хранилище посчитало тему недопустимой.
INVALID
Это определение кластерной темы конфликтует с предыдущим определением в кластере и, как следствие, в данный момент неактивно.
ERROR
Возникла ошибка, связанная с этим объектом темы.
Данный параметр обычно используется в процессе диагностики, когда в разных администраторах очередей существуют одинаковые кластерные темы с несовпадающими определениями.
CLSTATE
Администратор очередей кластера Имя администратора очередей в кластере, которому принадлежит тема кластера. н/д
Маршрут кластера
Метод маршрутизации для тем в кластере, определенных параметром CLUSTER. Возможные значения:
DIRECT
При настройке кластерной темы с прямой маршрутизацией в администраторе очередей все администраторы очередей кластера уведомляются обо всех остальных администраторах очередей в кластере. При выполнении операций публикации и подписки каждый администратор очередей подключается напрямую ко всем остальным администраторам очередей.
TOPICHOST
Когда используется маршрутизация хоста темы, все администраторы очередей в кластере уведомляются об администраторах очередей, которые содержат маршрутизируемые определения темы. При выполнении операций публикации и подписки администраторы очередей в кластере подключаются только к этим администраторам очередей хоста темы, а не непосредственно друг к другу. Администраторы очередей хоста темы отвечают за маршрутизацию публикаций от администраторов очередей, где публикации публикуются, в администраторы очередей с соответствующими подписками.
CLROUTE
QMID Внутренне созданное уникальное имя администратора очередей кластера. Во избежание неоднозначности вместо QMNAME рекомендуется использовать QMID (Идентификатор администратора очередей). QMID

Статистика

В следующей таблице перечислены свойства со страницы Статистика окна Свойства темы кластера.
Свойство Назначение Параметр MQSC
Дата изменения Это неизменяемое значение, оно приведено только для информации.

Это дата последнего изменения свойств темы.

MQCA_ALTERATION_DATE
Время изменения Это неизменяемое значение, оно приведено только для информации.

Это время последнего изменения свойств темы.

MQCA_ALTERATION_TIME