Свойства адресата

В окне Адресат можно просмотреть и указать свойства адресата. Свойства, доступные в окне диалога, зависят от типа адресата.

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

Приводятся краткое описание каждого свойства и его настройка. В таблицах также приводятся эквивалентные длинное и короткое имена для использования в строке команды JMS Administration. Свойства, доступные в окне диалога Свойства, зависят от типа адресата; свойства адресатов очередей несколько отличаются от свойств тематических адресатов. Дополнительные сведения можно найти в разделе Настройка объектов JMS с помощью инструмента администрирования в IBM® Knowledge Center.

Общие

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

Табл. 1. . Свойства страницы Общие
Свойство Назначение Длинное имя Короткое имя
Имя Показывает имя объекта. NAME  
Описание Дается описание объекта. DESCRIPTION DESC
Имя класса Показывает имя класса, который реализуется адресатом.    
Провайдер передачи сообщений Показывает передачу которая поддерживается целевым объектом (IBM MQ или транспорт реального времени). Транспорт реального времени недоступен в IBM MQ 8.0. В случае применения IBM MQ 8.0 можно указать транспорт реального времени, однако он не сможет создать соединение.    
Администратор очередей Выберите или введите имя администратора очередей, который управляет целевой очередью. QMANAGER QMGR
Очередь Выбирается имя очереди, представляемой адресатом. QUEUE QU
Тема Вводится имя темы, представляемой адресатом. TOPIC TOP

Страница Обработка сообщений

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

Табл. 2. . Свойства страницы Обработка сообщений
Свойство Назначение Длинное имя Короткое имя
Срок действия Задается период времени, по истечении которого действие сообщений на адресате прекращается. Для того чтобы указать, что срок действия может определять приложение-клиент JMS, выберите значение Приложение. Значение Неограниченный означает, что срока действия нет. В противном случае введите время в миллисекундах до истечения срока действия сообщений. EXPIRY EXP
Постоянство Определяется сохранение сообщений на адресате. Для того чтобы указать, что сохранение определяет приложение JMS, выберите значение Приложение. Значение Очередь по умолчанию означает, что сохранение определяет значение по умолчанию, заданное для очереди. Значение Постоянные указывает, что сообщения постоянные. Значение Временные указывает, что сообщения временные. Для того чтобы временные сообщения не выбрасывались из очереди при перезапуске администратора очередей после временной или немедленной остановки, выберите значение Максимальное (однако временные сообщения могут быть выброшены в результате приоритетной остановки или неполадки). PERSISTENCE PER
Приоритет Задается приоритет сообщений, передаваемых адресату. Для того чтобы указать, что приоритет определяет приложение-клиент JMS, выберите значение Приложение. Значение Очередь по умолчанию означает, что приоритет определяет значение по умолчанию, заданное для очереди. В противном случае задайте приоритет от 0 до 9. PRIORITY PRI
Контекст сообщений MQMD Контекст указывается при отправке сообщений получателю. Доступны три варианта:

По умолчанию: Вызов API MQOPEN и структура MQPMO не задают контекст явным образом. Это значение по умолчанию.

Контекст All: Вызов API MQOPEN задает контекст сообщения MQOO_SET_ALL_CONTEXT, структура MQPMO - MQPMO_SET_ALL_CONTEXT.

Контекст Identity: Вызов API MQOPEN задает контекст сообщения MQOO_SET_IDENTITY_CONTEXT, структура MQPMO - MQPMO_SET_IDENTITY_CONTEXT.

MDMSGCTX MDCTX
Поддержка записи MQMD Позволяет разрешить или запретить приложению JMS задавать значения полей MQMD. Доступны два варианта:

Нет: Все свойства JMS_IBM_MQMD* игнорируются и их значения не копируются в связанную структуру MQMD. Это значение по умолчанию.

Да: Свойства JMS_IBM_MQMD* обрабатываются. Их значения копируются в структуру MQMD.
MDWRITE MDW
Поддержка чтения MQMD Позволяет разрешить или запретить приложению JMS считывать значения полей MQMD. Доступны два варианта:

Нет: Свойства JMS_IBM_MQMD* отправленных сообщений не обновляются с учетом обновленных значений в MQMD. В принимаемых сообщениях свойства JMS_IBM_MQMD* недоступны даже в том случае, если они были заданы отправителем. Это значение по умолчанию.

Да: Свойства JMS_IBM_MQMD* отправленных сообщений обновляются с учетом обновленных значений в MQMD. В том числе обновляются те свойства, которые не были заданы отправителем явным образом. В принимаемых сообщениях доступны все свойства JMS_IBM_MQMD*, включая те из них, которые не были заданы отправителем явным образом.
MDREAD MDR
Тело сообщения Позволяет разрешить или запретить приложению JMS обрабатывать MQRFH2 из сообщения IBM MQ вместе с телом сообщения JMS. Доступны три варианта:

Не указано: При отправке сообщений; созданием заголовка MQRFH2 классами IBM MQ для JMS управляет свойство WMQ_TARGET_CLIENT. При получении сообщений, заголовок MQRFH2 обрабатывается таким образом, если бы было указано значение JMS. Это значение по умолчанию.

JMS: При отправке сообщений; классы IBM MQ для JMS автоматически создают заголовок MQRFH2 и добавляют его в сообщение IBM MQ. При получении сообщений; Классы IBM MQ для JMS задают свойства сообщения JMS с учетом содержимого MQRFH2 (если он задан); MQRFH2 не рассматривается как часть тела сообщения JMS.

MQ: При отправке сообщений; классы IBM MQ для JMS не создают заголовок MQRFH2. При получении сообщений; Классы IBM MQ для JMS рассматривают MQRFH2 как часть тела сообщения JMS.

MSGBODY MBODY
Преобразование при получении Настраивает использование опции MQGMO_CONVERT. При запросе сообщений указывается, где должно выполняться преобразование: в администраторе очередей (если в MQGET задана опция MQGMO_CONVERT) или в приложении клиента. RECEIVECONVERSION RCNV
CCSID получения Запрашиваемый CCSID, в который преобразуется сообщение. Используется, когда классы IBM MQ для JMS запрашивают администратор очередей для выполнения преобразования (например при указании WMQ_RECEIVE_CONVERSION_QMGR в качестве аргумента для setReceiveConversion). Значением этого свойства является CCSID, который запрашивается администратором очередей для преобразования сообщения. Значение по умолчанию: CCSID 1208. RECEIVECCSID RCCS

Страница Посредник

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

Табл. 3. . Свойства страницы Посредник
Свойство Назначение Длинное имя Короткое имя
Очередь гарантированной подписки посредника Это свойство может использоваться в клиенте JMS IBM WebSphere MQ 7.0 и выше, но не влияет на администратора очередей IBM WebSphere MQ 7.0 и выше.

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

В противном случае необходимо указать имя очереди, из которой получаются сообщения гарантированной подписки. Очередью по умолчанию является SYSTEM.JMS.D.SUBSCRIBER.QUEUE.
BROKERDURSUBQ BDSUB
Очередь сообщений гарантированной подписки CC посредника Это свойство может использоваться в клиенте JMS IBM WebSphere MQ 7.0 и выше, но не влияет на администратора очередей IBM WebSphere MQ 7.0 и выше

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

В противном случае необходимо указать имя очереди, из которой получаются сообщения гарантированной подписки для ConnectionConsumer. Очередью по умолчанию является SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE.
BROKERCCDURSUBQ CCDSUB
Поток публикаций Это свойство может использоваться в клиенте JMS IBM WebSphere MQ 7.0 и выше, но не влияет на администратора очередей IBM WebSphere MQ 7.0 и выше.

Вводится или выбирается имя очереди, в которую передаются публикуемые сообщения (очередь потока). Очередью по умолчанию является SYSTEM.BROKER.DEFAULT.STREAM. Для того чтобы можно было воспользоваться кнопкой Выбрать для ввода имени, значение свойства Администратор гарантированных очередей посредника должно быть уже выбрано, и данный администратор очередей должен быть запущен.

BROKERPUBQ BPUB
Администратор очередей публикаций посредника Выбирается или вводится имя администратора очередей с очередью, в которую передаются публикуемые по данной теме сообщения. BROKERPUBQMGR BPQM
Версия посредника Это свойство может использоваться в клиенте JMS IBM WebSphere MQ 7.0 и выше, но не влияет на администратора очередей IBM WebSphere MQ 7.0 и выше.

Выбирается версия используемого посредника. Выберите V1 для применения посредника публикации/подписки IBM MQ или IBM Integration Bus в режиме совместимости; это значение по умолчанию, если для свойства Транспортный протокол указано значение Bindings или Client. Выберите V2 для применения посредника IBM Integration Bus во внутреннем режиме; это значение по умолчанию, если для свойства Транспортный протокол указано значение Direct или DirectHTTP.

BROKERVER BVER

Страница Поставщики

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

Табл. 4. . Свойства страницы Поставщики
Свойство Назначение Длинное имя Короткое имя
Разрешить асинхронную отправку Это свойство определяет, разрешено ли поставщикам сообщений использовать асинхронную отправку для передачи сообщений данному адресату. Для того чтобы разрешить поставщикам сообщений обращение к очереди или определению темы, выберите значение Согласно адресату (применяется по умолчанию). Для разрешения асинхронной отправки выберите Разрешено; для запрещения асинхронной отправки выберите Запрещено. PUTASYNCALLOWED PAA

Страница Получатели

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

