Свойства определения службы IBM MQ
Свойства и атрибуты определения службы можно указать при создании нового определения службы или в процессе редактирования существующего определения службы.
Отдельные атрибуты доступны только для конкретных типов привязок и шаблонов обмена сообщениями. Перейдите по следующим ссылкам для просмотра свойств, доступных на разных страницах свойств определения службы.
- Общие
- Операция
- Получатель ввода
- Схема входного сообщения
- Заголовок входного сообщения
- Получатель вывода
- Схема выходного сообщения
- Заголовок выходного сообщения
Приводятся краткое описание каждого атрибута и его настройка.
Общие
В следующей таблице перечислены атрибуты, которые можно установить на странице Общие в окне диалога Свойства определения службы.
Атрибут | Описание |
---|---|
Пространство имен | Задает пространство имен для службы. Этому свойству уже присвоено временное значение по умолчанию. |
Имя | Уникальное имя нового определения службы. Регистр символов в именах определений не учитывается, но если регистр смешанный, то это сохраняется. |
Шаблон обмена сообщениями | Шаблон обмена сообщениями описывает направление отправки и получения сообщений в процессе вызова службы.
Возможны два варианта:
|
Тип привязки | Версия спецификации определений служб IBM® MQ. |
Комментарий | Введите комментарий, описывающий службу в файле WSDL. |
Страница Операция
В следующей таблице перечислены атрибуты, которые можно установить на странице Операция в окне диалога Свойства определения службы. Каждое определение службы содержит только одну операцию.
Атрибут | Описание |
---|---|
Имя операции | Задает имя операции. Значение этого свойства необходимо для создания определения службы. |
Значение атрибута action для элемента | Используется поставщиком службы для диспетчеризации служебных запросов. Пример: развертывание нескольких служб с одним целевым ресурсом. Позволяет поручить поставщику службы распределение поступающих в этот ресурс запросов. Для типа привязки MQ атрибут Action содержит значение targetAction. |
Комментарий | Комментарий, описывающий операцию в файле WSDL. |
Страница Получатель ввода
В следующей таблице перечислены атрибуты, которые можно установить на странице Получатель ввода в окне диалога Свойства определения службы. Страницы ввода определяют свойства сообщения, которое ожидает служба, и целевой ресурс, откуда оно будет извлечено.
Атрибут | Описание |
---|---|
Имя получателя ввода | Указывает имя целевой очереди или раздела, в который отправляется запрос. Пример: Элемент queue-dest или topic-dest IRI IBM MQ:
|
Имя целевого администратора очередей | Задает имя целевого администратора очередей. |
Администратор очередей соединения | Задает имя целевого администратора очередей для подключения запрашивающей службы. В вызовах MQCONN() и MQCONNX() это свойство соответствует параметру QmgrName. |
Свойства соединения с клиентом | Свойства соединения с клиентом подробно описывают привязки и содержат сведения о привязке клиента службы к определенной системе или каналу. Хотя возможность указания привязок клиентов и имен каналов иногда полезна, но слишком подробное описание службы может сузить область ее применения. Поэтому рекомендуется описывать привязки в определении службы по минимуму, по возможности разрешая маршрутизацию сообщений базовой инфраструктуре или IBM MQ. |
Имя таблицы каналов | Указывает имя файла таблицы каналов клиента, используемого для идентификации соединений с каналом.
|
Библиотека таблицы каналов | Задает путь к таблице каналов клиента.
|
Имя соединения канала клиента | Указывает строку соединения, с помощью которой клиент службы устанавливает соединение с привязкой клиента IBM MQ MQI. Для соединения TCP/IP сначала указывается имя хоста, затем номер порта, например:
Если номер порта не указан, то применяется значение по умолчанию 1414.
|
Имя канала клиента | Указывает канал, используемый при установке соединений клиента службы IBM MQ с привязкой клиента IBM MQ MQI.
|
Тип транспорта канала клиента | Задает тип транспорта, используемый при установке соединений клиента службы IBM MQ с привязкой клиента IBM MQ MQI.
|
Страница Схема входного сообщения
В следующей таблице перечислены атрибуты, которые можно установить на странице Схема входного сообщения в окне диалога Свойства определения службы. Они позволяют определять схему для данных, содержащихся в сообщении.
Атрибут | Описание |
---|---|
Тип входящих данных | Задает ожидаемый тип входящих данных. Простые типы могут быть смоделированы с помощью встроенных типов xsd XML, например, xsd:string или xsd:int .
Более сложные типы можно импортировать из внешнего файла, указав для них значения Импорт файла схемы и Импорт пространства имен. |
Файл схемы импорта | Файл схемы, который требуется импортировать. |
Пространство имен импорта | Задает пространство имен, которое требуется импортировать. |
Страница Заголовок входного сообщения
В следующей таблице перечислены атрибуты, которые можно установить на странице Заголовок входного сообщения в окне диалога Свойства определения службы. Страницы ввода определяют свойства сообщения, которое ожидает служба, и целевой ресурс, откуда оно будет извлечено. Некоторые свойства применяются только к определениям служб с типом привязки MQ.
Атрибут | Описание |
---|---|
CCSID | Указывает ИД кодированного набора символов. В структуре MQMD это свойство соответствует полю CodedCharSetId. Если это значение не указано, то клиент и поставщик службы используют значение, соответствующее набору символов данных сообщения. |
Формат | Задает название формата данных сообщения. Это свойство соответствует полю формата MQRFH2 или полю формата MQMD, если MQRFH2 отсутствует. Значение должно представлять собой строку из 0-8 символов, состоящую из букв A-Z и цифр 0–9. В свойстве Формат можно указать любое значение в соответствии с рекомендациями в разделе Поле формата. |
Свойства пользователя | Определяемые пользователем данные, передаваемые в служебных сообщениях IBM MQ. Значения необходимо указывать в формате, разрешенном для элементов папки RFH2; в виде цепочек триплетов, закодированных под XML:
Элемент dt="datatype " необязательный, в случае его отсутствия по умолчанию принимается строка, разрешающая задавать элементы как:
Например:
Дополнительная информация о разрешенных типах данных и
форматировании приведена в разделе
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 это свойство соответствует полю Кодировка:
|
Параметры отчета | Задает, как поставщик службы устанавливает идентификаторы сообщения и зависимости в сообщении-ответе.
В структуре MQMD это свойство соответствует полю Отчет.
Возможные значения:
|
Страница Получатель вывода
В следующей таблице перечислены атрибуты, которые можно установить на странице Получатель вывода в окне диалога Свойства определения службы. Страницы вывода определяют свойства сообщения, которое отправляет служба в ответ на входящее сообщение, и целевой ресурс, в который оно будет помещено. Для имени целевого ресурса получателя необходимо указать префикс: для очередей - 'msg/queue/', для разделов - 'msg/topic/'.
Атрибут | Описание |
---|---|
Имя получателя вывода | Указывает имя целевой очереди или раздела, в который отправляется ответное сообщение. В структуре MQMD соответствует полям ReplyToQ и ReplyToQMgr. Имя целевого ресурса должно указываться в элементе queue-dest или topic-dest URI IBM MQ, например:
|
Имя целевого администратора очередей | Задает имя целевого администратора очередей. |
Администратор очередей соединения | Задает имя целевого администратора очередей для подключения запрашивающей службы. В вызовах MQCONN() и MQCONNX() это свойство соответствует параметру QmgrName. |
Свойства соединения с клиентом | Свойства соединения с клиентом подробно описывают привязки и содержат сведения о привязке клиента службы к определенной системе или каналу. Хотя возможность указания привязок клиентов и имен каналов иногда полезна, но слишком подробное описание службы может сузить область ее применения. Поэтому рекомендуется описывать привязки в определении службы по минимуму, по возможности разрешая маршрутизацию сообщений базовой инфраструктуре или IBM MQ. |
Имя таблицы каналов | Указывает имя файла таблицы каналов клиента, используемого для идентификации соединений с каналом.
|
Библиотека таблицы каналов | Задает путь к таблице каналов клиента.
|
Имя канала клиента | Указывает строку соединения, с помощью которой клиент службы устанавливает соединение с привязкой клиента IBM MQ MQI. Для соединения TCP/IP сначала указывается имя хоста, затем номер порта, например:
Если номер порта не указан, то применяется значение по умолчанию 1414.
|
Имя соединения канала клиента | Указывает канал, используемый при установке соединений клиента службы IBM MQ с привязкой клиента IBM MQ MQI.
|
Тип транспорта канала клиента | Задает тип транспорта, используемый при установке соединений клиента службы IBM MQ с привязкой клиента IBM MQ MQI.
|
Страница Схема выходного сообщения
В следующей таблице перечислены атрибуты, которые можно установить на странице Схема входного сообщения в окне диалога Свойства определения службы. Они позволяют определять схему для данных, содержащихся в сообщении.
Атрибут | Описание |
---|---|
Тип исходящих данных | Задает ожидаемый тип исходящих данных. |
Файл схемы импорта | Файл схемы, который требуется импортировать. |
Пространство имен импорта | Задает пространство имен, которое требуется импортировать. |
Страница Заголовок выходного сообщения
В следующей таблице перечислены атрибуты, которые можно установить на странице Заголовок выходного сообщения в окне диалога Свойства определения службы. Страницы вывода определяют свойства сообщения, которое отправляет служба в ответ на входящее сообщение, и целевой ресурс, в который оно будет помещено. Некоторые свойства применяются только к определениям служб с типом привязки MQ.
Атрибут | Описание |
---|---|
CCSID | Указывает ИД кодированного набора символов. В структуре MQMD это свойство соответствует полю CodedCharSetId. Если это значение не указано, то клиент и поставщик службы используют значение, соответствующее набору символов данных сообщения. |
Формат | Задает название формата данных сообщения. Это свойство соответствует полю формата MQRFH2 или полю формата MQMD, если MQRFH2 отсутствует. Значение должно представлять собой строку из 0-8 символов, состоящую из букв A-Z и цифр 0–9. В свойстве Формат можно указать любое значение в соответствии с рекомендациями в разделе Поле формата. |
Свойства пользователя | Определяемые пользователем данные, передаваемые в служебных сообщениях IBM MQ. Значения необходимо указывать в формате, разрешенном для элементов папки RFH2; в виде цепочек триплетов, закодированных под XML:
Элемент dt="datatype " необязательный, в случае его отсутствия по умолчанию принимается строка, разрешающая задавать элементы как:
Например:
Дополнительная информация о разрешенных типах данных и
форматировании приведена в разделе
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 это свойство соответствует полю Кодировка:
|
Параметры отчета | Задает, как поставщик службы устанавливает идентификаторы сообщения и зависимости в сообщении-ответе.
В структуре MQMD это свойство соответствует полю Отчет.
Возможные значения:
|