Свойства подписки IBM MQ

Можно указывать свойства подписок всех типов. Некоторые из них применимы не ко всем типам подписок, другие относятся только к подпискам z/OS.

В следующих таблицах перечислены все свойства, которые можно указать:

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

Общие

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

Свойство Назначение Параметр MQSC
Имя подписки Только для чтения. Имя подписки нельзя изменять после ее создания. SUBNAME
Имя темы Имя объекта темы, используемого подпиской. Имя темы служит необязательным корневым каталогом темы. Допускается до 48 символов. TOPICOBJ
Строка темы Полное имя темы или набор символов подстановки для обозначения темы в подписке.

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

TOPICSTR
Использование символов подстановки Схема используется при интерпретации символов подстановки, содержащихся в Строке темы. Существуют два значения:

TOPIC: Символы подстановки обозначают части иерархии темы.

CHAR: Символы подстановки обозначают части строк.

WSCHEMA
Область поиска Область действия определяет, следует ли перенаправлять подписку другим администраторам очередей, чтобы подписчик мог получать сообщения, публикуемые этими администраторами очередей. Существуют два значения:
ALL
Подписка пересылается всем администраторам очередей, соединенным напрямую через иерархию публикации/подписки.
QMGR
Подписка пересылает только сообщения, опубликованные в данной теме в данном администраторе очередей.
Прим.: Отдельные подписчики могут только указать ограничение SUBSCOPE. Если для параметра указано значение ALL на уровне темы, то отдельный подписчик может указать для подписки ограничение QMGR. Однако, если для параметра указано значение QMGR на уровне темы, то значение ALL для отдельного подписчика игнорируется.
SUBSCOPE
Класс назначения Атрибут Класс назначения определяет, является ли пункт назначения, используемый подпиской, управляемым. Существуют два значения:

MANAGED: Целевой объект является управляемым.

PROVIDED: Целевым объектом является очередь. Это значение по умолчанию.

DESTCLAS
Администратор очередей пункта назначения Администратор очередей пункта назначения для сообщений, опубликованных в подписке. DESTQMGR
Имя целевого объекта Задает имя целевой очереди для отправки сообщений подписки. DEST
Идентификатор зависимости Значение атрибута Идентификатор зависимости вставляется в дескрипторы всех сообщений, отправляемых в подписку. Если этот параметр не указан, сообщения будут помещаться в пункт назначения с идентификатором зависимости MQCI_NONE.

Пустое значение (по умолчанию) позволяет применить идентификатор зависимости, созданный системой.

Если указано значение '000000000000000000000000000000000000000000000000' (48 нулей), то в копии сообщения, доставляемой подписке, остается CorrelId, указанный публикующим приложением (если сообщения не передаются с помощью иерархии публикации и подписки).

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