Менеджеры очередей: общее представление и настройка

5.2.2. Модуль WebSphere MQ Explorer Healthcheck

Примером такого модуля, обогащающего WebSphere MQ Explorer дополнительными возможностями обнаружения неисправностей и созданного на базе точек расширения приложения, является WebSphere MQ Explorer Healthcheck.

Модуль WebSphere MQ Explorer Healthcheck входит в состав пакета SupportPac MH01. Подробнее о нем читайте на Web-странице по адресу: http://www.ibm.com/support/docview.wss?rs=171&uid=swg24010096

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

WebSphere MQ для платформ UNIX и Windows содержит набор команд для выполнения операций над совокупностью менеджеров очередей сообщений и непосредственно WebSphere MQ. Команды выполняются в интерфейсе командной строки конкретной операционной системы. Если нет указания на иное, путь к этим командам включается в путь поиска команд операционной системы при установке WebSphere MQ.

5.2.4. Команды языка управления WebSphere MQ для iSeries

Команды языка управления (CL – control language) IBM OS/400 в составе WebSphere MQ для iSeries служат для выполнения операций над совокупностью менеджеров очередей и непосредственно WebSphere MQ. Для обращения к главному интерфейсу команд языка управления в составе WebSphere MQ используйте CL-команду WRKMQM.

5.2.5. Команды WebSphere MQ для z/OS

WebSphere MQ для z/OS содержит набор команд, которые могут выполняться над подсистемой менеджера очередей из консоли z/OS или ее аналога, к примеру System Display and Search Facility (SDSF).

О подсистеме менеджера очередей в WebSphere MQ для z/OS речь пойдет в "Менеджеры очередей: общее представление и настройка" "Структура и создание менеджера очередей".

5.2.6. Команды WebSphere MQ Script (MQSC)

Конфигурирование системы при помощи WebSphere MQ Explorer может иметь отрицательные последствия для рабочего окружения. Учет вносимых в менеджер изменений отсутствует, и согласованная запись модификаций, производимых через графический интерфейс, может оказаться непростым делом.

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

Сценарии могут служить для выполнения распространенных команд администрирования системы, а результат работы таких сценариев – передаваться на обработку для выявления успешности завершения и выдачи соответствующей диагностической информации.

С целью предоставления таких возможностей в WebSphere MQ встроен сценарный интерфейс WebSphere MQ Script (MQSC) к менеджеру очередей сообщений. В сочетании с описанными в разделе 5.2.3 управляющими командами WebSphere MQ все действия над менеджером очередей сообщений могут оформляться в виде сценариев на таких внешних по отношению к системе языках записи командных сценариев, как Perl и оболочка Korn UNIX-системы.

Выполнение команд MQSC

Команды MQSC выполняются над менеджером очередей так, как описано ниже.

• WebSphere MQ для Windows, WebSphere MQ для UNIX.

  Интерфейсом для выполнения над менеджером очередей MQSC-команд служит входящая в WebSphere MQ управляющая программа runmqsc. Программа принимает команды на стандартный ввод командного интерфейса^{2Стандартным вводом текстовых диалоговых интерфейсов служит клавиатура. – Примеч. пер.} , из которого и происходит их выполнение. Для запуска интерактивной MQSC-сессии управления менеджером очередей сообщений используйте формат вызова:

  runmqsc название_менеджера

  Если набор команд MQSC сохранен в файл, то содержимое файла можно передать команде runmqsc через стандартный ввод:

  runmqsc название_менеджера < имя_файла

  Команда runmqsc может использоваться для выполнения MQSC-команд управления удаленным менеджером очередей сообщений. Об этом читайте в главе 6 "Administering remote WebSphere MQ objects" руководства WebSphere MQ System Administration Guide, SC34-6584.
• WebSphere MQ для iSeries.

  Команды MQSC могут выполняться в интерактивном режиме, для чего служит CL-команда RUNMSQC.

  Также они могут быть записаны как сценарий, который представляет собой физический файл-источник. Для его выполнения предназначена CL-команда STRMQMMQSC.

  Примечание Дополнительно WebSphere MQ для iSeries содержит CL-команды, которые могут служить для выполнения MQSC-команд через панельный диалоговый интерфейс. Для доступа к этим CL-командам WebSphere MQ воспользуйтесь CL-командой WRKMQM.
• WebSphere MQ для z/OS.

  Здесь команды MQSC служат для управления подсистемой конкретного менеджера очередей сообщений.

  Примечание WebSphere MQ для z/OS содержит панели управления и операции, которые могут использоваться для интерактивного выполнения функций MQSC-команд. Для доступа к ним служат Time Sharing Option (TSO) и Interactive System Productivity Facility (ISPF).

Синтаксис MQSC

Синтаксис MQSC очень прост. Общий формат команды имеет вид:

COMMAND OBJTYPE('Название_Объекта) ATTR1(ЗНАЧЕНИЕ) ATTR2('значение') ATTR3

где OBJTYPE – тип объекта, COMMAND – один из ряда допустимых для данного типа объектов командных ключевых слов, ATTR1, ATTR2, ATTR3 – названия допустимых для него атрибутов.

Отдельные комбинации командных ключевых слов и типов объектов, такие как ALTER QMGR, не требуют указания имен объектов. Отдельные атрибуты не требуют приведения их значений. Немало команд и типов имеют сокращенные варианты; к примеру, ALT может заменить ALTER.

Для некоторых командных ключевых слов требуется задание как типа, так и подтипа, например:

DEFINE CHANNEL('my.channel') CHLTYPE(RCVR)

Каждая комбинация ключевого слова и типа принимает свой набор атрибутов. Ряд атрибутов является обязательным. Для указания пустого значения атрибута используйте пробел в круглых скобках: ATTR( ). Ряд атрибутов допускает множественность значений. В этом случае они разделяются запятыми. Например, так:

ALTER NAMELIST('my.namelist') NAMES(NAME1,'name2')

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

В число наиболее употребительных командных ключевых слов входят следующие:

• DEFINE или DEF

  Создать новый объект с конкретным типом, названием и значениями перечисленных атрибутов. Для принудительной замены существующего объекта с таким же типом и именем DEFINE может сопровождаться атрибутом REPLACE. Для указания названия другого объекта с таким же типом, значениями атрибутов которого нужно заполнить все атрибуты объекта, не указанные в команде, служит атрибут LIKE.
• ALTER или ALT

  Модифицировать имеющийся объект с конкретным типом и конкретным названием, придав его атрибутам указанные значения.
• DELETE

  Удалить имеющийся объект с конкретным типом и конкретным названием.
• DISPLAY или DIS

  Отобразить названные атрибуты имеющихся объектов с конкретным типом и конкретным названием. Для вывода на экран всех атрибутов каждого из объектов можно воспользоваться специальным именем ALL. Если не задан ни один атрибут, для каждого из объектов выводится набор атрибутов по умолчанию.

  В конце названий и значений типов объектов можно указать "звездочку" (*). Это вынуждает команду отобразить атрибуты всех тех объектов, названия или типы которых начинаются со значения, указанного до символа маски. Например, следующая команда отображает все атрибуты очередей, названия которых начинаются на example:

  DISPLAY QUEUE('example*') ALL

  В WebSphere MQ V6.0 возможна дополнительная фильтрация информации, выдаваемой командой DISPLAY, для чего пользуются ключевым словом WHERE. В круглых скобках после него следуют три значения: название атрибута, оператор и значение фильтра. Для каждого из объектов заданный атрибут сверяется со значением фильтра при помощи оператора, и атрибуты упомянутого объекта выводятся лишь тогда, когда такое сравнение было успешно завершено. Например, следующей командой будут показаны глубина ( CURDEPTH ) и описание ( DESCR ) очередей, содержащих более 10 сообщений:

  DISPLAY QUEUE(*) DESCR CURDEPTH WHERE(CURDEPTH,GT,10)
• START

  Произвести запуск существующего объекта с конкретным типом и конкретным названием, к примеру, слушателя или канала.
• STOP

  Остановить имеющийся объект с конкретным типом и конкретным названием, например слушатель или канал сообщений.

Команда MQSC может занимать несколько строк, для переноса между которыми после пробела в конце строки пишут знак "плюс" (+). Например, так:

DEFINE CHANNEL(TO.PAYROLL) +
       CHLTYPE(SDR) +
       CONNAME('another.machine.com(1414)') +
       XMITQ(PAYROLL)

Также в сценарий MQSC могут включаться строки, содержащие комментарий. Первым знаком такой строки служит знак "звездочка" (*).

Полное описание синтаксиса команд MQSC и деталей работы каждой такой команды вкупе с описанием атрибутов, пригодных для использования в командах, см. в руководстве WebSphere MQ Script (MQSC) Command Reference, SC34-6597, доступном на Web-странице по адресу: http://www.ibm.com/software/integration/wmq/library/

5.2.7. Форматы программируемых команд (PCF)

Форматы программируемых команд ( PCF ) служат интерфейсом программирования для менеджеров очередей сообщений. Для каждой команды MQSC имеется соответствующая команда в формате программируемых команд, которая может использоваться для управления данным менеджером. Соответствующие параметры PCF имеются для каждого MQSC -атрибута.

Команды в формате программируемых команд обслуживает командный сервер (command server) менеджера очередей сообщений. Он выполняет заданное каждой из PCF -команд действие и формирует сообщение-ответ с результатом ее работы.

Реализация интерфейса к командному серверу отвечает стандартной модели по принципу "запрос – ответ", что означает, что сервер обрабатывает запросы из очереди и отсылает ответы, помещая их в очереди ответа, указанные приложениями-инициаторами запросов. Очередь, из которой командный сервер извлекает запросы на обработку, называется SYSTEM.ADMIN.COMMAND.QUEUE.

Подробности формирования и отправки отдельных сообщений с командами PCF и обработки ответов на подобные сообщения выходят за рамки книги. Читайте об этом в руководстве WebSphere MQ Programmable Command Formats and Administration Interface, SC34-6598 на Web-странице по адресу: http://www.ibm.com/software/integration/wmq/library/

Упростить применение PCF -интерфейса к менеджерам очередей из приложений на языке Java может пакет SupportPac MS0B. Подробнее читайте о нем по адресу: http://www.ibm.com/support/docview.wss?rs=171&uid=swg24000668&loc=en_US&cs=utf-8&lang=en

Созданный в WebSphere MQ V6.0 на платформе Windows, UNIX или iSeries менеджер очередей сообщений при своем старте автоматически запускает командный сервер. Такое поведение менеджера может быть заблокировано сменой значения атрибута SCMDSERV на MANUAL в объекте менеджера очередей в MQSC или установкой равным Manual свойства Command server control в окне Properties менеджера очередей в WebSphere MQ Explorer.

Менеджеры очередей сообщений, созданные на этих платформах до появления WebSphere MQ V6.0, включая обновленные до нее, не запускают командный сервер автоматически. Для них запуск командного сервера осуществляется так.

• WebSphere MQ для Windows, WebSphere MQ для UNIX:

  strmqcsv название_менеджера
• WebSphere MQ для iSeries:

  STRMQMCSVR MQMNAME('название_менеджера')
• В WebSphere MQ для z/OS обработка PCF-команд сервером возможна только в версии WebSphere MQ для z/OS V6.0.

  Для запуска командного сервера в WebSphere MQ для z/OS используется команда:

  START CMDSERV MQSC