Mq explorer как пользоваться
Обновлено: 06.07.2024
Как я могу добавить нового пользователя в свою очередь в WebSphere 7.5 MQ Explorer? У меня 90-дневная пробная версия, и у меня нет консоли администратора: / Не знаю почему .
Я хочу подключиться к очереди, размещенной на моем сервере, но я не могу подключиться к учетной записи администратора.
2 ответа
Во-первых, получите версию с неограниченным сроком действия, для которой название продукта - MQ Advanced для разработчиков. На момент написания статьи он доступен в версиях 7.5 и 8.0 и является бесплатным. Если вам нужна поддержка, IBM позволит вам бросить на них деньги, но полнофункциональный продукт с неограниченным сроком действия предоставляется бесплатно.
MQ теперь по умолчанию поставляется в безопасности. Когда вы впервые создаете диспетчер очередей, он отклоняет административные подключения по клиентским каналам. Это позволит неадминистративным каналам использовать SYSTEM.ADMIN.SVRCONN , за исключением того, что до тех пор, пока вы явно не авторизуете их, у неадминистраторов нет прав на QMgr.
(Начиная с версии v8.0, QMgr также настроен по умолчанию на требование идентификатора и пароля, но вам не нужно беспокоиться об этом с MQ v7.5.)
Если вы используете QMgr для Linux или Windows и можете запустить MQ Explorer на хосте, на котором установлен QMgr, подключитесь к QMgr, используя режим привязки, а не канал. Если вы используете ID пользователя с правами администратора (один в группе mqm или в Windows также в группе администраторов), то режим привязки будет работать.
Если вам необходимо подключиться через клиентский канал, вам нужно будет настроить MQ, чтобы разрешить административное подключение и / или подключения пользователей с низким уровнем привилегий. Вы можете сделать это, отключив правила CHLAUTH , но такой подход категорически не рекомендуется. Намного лучше узнать, как работает безопасность MQ, чем отключать ее.
Вы также можете определить новые правила CHLAUTH , разрешающие соединение. Правила по умолчанию для CHLAUTH выглядят так:
Обратите внимание, что первое правило говорит о блокировке пользователей с правами администратора на любом канале. Вы можете добавить новое правило, в котором говорится, что нужно заблокировать некоторых пользователей без прав администратора на канале, который вы хотите использовать для администраторов.
Команда DEF CHL определяет новый канал для администраторов и устанавливает для MCAUSER значение, гарантирующее, что этот канал не запустится.
Первое правило CHLAUTH предписывает MQ заменить неверный MCAUSER на один из запроса на соединение при условии, что запрос исходит от 127.0.0.1 и только для MY.ADMIN.SVRCONN . Введите здесь свой IP-адрес. Вместо этого предпочтительно использовать сертификат вместо IP-адреса для аутентификации соединения.
Второе правило CHLAUTH немного сложное. Не существует правила «РАЗРЕШИТЬ ПОЛЬЗОВАТЕЛЕЙ», поэтому мы должны использовать правило типа TYPE(BLOCKUSER) . Но когда мы блокируем пользователей, мы должны предоставить их непустой список. Нам нужно правило CHLAUTH , в котором имя канала более конкретное, чем имя по умолчанию и со значением USERLIST , которое делает не содержать *MQADMIN или ваш фактический идентификатор пользователя. Я использую здесь *NOBODY , потому что это делает очевидным, что цель состоит в том, чтобы никого не блокировать, а значение не может никогда быть фактическим идентификатором пользователя.
Определение канала только для администраторов считается лучшей практикой. Аутентификация администраторов на основе IP-адреса или имени хоста - нет. После того, как вы подключитесь со своим идентификатором администратора и настроите QMgr, подумайте о том, чтобы узнать достаточно о сертификатах MQ, чтобы строго аутентифицировать подключения администратора. И / или перейдите к V8.0 QMgr и клиенту, где вы можете войти в систему, используя пароль.
MQ Explorer не позволяет вносить изменения в операционную систему, поэтому сначала вам придется создать пользователя в операционной системе другими способами.
Однако, если ваш идентификатор пользователя существует, вы можете использовать MQ Explorer, чтобы предоставить этому пользователю доступ к очереди. Вызовите список очередей в проводнике, а затем щелкните правой кнопкой мыши очередь, в полномочия которой вы хотите добавить пользователя. Выберите «Права доступа к объектам» -> «Управление записями прав доступа . ». Появится мастер, который позволит вам добавить группу или пользователя в очередь.
Вам также нужно будет разрешить этому пользователю подключаться к диспетчеру очередей, как я подозреваю?
Настройка IBM WebSphere MQ для обмена данными
Для того чтобы пример из конфигурации "Обмен данными" работал, необходимо соответствующим образом настроить программный продукт IBM WebSphere MQ.
Опишем некоторые основные понятия. Более подробную информацию можно найти на сайте производителя (IBM WebSphere MQ).
Менеджер очередей (manager queue). Менеджер очередей – это системная программа, которая предоставляет необходимые средства для работы с очередью. Менеджер очередей также предоставляет дополнительные функции, которыми могут пользоваться администраторы: создание очереди, изменение параметров уже существующих очередей, а также контроль деятельности менеджера очередей.
Репозиторий (repository). Репозиторий – это набор информации обо всех менеджерах очередей, находящихся в кластере. Эта информация включает в себя имена менеджеров очередей, их расположение, информацию о каналах передачи данных, информацию об очередях и т. д.
Все последующие действия будут выполняться при помощи интерфейса WebSphere MQ Explorer, интегрированного в Microsoft Management Console (MMC). WebSphere MQ Explorer доступен только пользователям Windows и является альтернативой команд MQSC.
Общая схема следующая: создаются два менеджера очередей, на локальном и удаленном компьютере, между которыми необходимо обеспечить обмен данными. Затем создается кластер, в который включаются созданные менеджеры очередей. После этого создается по одной локальной очереди на каждом компьютере.
Создание менеджера очередей
В иерархическом списке в левой части окна нужно установить курсор на узел Queue Managers и после нажатия правой кнопки мыши выбрать New . Запустится мастер создания нового менеджера очередей.
В первом окошке необходимо указать уникальное имя менеджера очереди латинскими символами (например: "Head_Office") и нажать кнопку Next . Все остальные настройки остаются без изменений, кроме последнего окна, где нужно указать номер порта, например: 1515. Аналогично создается менеджер очередей на удаленном компьютере.
Создание кластера
В иерархическом списке в левой части окна нужно установить курсор на узел Clusters и после нажатия правой кнопки мыши выбрать New . Запустится мастер создания нового кластера.
Первое окно просто информативное. В следующем окне нужно ввести имя будущего кластера. Имя вводится латинскими буквами, например: "enterprise". Далее указывается менеджер очереди на локальном компьютере, который также будет и репозиторием (repository). Выбрать можно из списка менеджеров очередей. Менеджер очереди не должен быть уже репозиторием, а также находиться в другом кластере. Далее необходимо указать второй репозиторий, находящийся на удаленном компьютере. В первом текстовом поле указывается имя менеджера очередей, который, как и в первом случае, не должен уже быть репозиторием и находиться в другом кластере. Далее указывается имя для принимающего канала, а также имя соединения. Эти параметры можно оставить без изменения. Аналогично для отправляющего канала. Все настроенные параметры можно распечатать, нажав кнопку Print в последнем окне мастера.
Создание очередей
В менеджере очередей находится папка Queue . Для создания новой очереди достаточно правой кнопкой мыши щелкнуть на эту папку и выбрать пункт меню New – Local Queue , указать имя новой очереди, а также на вкладке Cluster выбрать Shared in cluster и указать кластер, который будет управлять этой очередью.
Рассмотрим порядок установки WebSphere MQ на платформе WindowsNT. Процесс установки построен таким образом, что инсталляцию может выполнить пользователь, никогда ранее не работавший с данным продуктом. WebSphere MQ не является требовательным программным обеспечением (ПО) по отношению к аппаратной части компьютера. Несмотря на это, вряд ли стоит планировать серьезную работу на низко производительных системах. К примеру, для платформы Windows NT вполне достаточно компьютера на базе процессора Pentium IV c тактовой частотой не менее 1000 MHz и ОЗУ 512 Мб. Минимальные и рекомендуемые параметры приведены в Таблице 2.1.
Приведенные цифры касаются требований самого WebSphere MQ и не учитывают потребностей операционной системы. Количество используемой оперативной памяти будет возрастать незначительно с появлением таких новых объектов как очереди, каналы, процессы, но на каждый Trigger Monitor потребуется дополнительно по 3Мбт.
На компьютере для инсталляции WebSphere MQ необходимо установить следующие программные продукты или их более поздние версии:
- Software Prerequisites – проверка установки необходимого ПО на компьютере;
- Network Prerequisites – варианты работы с использованием домена или без (рекомендуется не использовать работу в домене, т.е. на вопрос об использовании специального домена ответить «No»);
- WebSphere MQ Installation – собственно, начало инсталляции – необходимо нажать кнопку «Launch WebSphere MQ Installer».
Рис. 2.1. Меню установки WebSphere MQ
После очередного приглашения к началу инсталляции и принятия соглашения о Лицензиях появится меню с выбором вариантов установки Typical, Compact или Custom. Выбираем Typical – наиболее простой и надежный способ установки. При этом установка будет произведена на C:\Program Files\IBM\WebSphere MQ . Возможность изменения каталога и диска установки реализована в способе Custom.
Рис. 2.2. Окончание процесса установки WebSphere MQ
После нажатия на кнопку «Finish» будет предложено сконфигурировать WebSphere MQ для работы в вашей сети или перенести существующие менеджеры очередей, оставшиеся от предыдущей версии. На вопрос об использовании домена следует ответить «No». Экранную форму с предложением об установке параметров по умолчанию рекомендуется пропустить, так как и без этого программа установки успешно завершит работу, а на создании и конфигурации объектов WebSphere MQ мы остановимся подробнее в последующих разделах. После появления последней экранной формы (рис.2.3) и нажатия кнопки «Готово» процесс установки завершается.
Рис. 2.3. Окончание процесса установки и конфигурации WebSphere MQ
В результате установки мы получаем несколько инструментов для работы с WebSphere MQ (рис.2.4):
Рис. 2.4. Основные инструменты работы с WebSphere MQ
Прежде чем перейти к описанию работы с вышеуказанными утилитами рассмотрим процесс деинсталляции WebSphere MQ . Можно отметить, что в ходе многолетней эксплуатации авторам не приходилось производить переустановку WebSphere MQ в системах промышленной эксплуатации, что говорит о высокой надежности работы. Тем не менее предлагается следующий алгоритм переустановки WebSphere MQ :
Основные утилиты
Рассмотрим подробнее работу основных утилит WebSphere MQ .
First Steps . Главное меню утилиты First Steps представлено на рис.2.5.
Default Configuration . Пункт меню посвящен настройкам по умолчанию. Рассматривать его не будем, так как в дальнейшем дадим подробное описание объектов WebSphere MQ и скажем о параметрах по умолчанию для каждого объекта, а также будет рассмотрен вопрос о том, как задать один раз значение по умолчанию, чтобы все объекты в дальнейшем создавались именно с этим параметром.
Рис. 2.5. Главное меню утилиты First Steps
Quick Tour . Справочная информация о WebSphere MQ , введение, инсталляция/деинсталляция, совместимость, основные утилиты, работа с компонентами WebSphere MQ : менеджеры очередей, кластеры, очереди, каналы и пр.
WebSphere MQ Explorer . Основной продукт, позволяющий создавать и модифицировать объекты WebSphere MQ . Внешний вид представлен на рис. 2.6 и являет собой оснастку (snap-in) консоли управления Microsoft.
В левой части можно видеть список менеджеров очередей, доступных для управления и их объекты. В зависимости от позиционирования курсора в левой части на различных объектах, в правой части оснастки будут отображаться списки объектов и их свойства. Кроме этого, в верхней части имеются панели управления и панели инструментов такие как: «Стандартные меню (Действие и Вид)», стандартная панель инструментов и панель инструментов WebSphere MQ . Работа со «Стандартным меню (Действие и Вид) описана во многих справочных руководствах по работе с Microsoft Windows и не представляет особого интереса. Кратко можно сказать, что используя эти меню можно добавлять или удалять различные оснастки для консоли управления и изменять ее вид. В стандартной панели инструментов имеются две кнопки представляющие интерес в части работы с объектами WebSphere MQ . Это кнопка обновления информации и кнопка экспорта списка. Информация, отображающаяся как в левой, так и в правой части WebSphere MQ Explorer статична, т.е. отображает состояние объектов в конкретный момент времени. Для получения текущего состояния объекта необходимо нажать кнопку обновления информации (Refresh). Информация будет обновляться об объекте, на котором позиционирован курсор, то есть если он установлен в левой части на «Queues», то в правой части произойдет обновление информации о состоянии всех очередей, а если курсор будет установлен на одну очередь в правой части WebSphere MQ Explorer , то информация обновится только об этой очереди. С помощью кнопки экспорта списка можно вывести всю информацию об объектах в текстовый файл. Этим удобно пользоваться для анализа состояния объектов менеджера очередей WebSphere MQ , например, легко выяснить, какие каналы используют одну и ту же трансмиссионную очередь и устранить эту "опасную настройку". Используя кнопки панели инструментов WebSphere MQ Explorer можно скрывать или отображать различные типы объектов менеджеров очередей. Например, информация о состоянии временных очередей и системных объектах не так важна и актуальна, и ее можно убрать с экрана или добавить с помощью кнопок
Для подключения к удаленному менеджеру очередей необходимо вызвать контекстное меню из группы «Queue Managers» и выполнить пункт «Show Queue Manager. ». В появившейся форме выставить флажок «Show a remote queue manager» и заполнить поля «Queue Manager Name» (имя удаленного менеджера) и «Connection Name» - IP адрес или имя компьютера с указанием в скобках номера порта для службы Listener (по умолчанию 1414 ). Подключение к менеджеру возможно в том случае, если пользователь обладает соответствующими правами на удаленном компьютере.
Рис. 2.6. WebSphere MQ Explorer
Подробные действия для создания и управления объектами WebSphere MQ как с помощью WebSphere MQ Explorer , так и с помощью команд MQSC (MQSeries commands) будет рассмотрено ниже.
Help Center . Данный пункт меню вызывает справочную систему WebSphere MQ , в которой имеется глоссарий и возможность поиска информации по ключевым словам.
Менеджер очередей
Менеджер очередей – совокупность объектов WebSphere MQ (различных видов очередей, каналов, процессов, сервисов или служб). Он осуществляет контроль и управление всеми его объектами и обрабатывает поступающие запросы от прикладных программ.
Для создания любого объекта WebSphere MQ , и менеджера очередей в частности, существует два основных способа: на основе команд и графический, работающий в среде Windows. Создание объектов и работа с ними на основе команд является универсальным способом, работающим на различных платформах с одним и тем же синтаксисом этих команд. Поэтому создание менеджера очередей рассмотрим прежде всего с помощью команды crtmqm .
Итак, для платформы NT необходимо ввести в командной строке:
QM_Win2000 – имя менеджера очередей.
Подробное описание утилиты runmqsc и работы с основными командами MQSC будет рассмотрено ниже. Имя менеджера очередей не является уникальным в пределах сети, но на одном компьютере не может быть двух менеджеров с одинаковым именем.
Для платформы UNIX синтаксис команды выглядит следующим образом:
Данная команда, как и опция –u должна быть введена в нижнем регистре и именно со знаком «-» ( -U работать не будет).
Также для успешного создания/изменения любого объекта необходимо обладать соответствующими правами. Так, например, WindowsNT пользователь, от имени которого вводится команда, должен быть членом группы mqm . Подробнее о вопросах авторизации см. в лекции 5.
Полный синтаксис команды crtmqm имеет вид:
Опции команды crtmqm означают следующее.
–c Text - Описание (description) или комментарий, можно ввести до 64 символов.
–h MaximumHandleLimit - Максимальное количество открытых объектов (командой MQOPEN ). Значение может быть в пределах от 1 до 999 999 999, по умолчанию 256 (если не планируется работа одного приложения с более чем 256 объектами на одном менеджере, а авторы настоятельно не рекомендуют этого делать за исключением работы с distribution list, то следует оставить значение по умолчанию, т.е. 256);
Данное значение ( lc ) используется по умолчанию.
–ll - Используется «линейное» логирование. При данном типе логирования возможно восстановление данных. Указав тип логирования при создании менеджера в дальнейшем нельзя его изменить.
–ld LogPath - Указывается путь, где будут создаваться файлы логирования. Для UNIX по умолчанию это var/mqm/log . Пользователь и группа mqm должны иметь соответствующие права в этом каталоге. Соответственно, при изменении пути необходимо также предоставить соответствующие права для вышеуказанных пользователей.
Для NT по умолчанию – C:\Program Files\IBM\WebSphere MQ\log
–lf LogFileSize - Размер файла логирования. Файл будет создан с размером в 4 раза большим указанного числа. Значение может быть в диапазоне между 32 и 4095 для NT, OS/2 Warp и между 64 и 16384 для UNIX. Значение по умолчанию для NT и OS/2 Warp равно 256 для UNIX – 1024.
–lp LogPrimaryFiles - Количество первичных файлов логирования. Может быть в пределах от 2 до 62. Значение по умолчанию – 3.
–ls LogSecondaryFiles - Количество вторичных файлов логирования. Может быть в пределах от 1 до 61. Значение по умолчанию – 2.
Следует соизмерять размеры файлов с возможностями операционных систем.
–q - Если указана опция –q , то созданный менеджер очередей будет создан как менеджер по умолчанию.
–g ApplicationGroup - Опция применима только для AIX, Sun-Solaris и HP-UX. Указывается имя группы, которой разрешается запускать MQI приложения, работать с файловой системой менеджера очередей.
–t IntervalValue - Определяет время интервала триггеринга очередей в миллисекундах. Значение может быть в пределах от 0 до 999 999 999 (более 11 дней). Подробнее о триггеринге см. в лекции 4.
MQMName - Имя менеджера.
Возможные ошибки при создании менеджера очередей отражены в документации [7]. Этой книгой " WebSphere MQ . Messages" рекомендуется пользоваться всегда, как только будет получен код ошибки AMQxxxx.
Просмотреть и изменить текущую кодовую страницу можно с помощью утилиты runmqsc.exe и соответствующих команд в ней, например, alter qmgr force ccsid(1251) . Итак, используя простейший синтаксис :
можно создать менеджер QM_Win2000. Затем следует его активизировать (стартовать).
Для этого существует утилита strmqm :
-c - При указании этой опции менеджер стартует, пересоздает все системные объекты с параметрами по умолчанию и затем останавливается.
MQMName - Имя менеджера.
Для простого старта менеджера по умолчанию достаточно набрать в командной строке:
Для остановки менеджера очередей существует утилита endmqm :
-i - Менеджер выполнит все текущие запросы приложений и остановится. Если в процессе остановки появятся новые запросы и необработанные транзакции, то при последующем старте менеджера произойдет откат незавершенных транзакций. Управление передается командной строке после остановки менеджера.
-p - Немедленная остановка. Менеджер остановится, не обрабатывая все текущие транзакции и запросы приложений. Остановка с данной опцией может привести к непредсказуемым результатам. Все процессы WebSphere MQ , которые не могут быть корректно остановлены в течение 30 секунд после начала работы endmqm будут отключены.
Перед остановкой менеджера необходимо остановить все приложения, работающие с WebSphere MQ , несмотря на то, что WebSphere MQ в процессе остановки менеджера будет пытаться их отключить.
И последняя команда – удаление менеджера:
MQMName - Имя менеджера.
При выполнении этой команды удаляется не только менеджер, но и все его объекты. Перед удалением менеджера следует его остановить с помощью команды endmqm . Важно, чтобы в момент удаления менеджера, каталог с содержимым менеджера (для WindowsNT это - C:\Program Files\IBM\WebSphere MQ\Qmgrs\QM_Win2000 ) не был никем «захвачен», иначе удалить менеджер невозможно.
Управлять работой менеджеров очередей можно с помощью WebSphere MQ Explorer .
Процесс создания менеджера:
- Запустить WebSphere MQ Explorer .
- Щелкнуть правой кнопкой мыши по "Queue Managers".
- Выбрать из контекстного меню пункт "New" => "Queue Manager".
- Выбрать из контекстного меню пункт "New" => "Queue Manager".
Рис. 2.7. Создание менеджера очередей (Шаг 1)
Queue Manager – имя менеджера;
Make this the default queue manager – флажок, определяющий будет ли этот менеджер менеджером по умолчанию;
Def. Transmission Queue – имя трансмиссионной очереди по умолчанию рекомендуется оставить пустым во избежание ошибок передачи данных;
Max Handle Limit – количество открытых объектов WebSphere MQ одним приложением (одна программа не сможет работать одновременно более чем с 256 очередями);
Trigger Interval – значение интервала времени, через который опрашивается состояние очереди триггерными процессами;
Рис. 2.8. Создание менеджера очередей (Шаг 2)
Use circular/linear logging - с помощью данного флажка можно выбрать тип логирования на вновь создаваемом менеджере;
Log Path – указывает путь, где будут созданы лог-файлы;
Log File Size - размер файла логирования, размер созданного файла будет в 4 раза превышать указанное число;
Log Primary Files – количество первичных файлов логирования;
Log Secondary Files – число вторичных файлов логирования.
Рис. 2.9. Создание менеджера очередей (Шаг 3)
Start Queue Manager – при установленном флажке менеджер очередей будет активизирован непосредственно сразу после создания;
Create Server Connection Channel – установка данного флажка позволит создать канал ( SYSTEM.ADMIN.SVRCONN ) для удаленного управления объектами менеджера через протокол TCP/IP.
Рис. 2.10. Создание менеджера очередей (Шаг 4)
Create listener configured for TCP/IP – создает listener для удаленного подключения к менеджеру;
Listen on port number – номер порта для работы listener (по умолчанию - 1414 ).
После нажатия на кнопку «Finish» менеджер с именем QM_Win2000 будет создан и произведен его старт. На оснастке консоли WebSphere MQ Explorer с левой стороны должно появиться имя менеджера, как это показано на рис.2.6.
В заключении можно добавить, что все эти процессы не представляют особой сложности. Процесс установки WebSphere MQ на NT-платформу занимает около получаса и решающим обстоятельством является мощность или скорость дисковых ресурсов. На процесс создания менеджера после ввода всех параметров уйдет не более минуты. Время остановки менеджера зависит от количества объектов. Для примера можно сказать, что на компьютере Pentium III с тактовой частотой 700 MHz и оперативной памятью 512Mb, менеджер, содержащий 1000 очередей, останавливается меньше чем за 30 секунд.
Примером такого модуля, обогащающего WebSphere MQ Explorer дополнительными возможностями обнаружения неисправностей и созданного на базе точек расширения приложения, является WebSphere MQ Explorer Healthcheck.
5.2.3. Управляющие команды WebSphere MQ
5.2.4. Команды языка управления WebSphere MQ для iSeries
в составе 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 может иметь отрицательные последствия для рабочего окружения. Учет вносимых в менеджер изменений отсутствует, и согласованная запись модификаций, производимых через графический интерфейс, может оказаться непростым делом.
Использование для выполнения команд настройки менеджеров очередей сценарного интерфейса позволяет осуществлять действия по управлению изменениями, нацеленные на регистрацию и учет выполненных команд. Документируя команды сценария для создания и настройки менеджера очередей и внеся в них минимальные изменения, можно сформировать дубликат менеджера, к примеру для масштабирования системы с переносом на другую машину.
Сценарии могут служить для выполнения распространенных команд администрирования системы, а результат работы таких сценариев – передаваться на обработку для выявления успешности завершения и выдачи соответствующей диагностической информации.
Выполнение команд MQSC
Команды MQSC выполняются над менеджером очередей так, как описано ниже.
- WebSphere MQ для Windows, WebSphere MQ для UNIX.
Если набор команд MQSC сохранен в файл, то содержимое файла можно передать команде runmqsc через стандартный ввод :
Команды MQSC могут выполняться в интерактивном режиме, для чего служит CL-команда RUNMSQC.
Также они могут быть записаны как сценарий, который представляет собой физический файл-источник. Для его выполнения предназначена CL-команда STRMQMMQSC .
Примечание Дополнительно WebSphere MQ для iSeries содержит CL-команды, которые могут служить для выполнения MQSC-команд через панельный диалоговый интерфейс. Для доступа к этим CL-командам WebSphere MQ воспользуйтесь CL-командой WRKMQM . Примечание WebSphere MQ для z/OS содержит панели управления и операции, которые могут использоваться для интерактивного выполнения функций MQSC-команд. Для доступа к ним служат Time Sharing Option (TSO) и Interactive System Productivity Facility (ISPF).Синтаксис MQSC
Синтаксис MQSC очень прост. Общий формат команды имеет вид:
где OBJTYPE – тип объекта, COMMAND – один из ряда допустимых для данного типа объектов командных ключевых слов, ATTR1, ATTR2, ATTR3 – названия допустимых для него атрибутов.
Отдельные комбинации командных ключевых слов и типов объектов, такие как ALTER QMGR , не требуют указания имен объектов. Отдельные атрибуты не требуют приведения их значений. Немало команд и типов имеют сокращенные варианты; к примеру, ALT может заменить ALTER .
Для некоторых командных ключевых слов требуется задание как типа, так и подтипа, например:
Каждая комбинация ключевого слова и типа принимает свой набор атрибутов. Ряд атрибутов является обязательным. Для указания пустого значения атрибута используйте пробел в круглых скобках: ATTR( ) . Ряд атрибутов допускает множественность значений. В этом случае они разделяются запятыми. Например, так:
Если в команде приведена допустимая комбинация ключевого слова и типа, но атрибуты команды не соответствуют указанной комбинации или пропущены, но должны быть, команда не выполняется, а на экран выводится краткая информация о правилах записи выбранной комбинации.
Примечание Названия объектов и значения атрибутов, не заключенные в знаки одинарных кавычек, автоматически преобразуются в верхний регистр. Поэтому если вам требуется ввести в команду названия объектов или значения атрибутов в нижнем регистре символов, то вы должны использовать знаки одинарных кавычек.Значения атрибутов, содержащие специальные символы, например скобки, должны записываться в одинарных кавычках.
MQSC не различает регистр ключевых слов, таких как COMMAND, OBJTYPE, ATTR1, ATTR2, ATTR3 , в вышеуказанном примере общего формата команды.
В число наиболее употребительных командных ключевых слов входят следующие:
Создать новый объект с конкретным типом, названием и значениями перечисленных атрибутов. Для принудительной замены существующего объекта с таким же типом и именем DEFINE может сопровождаться атрибутом REPLACE . Для указания названия другого объекта с таким же типом, значениями атрибутов которого нужно заполнить все атрибуты объекта, не указанные в команде, служит атрибут LIKE .
Модифицировать имеющийся объект с конкретным типом и конкретным названием, придав его атрибутам указанные значения.
Удалить имеющийся объект с конкретным типом и конкретным названием.
Отобразить названные атрибуты имеющихся объектов с конкретным типом и конкретным названием. Для вывода на экран всех атрибутов каждого из объектов можно воспользоваться специальным именем ALL . Если не задан ни один атрибут, для каждого из объектов выводится набор атрибутов по умолчанию.
В конце названий и значений типов объектов можно указать "звездочку" (*) . Это вынуждает команду отобразить атрибуты всех тех объектов, названия или типы которых начинаются со значения, указанного до символа маски. Например, следующая команда отображает все атрибуты очередей , названия которых начинаются на example :
Произвести запуск существующего объекта с конкретным типом и конкретным названием, к примеру, слушателя или канала.
Команда MQSC может занимать несколько строк, для переноса между которыми после пробела в конце строки пишут знак "плюс" (+) . Например, так:
Также в сценарий MQSC могут включаться строки, содержащие комментарий. Первым знаком такой строки служит знак "звездочка" (*) .
5.2.7. Форматы программируемых команд (PCF)
- WebSphere MQ для Windows, WebSphere MQ для UNIX:
Для запуска командного сервера в WebSphere MQ для z/OS используется команда:
Читайте также: