Свойства IBM MQ

Свойства IBM® MQ применяются на уровне всего экземпляра IBM MQ.

В следующих таблицах перечислены свойства, которые можно задать для IBM MQ:

Приводятся краткое описание каждого свойства и его настройка. Свойства в окне свойств IBM MQ связаны с разделами файлов конфигурации.

Общие

В следующей таблице перечислены свойства, которые задаются на странице Общие в окне Свойства IBM MQ.

Свойство Описание Ключ раздела
Префикс по умолчанию Для того чтобы изменить расположение каталога, в котором хранятся все данные администратора очередей, введите полный путь к каталогу. DefaultPrefix
Имя администратора очередей по умолчанию Для того чтобы указать имена по умолчанию для новых администраторов очередей, введите их в это поле. Имя

Страница Расширенные

В следующей таблице перечислены свойства, которые задаются на странице Расширенные в окне Свойства IBM MQ.

Свойство Описание Ключ раздела
[V9.2.0, июль 2020]Временный префикс по умолчанию Для того чтобы изменить расположение каталога, в котором хранятся все данные временного администратора очередей, введите полный путь к каталогу. DefaultEphemeralPrefix
Преобразование разделителя строк в формате EBCDIC Кодовые страницы в формате EBCDIC содержат символ разделителя строк (NL), не поддерживаемый кодовыми страницами в формате ASCII (хотя в некоторых вариантах ASCII ISO есть равноценный символ). Если сообщения отправляются из системы, использующей кодовые страницы в формате EBCDIC (например, из системы z/OS), в систему, использующую ASCII, то можно управлять тем, как символ разделителя строк в формате EBCDIC будет преобразовываться в формат ASCII. По умолчанию используется значение NL_TO_LF, подразумевающее, что символ NL в формате EBCDIC (X'15') преобразуется в символ перевода строки LF в формате ASCII (X'0A') при любом преобразовании формата из EBCDIC в ASCII. Для преобразования символа NL в формате EBCDIC в соответствии с таблицами преобразования вашей операционной системы выберите TABLE. Учтите, что результат преобразования TABLE может отличаться на разных платформах и для разных языков; даже на одинаковой платформе результат может отличаться при использовании разных идентификаторов набора символов (CCSID). Для преобразования идентификатора ISO с помощью метода TABLE, а всех остальных идентификаторов с помощью метода NL_TO_LF, выберите ISO. ConvEBCDICNewline
Режим полезной нагрузки кластера Программа выхода полезной нагрузки кластера, CLWL, позволяет указать, какую очередь кластера необходимо открыть в ответ на вызов MQI (например MQOPEN или MQPUT). Значение по умолчанию, SAFE, подразумевает, что программа выхода CLWL выполняется в виде отдельного процесса, чтобы, если возникнет неполадка, не была нарушена целостность администратора очередей. Однако, выполнение программы выхода CLWL в виде отдельного процесса может повлечь за собой дополнительное снижение производительности. Для выполнения программы выхода CLWL в том же процессе, в котором выполняется администратор очередей, в целях увеличения производительности выберите FAST. Используйте режим FAST, только если уверены, что при выполнении программы выхода CLWL не возникнет неполадок. Ведь если в режиме FAST возникает неполадка, происходит сбой администратора очередей, что может вызвать нарушение его целостности. Это значение можно переопределить для отдельных администраторов очередей с помощью свойства режима нагрузки кластера. Дополнительная информация приведена в разделе Свойства администраторов очередей. CLWLMode

Программы выхода

В следующей таблице перечислены свойства, которые задаются на странице Программы выхода в окне Свойства IBM MQ. Свойства на странице Программы выхода изменяются для настройки программ выхода, общих для всех администраторов очередей в данной системе.

