Свойства определения службы IBM MQ

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

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

Приводятся краткое описание каждого атрибута и его настройка.

Общие

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

Атрибут Описание
Пространство имен Задает пространство имен для службы. Этому свойству уже присвоено временное значение по умолчанию.
Имя Уникальное имя нового определения службы. Регистр символов в именах определений не учитывается, но если регистр смешанный, то это сохраняется.
Шаблон обмена сообщениями Шаблон обмена сообщениями описывает направление отправки и получения сообщений в процессе вызова службы. Возможны два варианта:
  • Односторонний - означает, что сообщение отправляется только в одну сторону.
  • Запрос-ответ - означает, что в ответ на полученное сообщение отправляется ответ.
Тип привязки Версия спецификации определений служб IBM® MQ.
Комментарий Введите комментарий, описывающий службу в файле WSDL.

Страница Операция

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

Атрибут Описание
Имя операции Задает имя операции. Значение этого свойства необходимо для создания определения службы.
Значение атрибута action для элемента Используется поставщиком службы для диспетчеризации служебных запросов. Пример: развертывание нескольких служб с одним целевым ресурсом. Позволяет поручить поставщику службы распределение поступающих в этот ресурс запросов.

Для типа привязки MQ атрибут Action содержит значение targetAction.

Комментарий Комментарий, описывающий операцию в файле WSDL.

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

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

Атрибут Описание
Имя получателя ввода Указывает имя целевой очереди или раздела, в который отправляется запрос. Пример:
Элемент queue-dest или topic-dest IRI IBM MQ:

msg/queue/INS.QUOTE.REPLY
Имя целевого администратора очередей Задает имя целевого администратора очередей.
Администратор очередей соединения Задает имя целевого администратора очередей для подключения запрашивающей службы. В вызовах MQCONN() и MQCONNX() это свойство соответствует параметру QmgrName.
Свойства соединения с клиентом Свойства соединения с клиентом подробно описывают привязки и содержат сведения о привязке клиента службы к определенной системе или каналу. Хотя возможность указания привязок клиентов и имен каналов иногда полезна, но слишком подробное описание службы может сузить область ее применения. Поэтому рекомендуется описывать привязки в определении службы по минимуму, по возможности разрешая маршрутизацию сообщений базовой инфраструктуре или IBM MQ.
Имя таблицы каналов Указывает имя файла таблицы каналов клиента, используемого для идентификации соединений с каналом.
  • Если свойство Имя таблицы каналов не задано, то свойство Библиотека таблицы каналов игнорируется.
  • Если в среде, в которой работает клиентское приложение, задана переменная среды MQSERVER или MQCHLTAB, то параметр Имя таблицы каналов.
Библиотека таблицы каналов Задает путь к таблице каналов клиента.
  • Если в среде, в которой работает клиентское приложение, задана переменная среды MQSERVER или MQCHLLIB, то параметр Библиотека таблицы каналов игнорируется.
  • Если свойство Имя таблицы каналов не задано, то свойство Библиотека таблицы каналов игнорируется.
Имя соединения канала клиента Указывает строку соединения, с помощью которой клиент службы устанавливает соединение с привязкой клиента IBM MQ MQI. Для соединения TCP/IP сначала указывается имя хоста, затем номер порта, например:

OS2ROG3(1822)
Если номер порта не указан, то применяется значение по умолчанию 1414.
  • Вместе со свойством Имя соединения канала клиента должны быть заданы свойства Имя канала клиента и Тип транспорта канала клиента.
  • Если в среде, в которой работает клиентское приложение, задана переменная среды MQSERVER или MQCHLTAB, то параметр Имя канала соединения с клиентом игнорируется.
Имя канала клиента Указывает канал, используемый при установке соединений клиента службы IBM MQ с привязкой клиента IBM MQ MQI.
  • Вместе со свойством Имя соединения канала клиента должны быть заданы свойства Имя канала клиента и Тип транспорта канала клиента.
  • Если в среде, в которой работает клиентское приложение, задана переменная среды MQSERVER или MQCHLTAB, то параметр Имя канала клиента игнорируется.
Тип транспорта канала клиента Задает тип транспорта, используемый при установке соединений клиента службы IBM MQ с привязкой клиента IBM MQ MQI.
  • Вместе со свойством Имя соединения канала клиента должны быть заданы свойства Имя канала клиента и Тип транспорта канала клиента.
  • Если в среде, в которой работает клиентское приложение, задана переменная среды MQSERVER или MQCHLTAB, то параметр Тип транспорта игнорируется.
Для этого параметра можно выбрать два значения:
  • TCP. Указывает, что в качестве транспортного протокола используется TCP/IP. Это значение по умолчанию.
  • LU62. Указывает, что в качестве транспортного протокола используется LU6.2.

Страница Схема входного сообщения

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

Атрибут Описание
Тип входящих данных Задает ожидаемый тип входящих данных. Простые типы могут быть смоделированы с помощью встроенных типов xsd XML, например, xsd:string или xsd:int. Более сложные типы можно импортировать из внешнего файла, указав для них значения Импорт файла схемы и Импорт пространства имен.
Файл схемы импорта Файл схемы, который требуется импортировать.
Пространство имен импорта Задает пространство имен, которое требуется импортировать.

Страница Заголовок входного сообщения

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

Атрибут Описание
CCSID Указывает ИД кодированного набора символов. В структуре MQMD это свойство соответствует полю CodedCharSetId. Если это значение не указано, то клиент и поставщик службы используют значение, соответствующее набору символов данных сообщения.
Формат Задает название формата данных сообщения. Это свойство соответствует полю формата MQRFH2 или полю формата MQMD, если MQRFH2 отсутствует. Значение должно представлять собой строку из 0-8 символов, состоящую из букв A-Z и цифр 0–9.

В свойстве Формат можно указать любое значение в соответствии с рекомендациями в разделе Поле формата.

Свойства пользователя Определяемые пользователем данные, передаваемые в служебных сообщениях IBM MQ. Значения необходимо указывать в формате, разрешенном для элементов папки RFH2; в виде цепочек триплетов, закодированных под XML:

<name dt="datatype">значение</name>
Элемент dt="datatype" необязательный, в случае его отсутствия по умолчанию принимается строка, разрешающая задавать элементы как:

<name>значение</name>
Например:

<myprop1>значение-1</myProp1><myprop2>значение-2</myProp2><myprop3 dt="i4">99</myProp3>
Дополнительная информация о разрешенных типах данных и форматировании приведена в разделе NameValueData ( MQCHARn ) в IBM Knowledge Center. Не рекомендуется включать свойства, для которых требуется защита, например, ИД пользователей или пароли.
Тип сообщения Тип отправляемого сообщения. В структуре MQMD это свойство соответствует MsgType. Возможные значения:
  • Не указано: значение не задано, следовательно, оно берется из значения параметра Шаблон обмена сообщениями. Это значение по умолчанию.
  • Запрос: сообщение является запросом, на который требуется ответ. Это значение говорит о том, что служба обменивается сообщениями по шаблону "запрос-ответ".
  • Ответ: сообщение является ответом на запрос.
  • Отчет: сообщение является отчетом.
  • Дейтаграмма: служба работает с односторонним обменом сообщениями, следовательно, ответа не будет.
Если значение не указано, то оно задается автоматически в соответствии со значением Шаблон обмена сообщениями.
Постоянство Указывает, является ли сообщение регулярным. В структуре MQMD это свойство соответствует полю Хранение. Возможны следующие три значения:
  • Не регулярное - означает, что сообщения не являются регулярными.
  • Регулярное - означает, что сообщения регулярные.
  • По умолчанию для очереди - означает, что регулярность сообщения определяется администратором очередей по описанию места назначения сообщения. Это значение по умолчанию.
ИД сообщения Указывает ИД сообщения. В структуре MQMD соответствует полю MsgId.

ИД сообщения позволяет описывать некоторые специализированные приложения IBM MQ как службы (например: приложения, работающие с общей очередью входящих сообщений и выбирающие сообщения по значению msgId). Заранее указанные значения msgId в определениях службы могут привести к таким неполадкам, как возвращение msgId запроса при использовании шаблона обмена сообщениями "Запрос-ответ".

ИД сообщения должен быть либо строкой символов, либо двоичным числом. Двоичные значения должны представлять собой строку из минимум 24 пар двузначных шестнадцатеричных чисел.

