Программный интерфейс MQI. Основные функции

Дополнительные функции WebSphere MQ

Одним из важнейших приемов прикладного программирования для WebSphere MQ является использование транзакций, аналогичных транзакциям в базах данных. С помощью функций MQBEGIN , MQCMIT , MQBACK можно открыть транзакцию, завершить транзакцию успешно и откатить транзакцию, соответственно. В этом механизме прослеживается полная аналогия с транзакциями в базах данных. Программирование с использованием WebSphere MQ транзакций позволяет создавать надежные программы.

• MQBEGIN - функция, которая открывает WebSphere MQ транзакцию, координирует работу менеджера очередей и может использовать внешние ресурсы менеджера.

  Синтаксис:

  MQBEGIN (Hconn, BeginOptions, 
           CompCode, Reason)

  где:

  Hconn	-	идентификатор связи (connection handle) с менеджером очередей
  BeginOptions	-	опции MQBEGIN
  CompCode	-	код завершения
  Reason	-	код ошибки, детализирующий код завершения.

  Здесь BeginOptions дает ссылку на структуру MQBO (Begin options), поля которой показаны в таблице 8.6

  Таблица 8.6. Поля структуры MQBO

  Имя поля MQBO	Тип поля	Имя поля	Имя константы	Значение константы
  StrucId	MQCHAR4	Идентификатор структуры	MQBO_STRUC_ID	'BObb'
  Version	MQLONG	Номер версии структуры	MQBO_VERSION_1	1
  Options	MQLONG	Опции для управления MQBO	MQBO_NONE	0

  На языке С макропеременная MQBO_DEFAULT содержит значения, приведенные в табл.8.6, и может быть использована в тексте следующим образом: MQBO MyBO = {MQBO_DEFAULT};
• MQCMIT – функция, которая указывает на то, что все сообщения, прочитанные и записанные с момента открытия транзакции, становятся постоянными, то есть транзакция успешно завершена. Сообщения, помещенные в очередь как часть блока сообщений, становятся доступными всем приложениям. Сообщения, прочитанные из очереди как часть блока сообщений, удаляются из очереди.

  Синтаксис:

  MQCMIT (Hconn, CompCode, Reason)

  Комментарии в данном случае излишни.
• MQBACK - функция, которая указывает на то, что всем сообщениям, прочитанным и записанным с момента открытия транзакции, дается задний ход, то есть производится откат транзакции. Все сообщения, помещенные в очередь, удаляются из нее. Все сообщения, прочитанные из очереди, восстанавливаются в очереди (становятся доступными). Как правило, при чтении сообщения удаляются из очереди или помечаются как транзакционные и становятся недоступными (uncommitted messages), если прошла команда MQBEGIN .

  Синтаксис:

  MQBACK (Hconn, CompCode, Reason)

  Работа функций MQBEGIN , MQCMIT и MQBACK будет на примере продемонстрирована в "Основы программирования для WebSphere MQ" .

  Следующие группы функций позволяют считывать и модифицировать атрибуты WebSphere MQ объектов, а также предоставляют дополнительный сервис.
• MQINQ – функция, которая возвращает массив цифр и множество символьных строк, содержащих параметры объекта. В качестве объектов могут выступать очередь, процесс, именованный список (namelist), менеджер очередей.

  Синтаксис:

  MQINQ (Hconn, Hobj, SelectorCount, Selectors,
         IntAttrCount, IntAttrs, 
         CharAttrLength, CharAttrs, 
         CompCode, Reason)

  где:

  Hconn	-	идентификатор связи с менеджером очередей, полученный от MQCONN
  Hobj	-	идентификатор объекта, полученный от MQOPEN
  SelectorCount	-	Счетчик атрибутов, которые должны быть извлечены (от 0 до 256)
  Selectors	-	Массив значений атрибутов, т.е. чисел или символов, которые должны быть извлечены
  IntAttrCount	-	Счетчик цифровых атрибутов
  IntAttrs	-	Массив цифровых атрибутов
  CharAttrLength	-	Длина буфера символьных атрибутов
  CharAttrs	-	Буфер значений символьных атрибутов
  CompCode	-	код завершения
  Reason	-	код ошибки, детализирующий код завершения.

  Комментарии. Буфер CharAttrs будет содержать значения символьных атрибутов в том же порядке, как перечислены атрибуты в Selectors. Многочисленные имена извлекаемых атрибутов приведены в главе "MQINQ – Inquire object attributes" [ 14 ] . Работа функций MQINQ и MQSET будет продемонстрирована позже на примере.