Свойство Описание Ключ раздела
Путь по умолчанию к точкам выхода Для того чтобы изменить расположение программ выхода канала для клиентов, а также программ выхода канала и преобразования данных для серверов, введите путь к новому каталогу. ExitsDefaultPath
Общие точки выхода API Для настройки новой общей программы выхода API для IBM MQ щелкните на значке Добавить в окне Свойства и введите сведения о программе выхода. Для изменения общей точки выхода API, которая уже присутствует в таблице, нажмите кнопку Изменить. Кнопка Удалить позволяет удалить точку выхода API таблицы. ApiExitCommon
Шаблоны точек выхода API Для настройки нового шаблона программы выхода API для IBM MQ нажмите кнопку Добавить и введите сведения о нем в окне Свойства. Для изменения шаблона точки выхода API, которая уже присутствует в таблице, нажмите кнопку Изменить. Кнопка Удалить позволяет удалить точку выхода API из таблицы. ApiExitTemplate
Имя Описательное имя программы выхода API, передаваемое ей в поле ExitInfoName структуры MQAXP. Имя длиной не более 48 символов должно быть уникальным и содержать только символы, допустимые для имен объектов IBM MQ, таких как имена очередей. Имя
Тип Тип программы выхода: общая или шаблон. (Нет отдельного ключа раздела.)
Sequence Число без знака, определяющее последовательность, в которой данная программа выхода API вызывается по сравнению с другими программами выхода API. Программа выхода API с низким значением последовательности вызывается до программы выхода API с высоким значением. Порядок вызова программ выхода API с одинаковыми значениями последовательности не определен. В идеале между значениями последовательности программ выхода API, заданными для администратора очередей, должны быть пропущенные интервалы. Sequence
Модуль Указывает модуль, который содержит исходный код для выхода API. Если в этом поле указан полный путь к модулю, он используется, как есть. Если там указано только имя модуля, его поиск осуществляется с помощью того же метода, что используется для программ выхода канала, т. е. с помощью значения в поле Путь по умолчанию к программе выхода на странице Программы выхода. Модуль
Функция Указывает имя точки входа функции в модуль, который содержит исходный код для выхода API. Эта точка входа является функцией MQ_INIT_EXIT. Длина этого поля ограничена значением MQ_EXIT_NAME_LENGTH. Функция
Данные Если это свойство задано, то начальные и конечные пробелы удаляются, остальная строка ограничивается 32 символами и результат передается в точку выхода в поле ExitData структуры MQAXP. Если оно не указано, программе выхода в поле ExitData структуры MQAXP передается значение по умолчанию из 32 пробелов. Данные

Параметры протокола по умолчанию

В следующей таблице перечислены свойства, которые задаются на странице Параметры протокола по умолчанию в окне Свойства IBM MQ. Для изменения параметров протокола по умолчанию отредактируйте свойства на странице Параметры протокола по умолчанию. Эти значения будут применяться ко всем новым администраторам очередей по умолчанию.

Свойство Описание Ключ раздела
Тип протокола Для того чтобы включить восстановление администратора очередей при перезапуске, выберите Циклический. Если в администраторе очередей применяется циклическое ведение протокола, то, когда файл протокола полон, он перезаписывается с начала файла. Для того чтобы включить восстановление администратора очередей с носителя или прямое восстановление при перезапуске, выберите Линейный. Если используется линейное ведение протокола, при заполнении файла протокола создается новый. LogType
Путь к протоколу Для изменения расположения протоколов по умолчанию введите в это поле полный путь. Если не указать путь, по умолчанию будет использоваться подкаталог Log, расположенный в DefaultPrefix, где DefaultPrefix - это каталог, указанный в свойстве Префикс по умолчанию на странице Общие в окне Свойства IBM MQ. LogPath
Страницы файла протокола Введите число (32 - 4095) страниц по 4 КБ в файле протокола. Например, если ввести 256, размер файла будет равен 1 МБ. LogFilePages
Первичные файлы протокола

В системе Windows введите число первичных файлов протоколов (от 2 до 254). По умолчанию применяется значение 3. Общее число первичных и вторичных файлов протокола не должно превышать 255 и не должно быть меньше 3.

В системе UNIX и Linux® введите число первичных файлов протоколов (от 2 до 510). По умолчанию применяется значение 3. Общее число первичных и вторичных файлов протокола не должно превышать 511 и не должно быть меньше 3.

LogPrimaryFiles
Вторичные файлы протокола

В системе Windows введите число вторичных файлов протоколов (от 1 до 253). По умолчанию применяется значение 3. Общее число первичных и вторичных файлов протокола не должно превышать 255 и не должно быть меньше 3.

В системе UNIX и Linux введите число вторичных файлов протоколов (от 1 до 509). По умолчанию применяется значение 3. Общее число первичных и вторичных файлов протокола не должно превышать 511 и не должно быть меньше 3.

LogSecondaryFiles
Страницы буфера протокола Введите число страниц (0 - 512) буфера для записи по 4 КБ. Если указать 0, администратор очередей сам выберет число.

Если ввести число от 1 до 17, используется минимум 18. Если ввести число в диапазоне 18 - 512, то используется указанное количество. При изменении данного свойства необходимо перезапустить администратор очередей для его обнаружения.

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

Значение по умолчанию: TripleWrite. Обратите внимание, что можно выбрать значение DoubleWrite, однако система будет интерпретировать его как TripleWrite.

Значение SingleWrite допустимо только в том случае, если файловая система или устройство, содержащее протокол восстановления IBM MQ, обеспечивает запись с уровнем атомарности 4 КБ.

В случае сбоя записи страницы размером 4 КБ возможны только два состояния: до образа и после образа. Промежуточные состояния недопустимы.