Для открытия окна и ввода значения в виде текста или последовательности байт щелкните на Изменить.

ИД зависимости Идентификатор зависимости. В структуре MQMD это свойство соответствует полю CorrelId. ИД зависимости должен быть либо строкой символов, либо двоичным числом. Двоичные значения должны представлять собой строку из минимум 24 пар двузначных шестнадцатеричных чисел.

Для открытия окна и ввода значения в виде текста или последовательности байт щелкните на Изменить.

Срок действия Задает время жизни сообщения. Это должно быть целое число со знаком. Измеряется в десятых долях секунды. Диапазон значений свойства Срок действия - от 1 до 2 147 483 647.

Для указания неограниченного срока действия служит особое значение Не ограничен. При этом в файл WSDL записывается значение -1.

Значение Не задано означает, что в файл WSDL не записывается никакое значение. Это значение по умолчанию.

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

Для обозначения того, что приоритет сообщения берется из определения первой очереди, в которой находится сообщение, служит значение Не ограничен. При этом в файл WSDL записывается значение -1.

Значение Не задано означает, что в файл WSDL не записывается никакое значение. Это значение по умолчанию.

Кодировка Указывает числовую кодировку данных сообщения. В структуре MQMD это свойство соответствует полю Кодировка:
  • Целое число - позволяет выбрать тип Обычная или Обратная.
  • Десятичное число - позволяет выбрать тип Обычная или Обратная.
  • Число с плавающей точкой - позволяет выбрать тип Обычная, Обратная или S390.
  • Мнемоника - задает три символьных мнемоники, соответствующие остальным выбираемым значениям. R = Обратная, N = Обычная и 3 = S390.
  • Значение - задает числовое значение выбранных вариантов и мнемоники.
Параметры отчета Задает, как поставщик службы устанавливает идентификаторы сообщения и зависимости в сообщении-ответе. В структуре MQMD это свойство соответствует полю Отчет. Возможные значения:
  • Новый ИД сообщения - указывает, что в ответ на данное сообщение создается отчетное или ответное сообщение, для которого создается новый msgId.
  • Старый ИД сообщения указывает, что если в ответ на данное сообщение создано отчетное или ответное сообщение, то его идентификатором msgId станет msgId исходного сообщения.
  • Копировать ИД сообщения в ИД зависимости указывает, что если в ответ на данное сообщение создается отчетное или ответное сообщение, то msgId исходного сообщения копируется в correlId отчета или ответа.
  • Старый ИД зависимости указывает, что если в ответ на данное сообщение создается отчетное или ответное сообщение, то correlId исходного сообщения копируется в correlId отчета или ответа.

Страница Получатель вывода

В следующей таблице перечислены атрибуты, которые можно установить на странице Получатель вывода в окне диалога Свойства определения службы. Страницы вывода определяют свойства сообщения, которое отправляет служба в ответ на входящее сообщение, и целевой ресурс, в который оно будет помещено. Для имени целевого ресурса получателя необходимо указать префикс: для очередей - 'msg/queue/', для разделов - 'msg/topic/'.

Атрибут Описание
Имя получателя вывода Указывает имя целевой очереди или раздела, в который отправляется ответное сообщение. В структуре MQMD соответствует полям ReplyToQ и ReplyToQMgr. Имя целевого ресурса должно указываться в элементе queue-dest или topic-dest URI IBM MQ, например:

msg/queue/INS.QUOTE.REPLY
Имя целевого администратора очередей Задает имя целевого администратора очередей.
Администратор очередей соединения Задает имя целевого администратора очередей для подключения запрашивающей службы. В вызовах MQCONN() и MQCONNX() это свойство соответствует параметру QmgrName.
Свойства соединения с клиентом Свойства соединения с клиентом подробно описывают привязки и содержат сведения о привязке клиента службы к определенной системе или каналу. Хотя возможность указания привязок клиентов и имен каналов иногда полезна, но слишком подробное описание службы может сузить область ее применения. Поэтому рекомендуется описывать привязки в определении службы по минимуму, по возможности разрешая маршрутизацию сообщений базовой инфраструктуре или IBM MQ.
Имя таблицы каналов Указывает имя файла таблицы каналов клиента, используемого для идентификации соединений с каналом.
  • Если свойство Имя таблицы каналов не задано, то свойство Библиотека таблицы каналов игнорируется.
  • Если в среде, в которой работает клиентское приложение, задана переменная среды MQSERVER или MQCHLTAB, то параметр Имя таблицы каналов.
Библиотека таблицы каналов Задает путь к таблице каналов клиента.
  • Если в среде, в которой работает клиентское приложение, задана переменная среды MQSERVER или MQCHLLIB, то параметр Библиотека таблицы каналов игнорируется.
  • Если свойство Имя таблицы каналов не задано, то свойство Библиотека таблицы каналов игнорируется.
Имя канала клиента Указывает строку соединения, с помощью которой клиент службы устанавливает соединение с привязкой клиента IBM MQ MQI. Для соединения TCP/IP сначала указывается имя хоста, затем номер порта, например:

OS2ROG3(1822)
Если номер порта не указан, то применяется значение по умолчанию 1414.
  • Вместе со свойством Имя соединения канала клиента должны быть заданы свойства Имя канала клиента и Тип транспорта канала клиента.
  • Если в среде, в которой работает клиентское приложение, задана переменная среды MQSERVER или MQCHLTAB, то параметр Имя канала соединения с клиентом игнорируется.
Имя соединения канала клиента Указывает канал, используемый при установке соединений клиента службы IBM MQ с привязкой клиента IBM MQ MQI.
  • Вместе со свойством Имя соединения канала клиента должны быть заданы свойства Имя канала клиента и Тип транспорта канала клиента.
  • Если в среде, в которой работает клиентское приложение, задана переменная среды MQSERVER или MQCHLTAB, то параметр Имя канала клиента игнорируется.
Тип транспорта канала клиента Задает тип транспорта, используемый при установке соединений клиента службы IBM MQ с привязкой клиента IBM MQ MQI.
  • Вместе со свойством Имя соединения канала клиента должны быть заданы свойства Имя канала клиента и Тип транспорта канала клиента.
  • Если в среде, в которой работает клиентское приложение, задана переменная среды MQSERVER или MQCHLTAB, то параметр Тип транспорта игнорируется.
Для этого параметра можно выбрать два значения:
  • TCP. Указывает, что в качестве транспортного протокола используется TCP/IP. Это значение по умолчанию.
  • LU62. Указывает, что в качестве транспортного протокола используется LU6.2.

Страница Схема выходного сообщения

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

Атрибут Описание
Тип исходящих данных Задает ожидаемый тип исходящих данных.
Файл схемы импорта Файл схемы, который требуется импортировать.
Пространство имен импорта Задает пространство имен, которое требуется импортировать.

Страница Заголовок выходного сообщения

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

Атрибут Описание
CCSID Указывает ИД кодированного набора символов. В структуре MQMD это свойство соответствует полю CodedCharSetId. Если это значение не указано, то клиент и поставщик службы используют значение, соответствующее набору символов данных сообщения.
Формат Задает название формата данных сообщения. Это свойство соответствует полю формата MQRFH2 или полю формата MQMD, если MQRFH2 отсутствует. Значение должно представлять собой строку из 0-8 символов, состоящую из букв A-Z и цифр 0–9.

В свойстве Формат можно указать любое значение в соответствии с рекомендациями в разделе Поле формата.

Свойства пользователя Определяемые пользователем данные, передаваемые в служебных сообщениях IBM MQ. Значения необходимо указывать в формате, разрешенном для элементов папки RFH2; в виде цепочек триплетов, закодированных под XML:

<name dt="datatype">значение</name>
Элемент dt="datatype" необязательный, в случае его отсутствия по умолчанию принимается строка, разрешающая задавать элементы как:

<name>значение</name>
Например:

<myprop1>значение-1</myProp1><myprop2>значение-2</myProp2><myprop3 dt="i4">99</myProp3>
Дополнительная информация о разрешенных типах данных и форматировании приведена в разделе NameValueData ( MQCHARn ) в IBM Knowledge Center. Не рекомендуется включать свойства, для которых требуется защита, например, ИД пользователей или пароли.
Тип сообщения Тип отправляемого сообщения. В структуре MQMD это свойство соответствует MsgType. Возможные значения:
  • Не указано: значение не задано, следовательно, оно берется из значения параметра Шаблон обмена сообщениями. Это значение по умолчанию.
  • Запрос: сообщение является запросом, на который требуется ответ. Это значение говорит о том, что служба обменивается сообщениями по шаблону "запрос-ответ".
  • Ответ: сообщение является ответом на запрос.
  • Отчет: сообщение является отчетом.
  • Дейтаграмма: служба работает с односторонним обменом сообщениями, следовательно, ответа не будет.
