Свойства подписки IBM MQ
Можно указывать свойства подписок всех типов. Некоторые из них применимы не ко всем типам подписок, другие относятся только к подпискам z/OS.
В следующих таблицах перечислены все свойства, которые можно указать:
Приводятся краткое описание каждого свойства и его настройка. В таблицах также указывается эквивалентный параметр MQSC для команд DEFINE CHANNEL, ALTER CHANNEL и DISPLAY SUB. Дополнительная информация о командах MQSC приведена в разделе Администрирование с помощью команд MQSC в документации по продукту IBM® Knowledge Center.
Общие
В следующей таблице перечислены свойства, которые можно задать на странице Общие в окне диалога Свойства подписки.
Свойство | Назначение | Параметр MQSC |
---|---|---|
Имя подписки | Только для чтения. Имя подписки нельзя изменять после ее создания. | SUBNAME |
Имя темы | Имя объекта темы, используемого подпиской. Имя темы служит необязательным корневым каталогом темы. Допускается до 48 символов. | TOPICOBJ |
Строка темы | Полное имя темы или набор символов подстановки для обозначения темы в подписке. В этой строке символ (/) обладает специальным значением. Он разделяет элементы в дереве темы. Строка темы может начинаться с символа (/), но это не обязательно. Строка, начинающаяся с символа (/), отличается от строки, с него не начинающейся. |
TOPICSTR |
Использование символов подстановки | Схема используется при интерпретации символов подстановки, содержащихся в Строке темы. Существуют два значения: TOPIC: Символы подстановки обозначают части иерархии темы. CHAR: Символы подстановки обозначают части строк. |
WSCHEMA |
Область поиска | Область действия определяет, следует ли перенаправлять
подписку другим администраторам очередей, чтобы подписчик мог
получать сообщения, публикуемые этими администраторами очередей.
Существуют два значения:
Прим.: Отдельные подписчики могут только указать ограничение SUBSCOPE. Если для параметра указано
значение ALL на уровне темы, то отдельный подписчик
может указать для подписки ограничение QMGR. Однако,
если для параметра указано значение QMGR на уровне
темы, то значение ALL для отдельного подписчика
игнорируется.
|
SUBSCOPE |
Класс назначения | Атрибут Класс назначения определяет, является ли пункт назначения, используемый подпиской, управляемым. Существуют два значения: MANAGED: Целевой объект является управляемым. PROVIDED: Целевым объектом является очередь. Это значение по умолчанию. |
DESTCLAS |
Администратор очередей пункта назначения | Администратор очередей пункта назначения для сообщений, опубликованных в подписке. | DESTQMGR |
Имя целевого объекта | Задает имя целевой очереди для отправки сообщений подписки. | DEST |
Идентификатор зависимости | Значение атрибута Идентификатор зависимости вставляется в
дескрипторы всех сообщений, отправляемых в подписку. Если этот параметр не указан, сообщения будут помещаться в пункт
назначения с идентификатором зависимости MQCI_NONE. Пустое значение (по умолчанию) позволяет применить идентификатор зависимости, созданный системой. Если указано значение ' |
DESTCORL Прим.: Свойство
DESTCORL нельзя задать программным образом с помощью
JMS.
|
Гарантированная | Гарантированная подписка не удаляется, когда создавшее ее приложение закрывает описатель подписки. Значение параметра Гарантированная для подписки может быть Да или Нет. Когда значение параметра Гарантированная - Да, подписка не удаляется, когда создавшее ее приложение закрывает описатель подписки. | DURABLE |
Тип | Тип подписки означает то, как она была создана. Есть следующие типы подписки: API: Подписка создается с помощью запроса MQSUB API. ADMIN: подписка, созданная с помощью команды DEF SUB MQSC или PCF. Кроме того, ADMIN позволяет указать, что подписка была изменена с помощью команды администрирования. PROXY: подписка создана внутренне для маршрутизации публикаций через сеть администратора очередей. Подписки типа PROXY при изменении не преобразуются в тип ADMIN. Параметр Тип является неизменяемым. |
SUBTYPE |
Свойства | Атрибут Свойства определяет, как свойства, связанные с публикацией/подпиской, добавляются к сообщению, отправляемому в подписку. Доступные варианты: Совместимость: Свойства публикации/подписки добавляются в сообщение для совместимости с механизмом публикации/подписки IBM WebSphere MQ 6.0. Свойства сообщения: Свойства публикации/подписки добавляются как свойства сообщения. Нет: Свойства публикации/подписки не добавляются в сообщение. RFH2: Свойства публикации/подписки добавляются в сообщение в заголовок RFH версии 2. |
PSPROP |
Пользовательские данные | Значение атрибута Пользовательские данные может передаваться как свойство сообщения, отправляемого в подписку (необязательно). | USERDATA |
Селектор | Атрибут Селектор - это строка SQL92, применяемая к сообщениям, публикуемым в названной теме, для того чтобы отобрать допустимые для подписки. | SELECTOR |
Тип селектора | Тип SelectionString. Значение этого свойства вычисляется и не связано с объектом. Тип селектора можно отфильтровать (например, с помощью предложения WHERE) для отображения ограниченного только внутренних или внешних селекторов. | SELTYPE |
Страница Расширенные
В следующей таблице перечислены свойства, которые можно задать на странице Расширенные в окне диалога Свойства подписки.
Свойство | Назначение | Параметр MQSC |
---|---|---|
ИД пользователя переменной | Указывает, могут ли пользователи, отличные от создателя подписки, присоединяться к ней и становиться ее владельцем.
Существуют два значения: ANY: Другие пользователи могут присоединяться к подписке при наличии необходимых прав доступа к теме и целевому объекту. Это значение по умолчанию. FIXED: Другие пользователи не могут подключаться к подписке. |
VARUSER |
Пользователь | Задает пользовательский профайл, владеющий этой подпиской. | SUBUSER |
Данные идентификатора приложения | Значение поля Идентификационные данные приложения применяется для сообщений, отправляемых в подписку. Если Идентификационные данные приложения не указан, используется пустое значение по умолчанию. | PUBAPPID |
Ключ учета | Это значение используется для сообщений, отправляемых в подписку. Если Ключ учета не указан, используется значение по умолчанию, MQACT_NONE. | PUBACCT |
Приоритет публикации | Атрибут Приоритет публикации определяет, как свойства, связанные с публикацией/подпиской, добавляются к сообщению, отправляемому в подписку. Доступные варианты: Согласно публикации - приоритет сообщения, отправляемого в эту подписку, извлекается из опубликованного сообщения. Согласно определению очереди - в качестве приоритета сообщения, отправляемого в эту подписку, применяется приоритет целевой очереди по умолчанию. Можно указать приоритет в диапазоне 0 - 9. |
PUBPRTY |
ИД подписки | Значение поля ИД подписки присваивается администратором очередей как уникальный идентификатор подписки. Этот идентификатор может использоваться как альтернатива параметру SUBNAME в качестве целевого объекта для команд MQSC DISPLAY, ALTER и DELETE, если параметр SUBNAME нельзя указать из-за его формата или если для приложения, создавшего подписку, SUBNAME не был указан. | SUBID |
Срок действия | Время существования подписки с даты и времени создания. Срок действия измеряется в десятых долях секунды.
Существуют два значения: Без ограничения - срок действия подписки никогда не истекает; при необходимости пользователь может указать собственное значение, которое измеряется в десятых долях секунды. Значение по умолчанию - ноль. |
EXPIRY |
Только по запросу | Атрибут Только по запросу определяет, будет ли подписчик проводить опрос для получения обновлений с помощью API MQSUBPRQ. Существуют два значения: Все, означающее, что все публикации доставляются в подписку. Это значение по умолчанию. По запросу, означающее, что публикации доставляются в подписку только в ответ на API MQSUBPRQ. |
REQONLY |
Уровень подписки | Уровень, связанный с подпиской. Публикации доставляются в эту подписку только в том случае, если она принадлежит набору подписок с максимальным значением SubLevel, которое не превышает значение PubLevel, указанное при публикации. Значение должно лежать в диапазоне 0 - 9. Нулевое значение соответствует самому низкому уровню. | SUBLEVEL |
Страница Статистические данные
В следующей таблице перечислены свойства со страницы Статистические данные в окне Свойства подписки. На странице Статистические данные отображаются сведения о хронологии подписки. Сведения на странице Статистические данные предназначены только для чтения и не могут быть изменены пользователем.
Свойство | Назначение | Параметр MQSC |
---|---|---|
Дата создания | Только для чтения. Дата создания подписки. | CRDATE |
Время создания | Только для чтения. Время создания подписки. | CRTIME |
Дата изменения | Только для чтения. Это дата последнего изменения свойств подписки. | ALTDATE |
Время изменения | Только для чтения. Это время последнего изменения свойств подписки. | ALTTIME |