Свойства темы

Тема IBM® MQ - это объект IBM MQ, указывающий на то, о чем идет речь в публикации. Можно задать свойства тем. Некоторые свойства применимы только к темам z/OS. Кроме того, часть свойств можно указать только при создании темы. После создания темы IBM MQ эти свойства недоступны для изменения.

В следующей таблице перечислены свойства тем IBM MQ.

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

Общие

В следующей таблице перечислены свойства со страницы Общие окна IBM MQ Свойства темы.
Свойство Назначение Параметр 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
Модель очереди для гарантированной подписки

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

В имени допускается до 48 символов.

Если оставить это поле пустым, оно будет интерпретироваться как В качестве родителя.

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

У динамической очереди, созданной на основе этой модели, будет префикс SYSTEM.MANAGED.DURABLE.

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

В имени допускается до 48 символов.

Если оставить это поле пустым, оно будет интерпретироваться как В качестве родителя.

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

У динамической очереди, созданной на основе этой модели, будет префикс SYSTEM.MANAGED.NDURABLE.

MNDURMDL
Расположение группы совместного использования очередей (QSG) Размещение группы совместного использования очередей для раздела. Допустимо одно из следующих трех значений:
  • Администратор очередей - определение объекта доступно только для администратора очередей, в котором оно размещено.
  • Группа означает, что определение объекта хранится в общем хранилище, и каждый администратор очередей в группе совместного использования очередей имеет копию определения.
  • Копия - определение объекта представляет собой копию определения из общего хранилища.
В случае просмотра свойств темы это поле доступно только для чтения.
QSGDISP
Тип ответа по умолчанию при добавлении сообщения в очередь Тип ответа по умолчанию для ввода сообщений. Значением по умолчанию является Как у родительского объекта. Предусмотрены еще две опции:

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

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

DEFPRESP
Доставка несохраняемых сообщений

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

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

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

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

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

NPMSGDLV
Доставка сохраняемых сообщений

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

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

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

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

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

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

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

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

WILDCARD
Использовать очередь недоставленных сообщений Позволяет разрешить или запретить применение очереди недоставленных сообщений, если сообщения публикации не удалось доставить в очередь подписчика. Возможные значения:
  • Значение Нет указывает, если сообщения подписки не удалось доставить в подходящую очередь подписчика, то возникают ошибки доставки сообщения и запроса MQPUT с учетом значений параметров Доставка временных сообщений и Доставка постоянных сообщений.
  • Значение Да указывает, что применяется имя очереди недоставленных сообщений из свойства Очередь отклоненных сообщений администратора очередей. В противном случае применяется значение Нет.
  • Согласно предку указывает, что решение на применение очереди недоставленных сообщений было принято с учетом параметра ближайшего объекта административной темы в дереве тем. Это опция, настроенная в IBM MQ по умолчанию, однако при установке продукта она могла быть изменена.
USEDLQ
Настраиваемая Параметр Пользовательский, добавленный специально для IBM, зарезервирован для настройки новых функций перед вводом отдельных свойств. Укажите произвольное число пар свойство-значение в формате MQSC; в качестве разделителя следует использовать по крайней мере один пробел.
В именах свойств и значений учитывается регистр символов. Допустимы только прописные буквы. Значения могут содержать пробелы, круглые скобки и одинарные кавычки (которые необходимо экранировать с помощью еще одной одинарной кавычки). Для использования других символов, в том числе вложенных круглых скобок (), к ним необходимо добавлять по две одинарные кавычки с каждой стороны. Примеры допустимого синтаксиса:
  • CUSTOM('')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

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

Пользовательский

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

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

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

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

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

Как у родительского объекта. Свойство многоадресной рассылки темы наследуется из родительской темы.

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

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

Только. Разрешены только подписки от клиентов с поддержкой многоадресной рассылки.

MCAST
Информация о соединении Имя объекта информации о соединении. Поскольку дерево содержит несколько тем с одинаковыми свойствами многоадресной рассылки, рекомендуется создать отдельный объект с этими свойствами. COMMINFO

Кластер

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

Статистика

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

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

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

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

ALTTIME