Фундаментальные основы WebSphere MQ V6

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

Показывать лекцию целиком

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

    У каждого менеджера очередей имеется единственный представляющий его объект. Изменяя атрибуты этого объекта, можно настраивать менеджер очередей. Многие атрибуты можно настраивать, не останавливая менеджер очередей.

    Команда MQSC, управляющая объектом менеджера очередей

  • ALTER QMGR или ALT QMGR – изменяет атрибуты объекта менеджера очередей.
  • Атрибуты объекта менеджера очередей

    Атрибуты менеджера очередей включают следующее

  • Dead letter queue ( DEADQ ) – имя локальной очереди, созданной в этом менеджере очередей для сбора сообщений, которые не удается доставить адресату.
  • Queue manager identifier ( QMID ) – неизменяемый атрибут, уникальный идентификатор экземпляра менеджера очередей, отличающий его от других экземпляров менеджеров с идентичным именем в кластере.
  • Channel auto-definition ( CHAD ) – указывает, включено ли автоматическое определение каналов для этого менеджера очередей.
  • Trigger interval ( TRIGINT ) – интервал генерации дополнительных триггерных событий для очередей с типом триггера FIRST.
  • Maximum message length ( MAXMSGL ) – максимальная длина сообщения в любой из очередей данного менеджера.
  • Start command server ( SCMDSERV ) – указывает, следует ли автоматически запускать командный сервер для менеджера очередей.
  • Start channel initiator ( SCHINIT ) – указывает, следует ли автоматически запускать инициатор каналов вместе с менеджером очередей в Windows, UNIX и iSeries.
  • SSL key repository ( SSLKEYR ) – путь к хранилищу SSL-ключей менеджера очередей.
  • Repository ( REPOS ) – имя кластера, полный репозиторий которого обслуживается этим менеджером очередей.
  • Repository namelist ( REPOSNL ) – имя объекта списка имен, содежащего имена кластеров, полные репозитории которых обслуживаются этим менеджером очередей.
  • Cluster workload use queue ( CLWLUSEQ ) – указывает, активна ли по умолчанию балансировка нагрузки между удаленными экземплярами очереди, если существует локальная очередь с тем же именем.
  • Cluster workload recently used channel ( CWMRUC ) – максимальное число экземпляров очереди в кластере, участвующих в балансировке нагрузки.
  • Объекты слушателей

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

    Команды MQSC для управления объектом слушателя

    Команды MQSC для объекта слушателя таковы.

  • DEFINE LISTENER(NAME) TRPTYPE(TCP) или DEF LSTR(NAME) TRPTYPE(TCP) – создает объект слушателя.
  • ALTER LISTENER(NAME) TRPTYPE(TCP) или ALT LSTR(NAME) TRPTYPE(TCP) – изменяет существующий объект слушателя.
  • DELETE LISTENER(NAME) и DELETE LSTR(NAME) – удаляет существующий объект слушателя.
  • DISPLAY LISTENER(GENERIC_NAME) и DIS LSTR(GENERIC_NAME) – выводит атрибуты существующего объекта слушателя.
  • DISPLAY LSSTATUS(GENERIC_NAME) и DIS LSSTATUS(GENERIC_NAME) – выводит состояние активных слушателей.
  • START LISTENER(NAME) и STA LSTR(NAME) – запускает слушатель, связанный с объектом слушателя.
  • STOP LISTENER(NAME) и STOP LSTR(NAME) – останавливает слушателя, связанного с объектом слушателя.
  • Атрибуты объекта слушателя

    Объект слушателя поддерживает следующие атрибуты.

  • Port ( PORT ) – порт TCP/IP, который прослушивается в ожидании подключений.
  • Control ( CONTROL ) – указывает, должен ли слушатель запускаться вручную (MANUAL) или автоматически при запуске менеджера очередей (QMGR).
  • Объекты служб

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

    Брокер публикации-подписки WebSphere MQ – одно из приложений, для запуска которого используется объект службы SYSTEM.BROKER, который создается для менеджера очередей WebSphere MQ V6.0.

    Команды MQSC для управления объектом службы

    Команды MQSC для объекта службы таковы.

  • DEFINE SERVICE(NAME) или DEF SERVICE(NAME) – создает объект службы.
  • ALTER SERVICE(NAME) или ALT SERVICE(NAME) – изменяет существующий объект службы.
  • DELETE SERVICE(NAME) – удаляет существующий объект службы.
  • DISPLAY SERVICE(GENERIC_NAME) или DIS SERVICE(GENERIC_NAME) – выводит атрибуты существующего объекта службы.
  • DISPLAY SVSTATUS(GENERIC_NAME) или DIS SVSTATUS(GENERIC_NAME) – выводит состояние работающих служб.
  • START SERVICE(NAME) или STA SERVICE(NAME) – запускает приложение, связанное с объектом службы.
  • STOP SERVICE(NAME) – останавливает приложение, связанное с объектом службы.
  • Атрибуты объекта службы

    Объект службы поддерживает следующие атрибуты.

  • Service type ( SERVTYPE ) – указывает, разрешен ли запуск только одного ( SERVER ) или нескольких экземпляров службы ( COMMAND ).
  • Control ( CONTROL ) – указывает, разрешено ли запускать службу вручную ( MANUAL ), запускать и останавливать ее вместе с менеджером очередей ( QMGR ) либо только запускать вместе с менеджером очередей ( STARTONLY ).
  • Start command ( STARTCMD ) – путь к исполняемому файлу, запускающему службу.
  • Start arguments ( STARTARG ) – аргументы команды запуска службы.
  • Stop command ( STOPCMD ) – путь к исполняемому файлу, останавливающему службу.
  • Stop arguments ( STOPARG ) – аргументы команды остановки службы.
  • Standard out ( STDOUT ) – файл, в который направляется стандартный вывод работающей службы.
  • Standard error ( STDERR ) – файл, в который направляется стандартный поток ошибок работающей службы.
  • Объекты списки имен

    Объекты списки имен (namelist) содержат наборы имен. Они чаще всего применяются для хранения списков кластеров, которые можно занести в атрибут "cluster namelist" ( CLUSNL ) или "repository namelist" ( REPOSNL ) других объектов.

    Команды MQSC для управления объектом список имен

    Команды MQSC для объекта список имен таковы.

  • DEFINE NAMELIST(NAME) или DEF NL(NAME) – создает объект список имен.
  • ALTER NAMELIST(NAME) или ALT NL(NAME) – изменяет существующий объект список имен.
  • DELETE NAMELIST(NAME) или DELETE NL(NAME) – удаляет существующий объект список имен.
  • DISPLAY NAMELIST(GENERIC_NAME) или DIS NL(GENERIC_NAME) – выводит атрибуты существующего объекта списка имен.
  • Атрибуты объекта список имен

    Объект список имен поддерживает следующие атрибуты.

  • Names ( NAMES ) – список имен, разделенных запятыми.
  • Объекты очередей

    Объекты очередей представляют очереди в составе менеджера очередей и управляют маршрутизацией сообщений в очереди, обслуживаемые другими менеджерами очередей в инфраструктуре WebSphere MQ.

    Типы объектов очередей

    Существуют следующие типы объектов очередей.

  • Local queue ( QLOCAL или QL ) – локальная очередь, единственный объект, представляющий очередь в составе менеджера очередей, способную хранить сообщения. Может быть назначена транспортной очередью (transmission queue) для временного хранения сообщений, предназначенных для передачи другим менеджерам очередей в инфраструктуре WebSphere MQ. Сообщения, предназначенные для отправки удаленному менеджеру очередей, попадают в одноименные транспортные очереди.
  • Alias queue ( QALIAS or QA ) – объект псевдонима очереди, ссылающийся на объект очереди с другим именем (объект локальной, удаленной или кластерной очереди).
  • Model queue ( QMODEL or QM ) – объект модельной очереди, позволяющий приложениям динамически создавать локальные очереди и идентифицировать себя в инфраструктуре WebSphere MQ. Атрибуты объекта модельной очереди определяют атрибуты очередей, динамически создаваемых на его основе.
  • Remote queue ( QREMOTE or QR ) – объект удаленной очереди, позволяющий явно задавать и управлять маршрутами между менеджерами очередей; применяются в следующих целях (в зависимости от атрибутов):
  • псевдоним менеджера очередей – задает маршрут к удаленному менеджеру очередей, имя которого не совпадает с именем транспортной очереди, также предоставляет возможность обращаться к локальным менеджерам очередей под другими именами;
  • локальное определение удаленной очереди – явно определяет маршрут через транспортную очередь к очереди с заданным именем в удаленном менеджере очередей;
  • псевдоним очереди ответов – заставляет менеджер очередей во время отправки сообщения заменять значения полей reply-to в его дескрипторе данными из описания этого псевдонима.
  • Команды MQSC для управления объектами очередей

    Следующие команды поддерживаются всеми объектами очередей. Вместо QLOCAL и QL следует подставить нужный тип объекта очереди (см. выше).

  • DEFINE QLOCAL(NAME) или DEF QL(NAME) – создает объект очереди.
  • ALTER QLOCAL(NAME) или ALT QL(NAME) – изменяет существующий объект очереди.
  • DELETE QLOCAL(NAME) или DELETE QL(NAME) – удаляет существующий объект очереди.
  • DISPLAY QLOCAL(GENERIC_NAME) или DIS QL(GENERIC_NAME) – выводит атрибуты существующих объектов очередей.
  • Следующая команда применяется для вывода атрибутов любых определенных локально объектов очередей:

    DISPLAY QUEUE(GENERIC_NAME) или DIS Q(GENERIC_NAME)

    Следующая команда MQSC выводит состояние очереди (только для локальных очередей):

    DISPLAY QSTATUS(GENERIC_NAME) или DIS QS(GENERIC_NAME)

    Общие атрибуты объектов очередей

    Следующие атрибуты поддерживают все типы объектов очередей.

  • Put ( PUT ) – определяет, можно ли добавлять сообщения в локальную очередь либо отправлять через нее сообщения. Установка этого атрибута в значение DISABLED для очереди в составе кластера отключает маршрутизацию сообщений к этой очереди.
  • Default persistence ( DEFPSIST ) – указывает, что сообщения, отравленные командой MQPUT через эту очередь (открытую командой MQOPEN ), по умолчанию являются постоянными.
  • Атрибуты очередей, управляющие балансировкой нагрузки в кластере

    Следующие атрибуты поддерживаются всеми типами объектов очередей, кроме модельных очередей (созданные на их основе динамические очереди нельзя публиковать в кластерах).

    Примечание Публикация объекта очереди в кластере позволяет менеджерам очередей вовлекать его в балансировку нагрузки по обработке сообщений, адресованных очереди с соответствующим именем.
  • Cluster ( CLUSTER ) – имя кластера, в котором опубликован этот объект очереди.
  • Cluster namelist ( CLUSNL ) – имя объекта списка имен, содержащего имена кластеров, в которых опубликован этот объект очереди.
  • Default bind type ( DEFBIND ) – тип привязки по умолчанию, используемый при открытии этой очереди. Если задано значение bind on open ( OPEN ), то данная очередь будет принимать сообщения, адресованные ей с использованием одно и того же описателя объекта (полученного от одного вызова MQOPEN), которые будут доставляться одному и тому же менеджеру очередей кластера. Если же указано значение bind not fixed ( NOTFIXED ), балансировка нагрузки будет осуществляться независимо для каждого сообщения.
  • Cluster workload rank ( CLWLRANK ) – чем выше значение этого атрибута у экземпляра очереди в составе кластера, тем больше шансов на ее использование при балансировке нагрузки, даже если обслуживающий ее менеджер очередей недоступен.
  • Cluster workload priority ( CLWLPRTY ) – чем выше значение этого атрибута у экземпляра очереди в составе кластера, тем больше шансов на ее использование при балансировке нагрузки, если обслуживающий ее менеджер очередей доступен.
  • Cluster workload use queue ( CLWLUSEQ ) – указывает, следует ли вовлекать в балансировку нагрузки удаленные экземпляры кластерных очередей, если существует одноименная локальная очередь в данном менеджере очередей (только для локальных очередей, созданных вручную).
  • Атрибуты локальных очередей (включая динамические)

    Следующие атрибуты поддерживаются локальными очередями ( QLOCAL ), в том числе модельными очередями ( QMODEL ), у которых они управляют параметрами динамически создаваемых очередей.

  • Definition type ( DEFTYPE ) – указывает, создана ли очередь вручную ( PREDEFINED ) или динамически, на основе объекта модельной очереди. Динамические очереди бывают постоянными ( PERMDYN ) и временными ( TEMPDYN ), последние не могут содержать постоянные сообщения, поскольку автоматически удаляются после отключения приложения или завершения менеджера очередей.
  • Get ( GET ) – указывает, можно ли открыть объект этой локальной очереди для извлечения или просмотра сообщений, также применим к объектам псевдонимов локальных очередей.
  • Usage ( USAGE ) – если указано значение "transmission" ( XMITQ ), эта локальная очередь будет использоваться в качестве транспортной очереди для маршрутизации сообщений удаленным менеджерам очередей (для этого также требуется канал, обрабатывающий сообщения в транспортной очереди).
  • Для запуска приложений по прибытии сообщений в очередь используются триггеры. В Windows и UNIX для транспортной очереди можно настроить триггер, автоматически запускающий канал при поступлении сообщений, предназначенных для пересылки. Этот процесс называется инициацией канала (channel initiation). Следующие атрибуты настраивают триггеры для очереди.

  • Trigger control ( TRIGGER ) – указывает, включен ли триггеринг для этой очереди (это необходимо для инициации каналов).
  • Trigger type ( TRIGTYPE ) – тип активного триггеринга очереди (для инициации каналов требуется триггер типа FIRST ).
  • Trigger depth ( TRIGDPTH ) – пороговое число сообщений, по достижении которого триггер типа DEPTH генерирует событие.
  • Trigger data ( TRIGDATA ) – пользовательские данные, которые добавляются к триггерному сообщению (в случае инициации канала они включают имя запускаемого канала).
  • Initiation queue ( INITQ ) – очередь, в которой генерируются сообщения при срабатывании триггера (в случае инициации каналов это SYSTEM.CHANNEL.INITQ ).
  • Атрибуты объектов псевдонима очереди

    Объекты псевдонима очереди ( QALIAS ) поддерживают следующие атрибуты.

  • Target queue ( TARGQ ) – целевая или базовая очередь. Имя очереди, на которую ссылается псевдоним.
  • Атрибуты локальных определений удаленных очередей

    При создании локальных определений удаленных очередей используются следующие атрибуты объектов удаленных очередей ( QREMOTE ).

  • Remote name ( RNAME ) – имя удаленной очереди.
  • Remote queue manager name ( RQMNAME ) – имя удаленного менеджера очередей, обслуживающего эту очередь.
  • Transmission queue ( XMITQ ) – имя транспортной очереди, через которую сообщения передаются этому удаленному менеджеру очередей (можно не указывать, если оно совпадает с именем удаленного менеджера очередей).
  • Атрибуты псевдонимов менеджеров очередей

    При создании псевдонимов менеджеров очередей используются следующие определения объектов удаленных очередей ( QREMOTE ).

  • Remote name ( RNAME ) – не указывают.
  • Remote queue manager name ( RQMNAME ) – имя менеджера очередей, на который ссылается псевдоним.
  • Transmission queue ( XMITQ ) – имя транспортной очереди, через которую сообщения передаются этому удаленному менеджеру очередей (можно не указывать, если оно совпадает с именем удаленного менеджера очередей, либо псевдоним ссылается на локальную очередь).
  • Атрибуты псевдонима очереди ответов

    При создании псевдонима очереди ответов используются следующие определения объектов удаленных очередей ( QREMOTE ).

  • Remote name ( RNAME ) – имя очереди, которое заносится в поле reply-to queue.
  • Remote queue manager name ( RQMNAME ) – имя менеджера очередей, которое заносится в поле reply-to queue manager.
  • Transmission queue ( XMITQ ) – не указывают.
  • Записи кластерных очередей

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

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

    Команды MQSC для управления записями кластерных очередей

    Для управления кластерными очередями применяют следующие команды MQSC.

  • DISPLAY QCLUSTER( GENERIC_NAME ) или DIS QC( GENERIC_NAME ) – выводит атрибуты записей кластерных очередей известных менеджеру очередей.
  • Атрибуты записей кластерных очередей

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

  • Cluster ( CLUSTER ) – кластер, в котором опубликован объект очереди.
  • Cluster queue manager ( CLUSQMGR ) – имя менеджера очередей в составе кластера, где опубликован этот объект очереди.
  • Queue manager identifier ( QMID ) – уникальный идентификатор менеджера очередей в составе кластера, где опубликован этот объект очереди.
  • Cluster queue type ( CLUSQT ) – тип объекта кластерной очереди.
  • Записи кластерных менеджеров очередей

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

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

    Команды MQSC для управления записями кластерных менеджеров очередей

    Для управления записями кластерных менеджеров очередей служат следующие команды MQSC.

  • DISPLAY CLUSQMGR( GENERIC_NAME ) или DIS CLUSQMGR( GENERIC_NAME ) – выводит атрибуты записей кластерных менеджеров очередей, известных этому менеджеру очередей.
  • Атрибуты записей кластерных менеджеров очередей

    Записи кластерных менеджеров очередей поддерживают следующие атрибуты.

  • Cluster ( CLUSTER ) – кластер, в который входит этот менеджер очередей.
  • Cluster queue manager ( CLUSQMGR ) – имя менеджера очередей.
  • Queue manager identifier ( QMID ) – уникальный идентификатор менеджера очередей.
  • Queue manager type ( QMTYPE ) – указывает, обслуживает ли этот менеджер очередей полный или частичный репозиторий кластера.
  • Channel ( CHANNEL ) – имя канала, применяемого для взаимодействия с этим менеджером очередей.
  • Definition type ( DEFTYPE ) – тип канала, применяемого для взаимодействия с этим менеджером очередей.
  • Connection name ( CONNAME ) – хост-имя или IP-адрес и порт для взаимодействия с этим менеджером очередей.
  • Status ( STATUS ) – текущее состояние канала, применяемого для взаимодействия с этим менеджером очередей.
  • Каналы и объекты каналов

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

    MCA всегда работают парами, имена MCA (и, следовательно, имена объектов каналов) из пары должны совпадать. Соединение, установленное между двумя MCA, называется каналом.

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

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

    Типы объектов каналов

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

  • Распределенные каналы для передачи сообщений.
  • Sender ( SDR ) – отправляет все сообщения, поступающие в заданную транспортную очередь. Партнером такого канала может быть receiver-канал или requester-канал. Всегда устанавливает подключение, также способен принимать запросы подключения у requester-канала.
  • Receiver ( RCVR ) – получает сообщения и направляет их очередям. Его партнером должен быть sender-канал, никогда не устанавливает подключение сам.
  • Server ( SVR ) – отправляет все сообщения, поступающие в заданную транспортную очередь. Его партнером должен быть requester-канал. Способен принимать и устанавливать подключения (если имя подключения записано в определении канала).
  • Requester ( RQSTR ) – получает сообщения и направляет их очередям. Партнером такого канала может быть sender-канал или server-канал. Способен принимать, устанавливать и запрашивать подключения.
  • Кластерные каналы для передачи сообщений.
  • Cluster sender ( CLUSSDR ) – отправляет сообщения из транспортной очереди кластера другим менеджерам очередей кластера. Если он явно определен, выполняет первое подключение к менеджеру очередей с полным репозиторием кластера, чтобы войти в его состав. WebSphere MQ автоматически создает объекты кластерного sender-канала для всех менеджеров очередей в кластере. Атрибуты этого объекта основаны на объекте кластерного receiver-канала, опубликованного в кластере менеджерами очередей.
  • Cluster receiver ( CLUSRCVR ) – определяет способ подключения любого из менеджеров очередей заданного кластера к данному менеджеру очередей. Партнером этого канала может быть объект кластерного sender-канала, созданного вручную либо автоматически.
  • Каналы MQI.
  • Server connection ( SVRCONN ) – определяет способы подключения клиентских приложений к менеджеру очередей.
  • Client connection ( CLNTCONN ) – отличается от остальных каналов тем, что никогда не используется менеджером очередей напрямую. Вместо этого для такого канала добавляется запись в таблицу определений клиентских каналов (CCDT), которая затем распространяется по другим машинами и используется клиентскими приложениями для настройки их MCA.
  • Команды MQSC для управления объектами каналов

    Для управления объектами каналов служат следующие команды MQSC.

  • DEFINE CHANNEL(NAME) CHLTYPE(TYPE) или DEF CHL(NAME) CHLTYPE(TYPE) – создает объект канала.
  • ALTER CHANNEL(NAME) CHLTYPE(TYPE) или ALT CHL(NAME) CHLTYPE(TYPE) – изменяет существующий объект канала.
  • DELETE CHANNEL(NAME) или DELETE CHL(NAME) – удаляет существующий объект канала.
  • DISPLAY CHANNEL(GENERIC_NAME) or DIS CHL(GENERIC_NAME) – выводит атрибуты существующих объектов каналов.
  • Атрибуты объектов каналов

    Объекты каналов поддерживают следующие атрибуты.

  • Connection name ( CONNAME ) – сведения о сетевом подключении к целевому менеджеру очередей (в случае каналов, устанавливающих подключения) либо к локальному менеджеру очередей (в случае кластерного receiver-канала, CLUSRCVR ). Для TCP/IP-каналов используется формат имя_или_IP_адрес(номер порта).
  • Transmission queue ( XMITQ ) – в случае sender-каналов (SDR) или server-каналов (SVR) это имя транспортной очереди, из которой они получают сообщения для последующей пересылки.
  • Short retry ( SHORTRTY ) – в случае каналов, устанавливающих подключения, это число попыток подключения с интервалом, заданным атрибутом SHORTTMR.
  • Short retry timer ( SHORTTMR ) – время ожидания (в миллисекундах) между попытками подключения (см. атрибут SHORTRTY ). Между попытками подключения канал находится в состоянии RETRYING.
  • Long retry ( LONGRTY ) – если после попыток, заданных атрибутом SHORTRTY, установить подключение не удалось, канал предпримет еще несколько попыток (их число задает этот атрибут) подключения, но уже с бо'льшим интервалом, заданным атрибутом LONGTMR. Если ни одна из этих попыток не увенчается успехом, канал перейдет в состояние STOPPED и его придется перезапускать вручную.
  • Long retry timer ( LONGTMR ) – время ожидания (в миллисекундах) между попытками подключения (см. атрибут LONGRTY ). Между попытками подключения канал находится в состоянии RETRYING.
  • Message retry ( MRRTY ) – для receiver-канала: число попыток доставки сообщения в целевую очередь до пересылки его в очередь недоставленных сообщений.
  • Message retry timer ( MRTMR ) – время ожидания (в миллисекундах) между попытками доставки сообщения.
  • MCA user identifier ( MCAUSER ) – для каналов серверных подключений ( SVRCONN ): назначает идентификатор пользователя, полномочия которого будут использоваться для проверки допустимости действий клиентов, подключающихся через этот канал.
  • Nonpersistent message speed ( NPMSPEED ) – для каналов передачи сообщений указывает, следует ли использовать единицы работы при пересылке непостоянных сообщений.
  • Batch size ( BATCHSZ ) – для каналов передачи сообщений указывает максимальное число сообщений, после передачи которых необходимо подтверждение доставки и фиксация единицы работы.
  • Batch interval ( BATCHINT ) – для каналов передачи сообщений указывает максимальное время ожидания обработки пакета до получения подтверждения доставки и фиксации единицы работы.
  • Disconnect interval ( DISCINT ) – для каналов передачи сообщений указывает время, в течение которого канал остается активным, даже если транспортная очередь пуста.
  • SSL cipher specification ( SSLCIPH ) – спецификация алгоритма шифрования для SSL или TLS, защищающего канал. Эти значения должны совпадать на обоих сторонах канала.
  • SSL client authentication ( SSLCAUTH ) – для каналов, выступающих в роли SSL-серверов, принимающих подключения, указывает, должен ли SSL-клиент предъявить сертификат.
  • SSL peer ( SSLPEER ) – строка с отличительными именами (distinguished names, DN), которым разрешено подключение через этот канал. Проверяется после проверки сертификата партнера.
  • Cluster ( CLUSTER ) – для кластерных каналов: имя кластера, для которого создан объект канала.
  • Cluster namelist ( CLUSNL ) – для кластерных каналов: имя объекта списка имен с именами кластеров, для которых создан объект канала.
  • Команды MQSC для управления каналами

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

  • START CHANNEL(NAME) или STA CHL(NAME) – создает канал связи с удаленным менеджером очередей с использованием заданного объекта канала. Также запускает каналы, ранее остановленные командой STOP CHANNEL.
  • STOP CHANNEL(NAME) или STOP CHL(NAME) – останавливает все активные каналы с заданным именем.
  • По умолчанию в команде указан атрибут STATUS(STOPPED) во избежание случайного автозапуска каналов. Изменить это можно, вызвав команду с параметром STATUS(INACTIVE).

    Записи состояния каналов

    Для всех активных MCA менеджера очередей поддерживаются записи состояния канала. Такая запись также создается при отключении канала командой STOP CHANNEL либо после безуспешных попыток подключения, число которых задано атрибутом LONGRTY.

    Для каналов в состоянии INACTIVE записей состояния не существует.

    Некоторые атрибуты объектов каналов согласовываются между MCA-партнерами, образующими канал. Результаты согласования отражаются в записях состояния канала.

    Команды MQSC для управления записями состояния каналов

    Следующая команда MQSC служит для управления записью состояния канала.

  • DISPLAY CHSTATUS(GENERIC_NAME) или DIS CHS(GENERIC_NAME) – выводит атрибуты записи состояния канала.
  • Атрибуты записи состояния канала

    Записи состояния канала поддерживают следующие атрибуты.

  • STATUS – общее состояние канала: RUNNING (канал активен), RETRYING (подключение не удалось, выполняется повторная попытка подключения) или STOPPED (для отключенных каналов); остальные состояния, например BINDING или STOPPING, являются временными.
  • INDOUBT – находится ли канал, пересылающий сообщения, в неоднозначном состоянии. В этом состоянии канал пребывает, ожидая подтверждения получения сообщений, и остается в нем, если подтверждение не пришло до разрыва подключения. При перезапуске канал автоматически выходит из этого состояния.
  • Remote queue manager name ( RQMNAME ) – для каналов, передающих сообщения: имя удаленного менеджера очередей.
  • Вернуться к учебному плану