Опубликован: 10.06.2008 | Уровень: специалист | Доступ: платный | ВУЗ: Компания IBM
Дополнительный материал 2:

Краткий справочник

< Дополнительный материал 1 || Дополнительный материал 2: 1234

Это приложение содержит краткий справочник по командам WebSphere MQ, типам объектов и структурам данных, описанным в этом курсе.

В приложении обсуждаются следующие темы:

  • Управляющие команды WebSphere MQ
  • Команды CL в WebSphere MQ для iSeries
  • Поля дескриптора сообщения WebSphere MQ (MQMD)
  • Интерфейс очередей сообщений (message queue interface, MQI)
  • Командный интерфейс WebSphere MQ Script (MQSC)
  • Объект менеджера очередей
  • Объекты слушателей
  • Объекты служб
  • Объекты списки имен
  • Объекты очередей
  • Записи кластерных очередей
  • Записи кластерных менеджеров очередей
  • Каналы и объекты каналов
  • Записи состояния каналов

Управляющие команды WebSphere MQ

Следующие управляющие команды WebSphere MQ применяются для администрирования менеджеров очередей в Microsoft Windows и UNIX.

  • dspmq – выводит список менеджеров очередей, существующих на машине, с указанием их состояния.
  • crtmqm – создает менеджер очередей.
  • amqmdain – запускает или останавливает менеджер очередей в Windows, конфигурирует WebSphere MQ в Windows.
  • strmqm – запускает менеджер очередей в UNIX.
  • endmqm – останавливает менеджер очередей.
  • runmqsc – интерактивная консоль для ввода команд MQSC.
  • runmqsc <input.txt – исполнение команд MQSC в составе сценария.
  • strmqcsv – запускает командный сервер для менеджера очередей.
  • setmqaut – настройка полномочий OAM для объектов менеджеров очередей.
  • dspmqaut – вывод полномочий OAM для объектов менеджеров очередей.
  • dmpmqaut – вывод подробной информации о полномочиях OAM, назначенных в менеджере очередей.
  • runmqlsr – команда WebSphere MQ V5.3 для запуска слушателя, в WebSphere MQ V6.0 используйте объекты слушателей.
  • mqrc – выводит описания и значения кодов причины WebSphere MQ и номера сообщений AMQXXXX.
  • dspmqver – выводит сведения о версии WebSphere MQ в виде "Version.Release.Modification.Fixpack"; эти параметры изменяются после установки каждого пакета обновлений.

Команды CL в WebSphere MQ для iSeries

Следующие команды WebSphere MQ CL используются для администрирования менеджеров очередей на платформе iSeries.

  • WRKMQM – доступ ко всем панелям команд WebSphere MQ CL.
    • CRTMQM – создание менеджера очередей.
    • STRMQM – запуск менеджера очередей.
    • ENDMQM – остановка менеджера очередей.
    • RUNMQSC – интерактивная консоль для ввода команд MQSC.
    • STRMQMMQSC – исполнение команд MQSC в составе сценария.
  • STRMQMCSVR – запуск командного сервера для менеджера очередей.
  • STRMQMLSR – команда WebSphere MQ V5.3 для запуска слушателя, в WebSphere MQ V6.0 используйте объекты слушателей.
  • CALL QMQM/DSPMQVER – выводит сведения о версии WebSphere MQ в виде "Version.Release.Modification.Fixpack"; эти параметры изменяются после установки каждого пакета обновлений.

Поля дескриптора сообщения WebSphere MQ (MQMD)

Дескриптор сообщения WebSphere MQ (MQMD) имеется у каждого сообщения, передаваемого по инфраструктуре WebSphere MQ, и содержит следующие поля.

  • Message Type ( MsgType ) – тип сообщения (дейтаграмма, запрос, ответ или отчет).
  • Report ( Report ) – обстоятельства генерации отчета о доставке и обработке этого сообщения.
  • Feedback ( Feedback ) – причина генерации сообщения-отчета.
  • Reply-to queue ( ReplyToQ ) – имя очереди–получателя сообщений ответа на это сообщение.
  • Reply-to queue manager ( ReplyToQMgr ) – менеджер очередей, в котором находится очередь-получатель ответов. Это поле обычно автоматически заполняется WebSphere MQ.
  • Message identifier ( MsgID ) – уникальный идентификатор сообщения, автоматически создается WebSphere MQ.
  • Correlation identifier ( CorrelID ) – идентификатор, связывающий сообщения ответа и отчета с исходными запросами и дейтаграммами.
  • Persistence ( Persistence ) – указывает, является ли сообщение постоянным (сообщения, критические для бизнеса) или непостоянным (для сообщений-запросов).
  • Coded Character Set Identifier ( CodedCharSetId ) – определяет способ хранения символьных данных в двоичной форме в сообщении.
  • Encoding ( Encoding ) – определяет способ хранения числовых данных в двоичной форме внутри сообщения. Сообщения часто содержат лишь символьные данные.
  • Put time ( PutTime ) – время поступления сообщения в очередь, в которой оно находится в настоящее время.
  • Put date ( PutDate ) – дата поступления сообщения в очередь, в которой оно находится в настоящее время.
  • Expiry ( Expiry ) – время хранения, по истечении которого инфраструктура WebSphere MQ может отбросить сообщение.