Если значение не указано, то оно задается автоматически в соответствии со значением Шаблон обмена сообщениями.
Постоянство Указывает, является ли сообщение регулярным. В структуре MQMD это свойство соответствует полю Хранение. Возможны следующие три значения:
  • Не регулярное - означает, что сообщения не являются регулярными.
  • Регулярное - означает, что сообщения регулярные.
  • По умолчанию для очереди - означает, что регулярность сообщения определяется администратором очередей по описанию места назначения сообщения. Это значение по умолчанию.
ИД сообщения Указывает ИД сообщения. В структуре MQMD соответствует полю MsgId.

ИД сообщения позволяет описывать некоторые специализированные приложения IBM MQ как службы (например: приложения, работающие с общей очередью входящих сообщений и выбирающие сообщения по значению msgId). Заранее указанные значения msgId в определениях службы могут привести к таким неполадкам, как возвращение msgId запроса при использовании шаблона обмена сообщениями "Запрос-ответ".

ИД сообщения должен быть либо строкой символов, либо двоичным числом. Двоичные значения должны представлять собой строку из минимум 24 пар двузначных шестнадцатеричных чисел.

Для открытия окна и ввода значения в виде текста или последовательности байт щелкните на Изменить.

ИД зависимости Идентификатор зависимости. В структуре MQMD это свойство соответствует полю CorrelId. ИД зависимости должен быть либо строкой символов, либо двоичным числом. Двоичные значения должны представлять собой строку из минимум 24 пар двузначных шестнадцатеричных чисел.

Для открытия окна и ввода значения в виде текста или последовательности байт щелкните на Изменить.

Срок действия Задает время жизни сообщения. Это должно быть целое число со знаком. Измеряется в десятых долях секунды. Диапазон значений свойства Срок действия - от 1 до 2 147 483 647.

Для указания неограниченного срока действия служит особое значение Не ограничен. При этом в файл WSDL записывается значение -1.

Значение Не задано означает, что в файл WSDL не записывается никакое значение. Это значение по умолчанию.

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

Для обозначения того, что приоритет сообщения берется из определения первой очереди, в которой находится сообщение, служит значение Не ограничен. При этом в файл WSDL записывается значение -1.

Значение Не задано означает, что в файл WSDL не записывается никакое значение. Это значение по умолчанию.

Кодировка Указывает числовую кодировку данных сообщения. В структуре MQMD это свойство соответствует полю Кодировка:
  • Целое число - позволяет выбрать тип Обычная или Обратная.
  • Десятичное число - позволяет выбрать тип Обычная или Обратная.
  • Число с плавающей точкой - позволяет выбрать тип Обычная, Обратная или S390.
  • Мнемоника - задает три символьных мнемоники, соответствующие остальным выбираемым значениям. R = Обратная, N = Обычная и 3 = S390.
  • Значение - задает числовое значение выбранных вариантов и мнемоники.
Параметры отчета Задает, как поставщик службы устанавливает идентификаторы сообщения и зависимости в сообщении-ответе. В структуре MQMD это свойство соответствует полю Отчет. Возможные значения:
  • Новый ИД сообщения - указывает, что в ответ на данное сообщение создается отчетное или ответное сообщение, для которого создается новый msgId.
  • Старый ИД сообщения указывает, что если в ответ на данное сообщение создано отчетное или ответное сообщение, то его идентификатором msgId станет msgId исходного сообщения.
  • Копировать ИД сообщения в ИД зависимости указывает, что если в ответ на данное сообщение создается отчетное или ответное сообщение, то msgId исходного сообщения копируется в correlId отчета или ответа.
  • Старый ИД зависимости указывает, что если в ответ на данное сообщение создается отчетное или ответное сообщение, то correlId исходного сообщения копируется в correlId отчета или ответа.