Свойства темы
Тема 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 символов. Если оставить это поле пустым, оно будет интерпретироваться как В качестве родителя. При указании очереди модели для кластерной темы очередь должна быть создана в каждом администраторе очередей кластера, где можно создать гарантированную подписку с помощью этой темы. У динамической очереди, созданной на основе этой модели, будет префикс |
MDURMDL |
Модель очереди для негарантированной подписки | Это значение вводит администратор.
Эта строка содержит имя модели очереди, используемой в случае, когда для негарантированной подписки необходимо, чтобы администратор очередей управлял местом назначения публикаций. В имени допускается до 48 символов. Если оставить это поле пустым, оно будет интерпретироваться как В качестве родителя. При указании очереди модели для кластерной темы очередь должна быть создана в каждом администраторе очередей кластера, где можно создать негарантированную подписку с помощью этой темы. У динамической очереди, созданной на основе этой модели, будет префикс |
MNDURMDL |
Расположение группы совместного использования очередей (QSG) | Размещение группы совместного использования очередей для раздела.
Допустимо одно из следующих трех значений:
|
QSGDISP |
Тип ответа по умолчанию при добавлении сообщения в очередь | Тип ответа по умолчанию для ввода сообщений.
Значением по умолчанию является Как у родительского объекта. Предусмотрены
еще две опции: Синхронно - ответ добавляется в очередь синхронно. Асинхронно - асинхронное добавление ответа в очередь. |
DEFPRESP |
Доставка несохраняемых сообщений | Способ доставки несохраняемых сообщений, публикуемых в теме. Доступные варианты: В качестве родителя - Используемый механизм доставки основан на заданном первом родительском административном узле, обнаруженном в дереве данной темы. Это опция, настроенная в IBM MQ по умолчанию, однако при установке продукта она могла быть изменена. Всем доступным подписчикам - Несохраняемые сообщения доставляются всем подписчикам, которые могут принять сообщение. Если не удается доставить сообщение одному подписчику, все остальные подписчики все равно его получают. Всем гарантированным подписчикам - Несохраняемые сообщения доставляются всем гарантированным подписчикам. Если не удалось доставить несохраняемое сообщение негарантированным подписчикам, вызову MQPUT не будет возвращаться ошибка. Если не удалось доставить сообщение гарантированному подписчику, другие подписчики его тоже не получают, и происходит сбой вызова MQPUT. Всем подписчикам - Для того чтобы вызов MQPUT сообщил об успешном выполнении, несохраняемые сообщения должны быть доставлены всем подписчикам, независимо от того, являются ли они гарантированными. Если не удалось доставить сообщение какому-либо подписчику, другие подписчики его тоже не получают, и происходит сбой вызова MQPUT. |
NPMSGDLV |
Доставка сохраняемых сообщений | Способ доставки сохраняемых сообщений, публикуемых в теме. Предусмотрены четыре опции: В качестве родителя - Используемый механизм доставки основан на заданном первом родительском административном узле, обнаруженном в дереве данной темы. Это опция, настроенная в IBM MQ по умолчанию, однако при установке продукта она могла быть изменена. Всем доступным подписчикам - Сохраняемые сообщения доставляются всем подписчикам, которые могут принять сообщение. Если не удается доставить сообщение одному подписчику, все остальные подписчики все равно его получают. Всем гарантированным подписчикам - Сохраняемые сообщения доставляются всем гарантированным подписчикам. Если не удалось доставить сохраняемое сообщение негарантированным подписчикам, вызову MQPUT не будет возвращаться ошибка. Если не удалось доставить сообщение гарантированному подписчику, другие подписчики его тоже не получают, и происходит сбой вызова MQPUT. Всем подписчикам - Для того чтобы вызов MQPUT сообщил об успешном выполнении, сохраняемые сообщения должны быть доставлены всем подписчикам, независимо от того, являются ли они гарантированными. Если не удалось доставить сообщение какому-либо подписчику, другие подписчики его тоже не получают, и происходит сбой вызова MQPUT. |
PMSGDLV |
Использование символа подстановки | Это значение определяет поведение подписок с символом подстановки вместо темы. Возможные значения: Блокировать - Подписки на тему с символом подстановки, менее конкретную, чем строка темы этого объекта, не будут получать публикации, относящиеся к данной теме или к строкам темы, более конкретным, чем эта тема. Транзитная пересылка - Подписки на тему с символом подстановки, менее конкретную, чем строка темы этого объекта, будут получать публикации, относящиеся к данной теме и к строкам темы, более конкретным, чем эта тема. Это значение по умолчанию. |
WILDCARD |
Использовать очередь недоставленных сообщений | Позволяет разрешить или запретить применение очереди недоставленных сообщений, если
сообщения публикации не удалось доставить в очередь подписчика. Возможные значения:
|
USEDLQ |
Настраиваемая | Параметр
Пользовательский, добавленный специально для
IBM, зарезервирован для
настройки новых функций перед вводом отдельных свойств. Укажите произвольное число пар свойство-значение в формате MQSC; в качестве
разделителя следует использовать по крайней мере один пробел. В именах свойств и значений учитывается регистр символов. Допустимы только прописные буквы. Значения могут содержать пробелы, круглые скобки и одинарные кавычки (которые
необходимо экранировать с помощью еще одной одинарной кавычки). Для
использования других символов, в том числе вложенных круглых скобок (), к ним
необходимо добавлять по две одинарные кавычки с каждой стороны. Примеры допустимого синтаксиса:
В ходе анализа значений администратор очередей игнорирует ошибки (например если строку нельзя проанализировать с помощью этих правил или если она содержит неизвестные свойства и значения). |
Пользовательский |
Распределенная публикация/подписка
В следующей таблице перечислены свойства со страницы Распределенная публикация/подписка окна IBM MQ Свойства темы.Свойство | Назначение | Параметр MQSC |
---|---|---|
Обработка прокси-подписок | Прокси-подписки связаны с именем создавшего их администратора очередей. Если существует прокси-подписка, включающая в себя тему публикации, то она пересылается только администраторам очередей с прямым соединением. Для этого значения существуют две опции: Принудительно. При ее выборе прокси-подписка с символами подстановки в строке темы, связанной с данным объектом, принудительно отправляется из каждого администратора очередей в кластере всем участникам топологии публикаций/подписок вне зависимости от того, осуществлялись ли какие-либо локальные подписки. После того как эта принудительная прокси-подписка распространилась на всю топологию, все новые подписки сразу же, без проявлений латентности, получают публикации из других подключенных администраторов очередей. Все публикации передаются всем другим администраторам очередей в кластере вне зависимости от того, были ли они запрошены подпиской. Установка этого значения на данном уровне в дереве тем также запрещает генерацию прокси-подписок для отдельных строк тем на следующих уровнях в дереве тем, сокращая накладные расходы, связанные с прокси-подписками. Сначала применить. Для
каждой уникальной строки темы этого объекта или объекта более низкого
уровня прокси-подписка в асинхронном режиме отправляется всем
соседним администраторам очередей в следующих случаях:
|
PROXYSUB |
Область публикаций |
Областью публикаций можно управлять административно с помощью атрибута темы PUBSCOPE. Атрибуту может быть присвоено одно из трех значений:
|
PUBSCOPE |
Область подписки |
Областью подписки можно управлять административно с помощью атрибута темы SUBSCOPE. Атрибуту может быть присвоено одно из трех значений:
|
SUBSCOPE |
Многоадресная передача | Указывает, поддерживает ли тема многоадресную рассылку. Возможные значения: Как у родительского объекта. Свойство многоадресной рассылки темы наследуется из родительской темы. Выключено. Узел не поддерживает поток данных многоадресной передачи. Включено. Узел поддерживает поток данных многоадресной рассылки. Только. Разрешены только подписки от клиентов с поддержкой многоадресной рассылки. |
MCAST |
Информация о соединении | Имя объекта информации о соединении. Поскольку дерево содержит несколько тем с одинаковыми свойствами многоадресной рассылки, рекомендуется создать отдельный объект с этими свойствами. | COMMINFO |
Кластер
В следующей таблице перечислены свойства со страницы Кластер окна IBM MQ Свойства темы.Свойство | Назначение | Параметр MQSC |
---|---|---|
Имя кластера | Для того чтобы сделать тему темой кластера, необходимо настроить это свойство. После такой настройки все используемые сервером публикации или подписчиком темы в этой точке и в дереве тем становятся общими для всех администраторов очередей кластера, а сообщения, публикуемые в кластерную ветвь дерева тем, автоматически направляются в подписки остальных администраторов очередей кластера. | CLUSTER |
Состояние объекта кластера |
Текущее состояние этого объекта темы в данном кластере. Допустимые значения:
|
CLSTATE |
Маршрут кластера |
Метод маршрутизации для тем в кластере, определенных параметром CLUSTER. Возможные значения:
|
CLROUTE |
Статистика
В следующей таблице перечислены свойства со страницы Статистика окна IBM MQ Свойства темы.Свойство | Назначение | Параметр MQSC |
---|---|---|
Дата изменения | Это неизменяемое значение, оно приведено только для информации. Это дата последнего изменения свойств темы. |
ALTDATE |
Время изменения | Это неизменяемое значение, оно приведено только для информации. Это время последнего изменения свойств темы. |
ALTTIME |