Команды Message Queue Interface (MQI)

Следующие команды составляют интерфейс очередей сообщений (message queue interface, MQI) – ключевой API WebSphere MQ.

    • MQCONN – подключение к менеджеру очередей.
    • MQCONNX – подключение к менеджеру очередей (с дополнительными параметрами).
  • MQDISC – отключение от менеджера очередей, к которому выполнено подключение командой MQCONN или MQCONNX.
  • MQOPEN – открывает очередь с указанием действий, которые необходимо выполнить над этой очередью. Также может открывать другие типы объектов WebSphere MQ для запроса и установки атрибутов.
  • MQCLOSE – закрывает очередь или другой объект WebSphere MQ, ранее открытый командой MQOPEN.
  • MQPUT – помещает сообщение в очередь, открытую командой MQOPEN.
  • MQPUT1 – команда-оболочка, объединяющая команды MQOPEN, MQPUT, и MQCLOSE.
  • MQGET – извлечение или просмотр сообщений в очереди, ранее открытой для чтения или просмотра командой MQOPEN.
    • MQCMIT – фиксирует текущую единицу работы.
    • MQBACK – выполняет отмену (откат) текущей единицы работы.
    • MQBEGIN – начинает обработку глобальной единицы работы при координации WebSphere MQ и с участием внешних компонентов, таких как базы данных.
  • MQINQ – запрос атрибутов объекта WebSphere MQ, ранее открытого командой MQOPEN.
  • MQSET – установка атрибутов объекта WebSphere MQ, ранее открытого командой MQOPEN.

Командный интерфейс WebSphere MQ Script (MQSC)

WebSphere MQ Script (MQSC) – это административный интерфейс для создания и администрирования объектов WebSphere MQ в составе отдельного менеджера очередей. Команды MQSC исполняются интерактивно либо в составе сценария.

Общий формат команд MQSC имеет следующий вид:

COMMAND OBJTYPE('имя.объекта') ATTR1(ЗНАЧЕНИЕ) ATTR2('значение') ATTR3

Имена и значения, заданные в нижнем регистре, а также содержащие символы, отличные от алфавитно-цифровых, необходимо заключать в одинарные кавычки.

В командах, отображающих атрибуты существующих объектов WebSphere MQ, можно использовать обобщенные имена (generic name). Обобщенное имя заканчивается звездочкой (*) и соответствует всем объектам, имена которых начинаются со строки, стоящей перед звездочкой.

Ниже перечислены наиболее востребованные команды MQSC и атрибуты объектов WebSphere MQ с указанием их сокращенных версий.

Примеры команд MQSC

Следующий пример команд MQSC демонстрирует синтаксис команд MQSC и некоторые функции интерфейса MQSC.

  • Создание локальной очереди с именем в нижнем регистре:
    DEFINE QLOCAL('payroll.queue') DESCR('Payroll Queue')
  • Замена существующей локальной очереди с ключевым словом REPLACE:
    DEFINE QLOCAL('payroll.queue') DESCR('Payroll Queue NEW') REPLACE
  • Создание объекта списка имен с именами в верхнем регистре и несколькими значениями атрибута NAMES, включая значения в нижнем регистре:
    DEFINE NAMELIST(CLUSTER.NAMELIST) NAMES(CLUSTER1.UCASE,'cluster2.lcase')
  • Вывод атрибутов локальных очередей, имена которых начинаются с "payroll.":
    DISPLAY QLOCAL('payroll.*') ALL
  • Вывод атрибутов "current depth" ( CURDEPTH ) и "description" ( DESCR ) локальных очередей:
    DISPLAY QLOCAL(*) CURDEPTH DESCR
  • Вывод атрибутов "current depth" ( CURDEPTH ) и "description" ( DESCR ) очередей, имена которых начинаются с "payroll.", содержащих более 10 сообщений (новинка WebSphere MQ V6.0):
    DISPLAY QLOCAL('payroll.*') CURDEPTH DESCR WHERE(CURDEPTH GT 10)
  • Команда MQSC, определяющая sender-канал (для ясности разбита на строки и снабжена комментарием).
  • Определение канала для менеджера очередей QM_REMOTE:
    DEFINE CHANNEL(TO.QM_REMOTE) +
    CHLTYPE(SDR) +
    CONNAME('remotehost.domain.com(1414)') +
    XMITQ(QM_REMOTE) +
    DESCR('Channel to qmgr QM_REMOTE')
< Дополнительный материал 1 || Дополнительный материал 2: 1234
Михаил Завалко
Михаил Завалко
Беларусь, Минск
Artem Bardakov
Artem Bardakov
Россия