Табл. 5. . Свойства страницы Получатели
Свойство Назначение Длинное имя Короткое имя
Разрешение упреждающего чтения Это свойство определяет, разрешено ли получателю сообщений и браузерам очередей использовать упреждающее чтение для получения временных сообщений с данного адресата в буфер клиента перед получением. Для того чтобы разрешить упреждающее чтение с обращением к очереди или определению темы, выберите значение Согласно адресату (применяется по умолчанию). Для разрешения упреждающего чтения выберите Разрешено; для запрещения упреждающего чтения выберите Запрещено. READAHEADALLOWED RAA
Стратегия закрытия с упреждающим чтением Для сообщений, доставляемых асинхронному получателю сообщений, это свойство определяет, что должно происходить с сообщением в очереди прокси-сервера клиента при закрытии получателя сообщений. Для того чтобы указать, что все сообщения в очереди прокси-сервера клиента доставляются MessageListener приложения до возврата, выберите значение Доставка всех (применяется по умолчанию). Для завершения только текущего вызова MessageListener перед возвратом с возможным отбрасыванием остающихся в очереди прокси-сервера клиента сообщений выберите значение Доставка текущего. READAHEADCLOSEPOLICY RACP
Формат символов подстановки Указывает версию применяемого синтаксиса символов подстановки.

При выборе Только символьные символы подстановки используются только символьные символы подстановки (для согласования с приложениями, которые раньше использовали посредник версии 1; см. свойство Версия посредника).

При выборе Только тематические символы подстановки используются только символы подстановки тематического уровня, которые используются в посреднике версии 2.
WILDCARDFORMAT WCFMT

Страница Расширенные

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

Табл. 6. . Расширенные свойства страницы
Свойство Назначение Длинное имя Короткое имя
Закодированный ИД набора символов Вводится ИД набора кодированных символов (CCSID), используемого для адресатов. CCSID CCS
Кодировка Это свойство позволяет выбрать схему кодирования, применяемую для данного адресата. Дополнительные сведения можно найти в разделе Настройка объектов JMS с помощью инструмента администрирования в IBM Knowledge Center. ENCODING ENC
Ошибка в случае приостановки Это свойство служит для указания объявления того, что вызовы определенных методов не удались, если администратор очередей находится в приостановленном состоянии. Для указания объявления того, что вызовы определенных методов не удались, если администратор очередей находится в приостановленном состоянии, выберите Да. Это означает, что если приложение обнаружит, что администратор очередей приостановлен, то оно должно завершить свою текущую задачу и закрыть соединение, чтобы разрешить остановку администратора очередей. Для указания того, чтобы ошибка вызова никакого метода не объявлялась по причине приостановки администратора очередей, выберите Нет. Это означает, что приложение не обнаружит, что администратор очередей приостановлен, и будет продолжать работать с ним, в результате чего администратор очередей остановлен не будет. FAILIFQUIESCE FIQ
Многоадресная передача Указывает, используется ли многоадресная передача для доставки сообщений получателям сообщений. Многоадресная передача применяется только для тематических отправлений и может использоваться, только когда фабрика соединений использует передачу типа Прямая IP. Транспорт типа типа Прямая IP недоступен в IBM MQ 8.0. В случае применения IBM MQ 8.0 можно указать транспорт типа типа Прямая IP, однако он не сможет создать соединение.

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

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

MULTICAST MCAST
Многоадресная передача (непрерывная)

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

Выберите значение Ненадежная для доставки сообщений с использованием многоадресной передачи, но без применения услуги надежного качества. Для надежной многоадресной передачи тема должна настраиваться в посреднике; надежное качество услуги не используется, даже если тема настроена на надежную многоадресную передачу.
MULTICAST MCAST
Целевой клиент

Выберите JMS, для того чтобы указать приложение JMS в качестве получателя сообщения.

Выберите MQ, для того чтобы указать в качестве получателя сообщения приложение IBM MQ без поддержки JMS.

TARGCLIENT TC
Стиль получателя ReplyTo

Укажите формат поля JMSReplyTo.

Выберите По умолчанию для применения значения по умолчанию. Значение по умолчанию соответствует информации из RFH2, если не задано системное свойство JVM.

Выберите MQMD для применения значения, указанного в заголовке MQMD. В этом случае значение поля администратора очередей извлекается из MQMD.

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

REPLYTOSTYLE RTOST
Преобразование при получении Настраивает использование опции MQGMO_CONVERT. При запросе сообщений указывается, где должно выполняться преобразование: в администраторе очередей (если в MQGET задана опция MQGMO_CONVERT) или в приложении клиента. RECEIVECONVERSION RCNV
CCSID получения Запрашиваемый CCSID, в который преобразуется сообщение. Используется, когда классы IBM MQ для JMS запрашивают администратор очередей для выполнения преобразования (например при указании WMQ_RECEIVE_CONVERSION_QMGR в качестве аргумента для setReceiveConversion). Значением этого свойства является CCSID, который запрашивается администратором очередей для преобразования сообщения. Значение по умолчанию: CCSID 1208. RECEIVECCSID RCCS