LogWriteIntegrity
Управление протоколами Способ управления протоколами. Параметр LogManagement применяется только в том случае, если для параметра LogType указано значение LINEAR.

Новое значение параметра LogManagement вступает в силу только после перезапуска администратора очередей.

Можно указать одно из трех значений.

Manual - позволяет управлять областями протоколов вручную. В этом режиме области протоколов не используются снова и не удаляются даже в том случае, если они больше не требуются для восстановления.

Automatic - области протоколов управляются администратором очередей в автоматическом режиме. В этом режиме администратор очередей может повторно использовать и удалять области протоколов, которые больше не требуются для восстановления. Архивирование не предусмотрено.

Archive - области протоколов управляются администратором очередей, однако дополнительно необходимо настроить уведомление администратора очередей об архивировании областей протоколов.

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

Значение по умолчанию: Manual.

LogManagement

Страница ACPI

В следующей таблице перечислены свойства, которые задаются на странице ACPI в окне Свойства IBM MQ. ACPI (Расширенный интерфейс конфигурации и управления питанием) - это компонент операционной системы, позволяющий системе обнаруживать определенные уровни активности и переходить в "спящее" состояние, т. е. переключаться в режим низкого энергопотребления без выполнения программ таким образом, чтобы было возможно быстрое восстановление рабочего состояния.

Перед тем как перевести систему в "спящее" состояние, ACPI отправляет всем приложениям запрос на приостановку. Для управления ответом IBM MQ на этот запрос задайте значение свойства Вывод окна диалога на странице ACPI.

Свойство Описание Ключ раздела
Окно подтверждения действия Значение Да (значение по умолчанию) указывает, что IBM MQ выдает пользователю сообщение с запросом на приостановку запущенных администраторов очередей. Для приостановки IBM MQ без вывода этого сообщения выберите Нет. DoDialog
Запретить приостановку Если свойство Окно подтверждения действия не задано или если оно задано, но нет возможности вывести окно диалога (например, при закрытой крышке портативного компьютера), то ответом управляет свойство Запретить приостановку. Значение Нет (значение по умолчанию) означает, что IBM MQ приостанавливается, даже если невозможно отобразить окно. Для того чтобы запретить приостановку IBM MQ, если невозможно вывести это окно, выберите значение Да. Этот атрибут может быть отменен атрибутом Проверка наличия выполняющихся каналов. DenySuspend
Проверка наличия выполняющихся каналов Значение по умолчанию, Нет, подразумевает, что IBM MQ не проверяет наличие выполняющихся каналов и отвечает в соответствии со значением свойств Окно подтверждения действия и Запретить приостановку. Для проверки наличия выполняющихся каналов выберите Да. Если выполняющихся каналов нет, IBM MQ игнорирует свойства Окно подтверждения действия и Запретить приостановку. Если есть работающие каналы, IBM MQ отвечает в соответствии со свойствами Окно подтверждения действия и Запретить приостановку. CheckChannelsRunning
[Windows]

Страница монитора предупреждений

Монитор предупреждений доступен только в Windows.

В следующей таблице перечислены свойства, которые задаются на странице Монитор предупреждений в окне Свойства IBM MQ. Монитор предупреждений полезен для определения неполадок. Предупреждения показываются службами, когда где-то происходит сбой: например, если служба вызова канала не может быть запущена, поскольку была удалена необходимая очередь. Для настройки монитора предупреждений измените свойства на странице Монитор предупреждений.

Свойство Описание Ключ раздела
Монитор предупреждений уведомляет пользователя Нет (значение по умолчанию) означает, что в случае возникновения неполадки IBM MQ не отправляет предупреждения пользователю. Для того чтобы IBM MQ отправлял предупреждения, выберите Да. Включить
Пользователь монитора предупреждений Введите имя компьютера или имя пользователя, которому IBM MQ должен отправлять предупреждения. Получатель
Значок монитора предупреждений добавлен на панель задач Значение Нет (это значение по умолчанию) указывает, что на панели задач Windows не отображается значок монитора предупреждений. Для отображения этого значка на панели задач Windows выберите Да. TaskBar

Страница информации конфигурации

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

Свойство Описание
Тип установки Только для чтения. Это свойство указывает, какая разновидность IBM MQ установлена на этом компьютере: сервер или клиент.
mqjbnd05 загружена Только для чтения. Библиотека, необходимая для связи с локальными администраторами очередей.
Версия MQ Только для чтения. Версия IBM MQ, установленная на этом компьютере.
Уровень компоновки Только для чтения. Номер компоновки продукта IBM MQ, установленного на этом компьютере.
Тип компоновки Только для чтения. Тип компоновки продукта IBM MQ, установленного на этом компьютере.