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

Это приложение содержит краткий справочник по командам 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')