| Россия |
Инспектор
Вы можете этот курс.
Опубликован: 14.12.2004 | Уровень: для всех | Доступ: платный | ВУЗ: Компания IBM
Лекция 9:
Программный интерфейс MQI. Основные функции
-
MQGET - функция для просмотра, извлечения и удаления сообщений из очереди.
Синтаксис:
MQGET (Hconn, Hobj, MsgDesc, GetMsgOpts, BufferLength,Buffer, DataLength, CompCode, Reason)где:
Hconn и Hobj – это идентификаторы, полученные от MQCONN и MQOPEN , соответственно.
Описание сообщения MQMD – это ссылка на структуру объекта из библиотеки WebSphere MQ. Эта структура записывается следующим образом (табл.8.3).
Как видно из табл.8.3 из имени поля MQMD можно извлечь всевозможные атрибуты заголовка сообщений.
GetMsgOpts – опции для функции MQGET - MQGMO (Get-message options), поля структуры которой приведены в таблице 8.4. Наиболее часто используемые опции для управления MQGET :
- MQGMO_WAIT - определяет время ожидания функцией поступления новых сообщений в зависимости от значения в WaitInterval, заданногов мсек. MQGMO_NO_WAIT немедленно возвращает управление, если нет больше сообщений в очереди.
- MQGMO_BROWSE_FIRST - определяет, что читается первое сообщение в очереди.
- MQGMO_BROWSE_NEXT - определяет, что читается сообщение из текущей позиции.
- MQGMO_BROWSE_MSG_UNDER_CURSOR - определяет, что читается сообщение под курсором.
- MQGMO_LOGICAL_ORDER - определяет, что сообщения читаются в логическом порядке. Если опция опущена, то сообщения читаются в физическом порядке.
- MQGMO_FAIL_IF_QUIESCING - выдает ошибку, если менеджер не доступен.
- MQGMO_SYNCPOINT ( MQGMO_NO_SYNCPOINT ) - означает установку (отмену установки) контрольной точки (syncpoint control) на данном сообщении.
- MQGMO_ACCEPT_TRUNCATED_MSG - указывает, что допускается отсечение данных сообщения, например, если DataLength для реального сообщения больше BufferLength.
Все опции MQGMO даны в главе "MQGET – Get message" [ 14 ] .
BufferLength – длина в байтах области буфера Buffer, в который считывается сообщение (переменная типа MQLONG ). Максимальная длина сообщений 100Мбт, длина по умолчанию 4Мбт, реальная длина большинства сообщений не более 10Кбт.
Buffer - буфер, в который считывается сообщение.
DataLength – длина сообщения в байтах (переменная MQLONG ).
Если DataLength для реального сообщения больше BufferLength, то часть сообщения может быть потеряна в зависимости от опции MQGMO_ACCEPT_TRUNCATED_MSG.
CompCode, Reason – это стандартные возвращаемые параметры, упомянутые выше и не требующие детальных пояснений.
