RFHUtil (WMB SupportPac IH03)

RFHUtil – это программная утилита, входящая в состав SupportPac IH03, предназначенная для чтения данных из файлов или очередей и записи данных в файлы или очереди. RFHUtil позволяет отображать данные сообщения в различных форматах не изменяя сами данные, а так же создавать или изменять данные. Еще одной важной особенностью утилиты является, то, что она позволяет работать (добавлять/удалять) со множеством заголовков, таких как RFH (Rules and Formatting Headers [версии 1 и 2]), CIH (CICS Information Headers), IIH (IMS Information Headers) и Dead Letter Headers. RFHUtil имеет полный набор возможностей для работы с функционалом WMQ publish/subscribe.

Скачать SupportPac IH03 можно здесь:

Icon of Zip Archives ih03 (5.0 MB)

или по ссылке: ftp://ftp.software.ibm.com/software/integration/support/supportpacs/individual/ih03.zip

В SupportPac IH03, который называется “WebSphere Message Broker – Message display, test & performance utilities”, входит ряд консольных программ для тестирования и измерения производительности WMQ и WMB/IBM Integration Bus:

  • MQPUT2.exe – утилита для нагрузочного тестирования и измерения производительности. Она создает рабочую нагрузку, формируя сообщения на основе данных из одного или нескольких файлов и специального файла с параметрами. Утилита предназначена для работы с локальными очередями.
  • MQTIMES.exe и MQTIMES2.exe – утилиты, которые читают сообщения из выходной очереди и сообщают о количестве обработанных сообщений в секунду. Главное различие между MQTIMES.exe и MQTIMES2.exe заключается в том, что MQTIMES2.exe предназначена для одновременной работы с MQPUT2.exe. Она читает сообщения из очереди в реальном времени до тех пор, пока они там есть. Такой механизм работы позволяет минимизировать риск переполнения буфера очереди и, как следствие, необходимости использования дискового пространства, а так же существенно снизить размер периодических checkpoint-ов очереди, когда буфер очереди записывается на диск.
  • MQCapture.exe – утилита, предназначенная для чтения нескольких сообщений из очереди и их записи в файл, каждое сообщение отделяется строкой-разделителем.
  • MQCapone.exe – утилита, предназначенная для чтения одного сообщения из очереди и его записи в файл.
  • MQTest.exe – аналогичная MQPUT2.exe утилита, имеющая такой же синтаксис и использующая такой же формат файла с параметрами, но формирующая каждое сообщение один раз. Параметры, такие как “число сообщений”, игнорируются. Кроме того, она не держит данные всех файлов в памяти. Утилита загружает в память данные одного файла после его прочтения, а затем освобождает память перед чтением следующего файла.
  • MQReply.exe – утилита, предназначенная для тестирования сценария “запрос-ответ”. Т.е. она позволяет отправлять сообщения-ответы на сообщения-запросы.
  • MQPUTS.exe – специальная версия утилиты MQPUT2.exe. Пишет все сообщения сразу, не пытаясь сбалансировать скорость ввода по отношению к пропускной способности нагрузочного теста. Эта утилита, главным образом, предназначена для тестирования сред, а не измерения производительности.
  • MQPUTSC.exe – клиент-версия утилиты MQPUTS.exe, для работы с удаленными очередями.

Утилита RFHUtil представлена в двух вариантах: RFHUtil.exe – для работы с локальным менеджером (требуется установленный WebSphere MQ Server); RFHUtilc.exe – клиент-версия для работы с удаленным менеджером (требуется установленный WebSphere MQ Client);

Подробная информация о работе со всеми утилитами содержится в документе ih03.doc, который находится внутри архива ih03.zip.

Так как чаще всего приходится работать с удаленными менеджерами очередей, то следует отметить последовательность действий для соединения RFHUtilc с удаленным менеджером:

1. Установите MQ Client на ПК с которого будет запускаться rfhutilc.

2. На этом же ПК: Пуск -> Панель управления -> Система -> Дополнительные параметры системы -> Переменные среды. В разделе “Системные переменные” создайте переменную MQSERVER со значением по шаблону: channel_name/TCP/host(port), где:

  • channel_name – имя канала для соединения с сервером
  • TCP – тип соединения TCP/IP
  • host – IP адрес сервера
  • port – порт для соединения с менеджером очередей

Например: SYSTEM.DEF.SVRCONN/TCP/9.242.192.146(1414)

3. Запустите rfhutilc.exe. На вкладке “Main“, в поле “Queue Manager Name“, с помощью выпадающего списка выберите соединение, созданное на предыдущем шаге.

4. Нажмите кнопку “Load Names” для соединения с удаленным менеджером и получения списка очередей. После этого, в поле “Queue Name” из выпадающего списка можно выбрать необходимую целевую очередь.

5. Нажмите “File” и выберите файл с расширением .txt, в котором содержится текст сообщения.

6. Нажмите “Write Q” для того, что бы поместить сообщение в удаленную очередь. Если возникает ошибка 2035, то в поле MCA целевой очереди следует добавить userid, обладающего необходимыми правами.

VN:F [1.9.22_1171]
Rating: 5.0/5 (3 votes cast)
Метки: , , ,
Опубликовано в WebSphere Message Broker, Утилиты
4 комментария на “RFHUtil (WMB SupportPac IH03)
  1. Можно ли в rfhutil-е выставить время жизни сообщения?

    VA:F [1.9.22_1171]
    Rating: 0 (from 0 votes)
    • Михаил Голубков Михаил Голубков:

      Можно!
      Для этого предназначено поле Expiry во вкладке MQMD

      VN:F [1.9.22_1171]
      Rating: +1 (from 1 vote)
  2. Сергей:

    Полезно, но очень мало.
    Я бы ещё добавил, что RFHUtil позволяет

    1. Сохранять сообщения из очереди (все или с какого-то по какое-то) и загружать в очередь.
    Кнопки SaveQ/LoadQ

    2. Позволяет просматривать сообщения не считывая их (кнопка BrowseQ)

    3. Позволяет вытаскивать нужное сообщение из очереди по параметрам сообщения (кажется и по содержимому usr можно искать).

    Без этой утилиты как без рук :-)

    VA:F [1.9.22_1171]
    Rating: 0 (from 0 votes)
  3. Sergey Kirsanov Sergey Kirsanov:

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

    VN:F [1.9.22_1171]
    Rating: 0 (from 0 votes)

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *

*

Можно использовать следующие HTML-теги и атрибуты: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code class="" title="" data-url=""> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong> <pre class="" title="" data-url=""> <span class="" title="" data-url="">

Выбор языка: