Свойства каналов

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

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

Некоторые свойства применимы не ко всем типам каналов:
  • Отдельные свойства относятся к кластерным каналам.
  • [z/OS]Отдельные свойства относятся к каналам z/OS.

Приводятся краткое описание каждого свойства и его настройка. В таблицах также указывается эквивалентный параметр MQSC для команд DEFINE CHANNEL, ALTER CHANNEL и DISPLAY CHANNEL. Дополнительная информация о командах MQSC приведена в разделе Администрирование с помощью команд MQSC в документации по продукту IBM® Knowledge Center.

Общие

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

Свойство Назначение Параметр MQSC
Имя канала Только для чтения. Это имя определения канала. CHANNEL
Тип Только для чтения. Это тип определения канала. CHLTYPE
Размещение QSG Только для чтения. Это размещение группы совместного использования очередей для определения канала. Размещение определения канала невозможно изменить после его создания. Администратор очередей означает, что определение объекта доступно только тому администратору очередей, в котором оно располагается. Группа означает, что определение объекта хранится в общем хранилище, и у каждого администратора очередей из группы совместного использования очередей есть его копия. Копия означает, что определение объекта является копией, принадлежащей администратору ресурсов, оригинал которой находится в общем хранилище. QSGDISP
Описание Дается имеющее смысл описание назначения канала. См. Строки в окнах свойств. DESCR
Имя администратора очередей Указывается имя администратора очередей, для которого определяется канал. Для каналов соединений с клиентами указывается имя администратора очередей, с которым некоторое приложение, выполняемое в клиентской среде MQI, может запросить соединение. QMNAME
Протокол передачи Из списка выбирается тип передачи для канала. TRPTYPE
Имя соединения Для всех типов каналов, кроме кластерных каналов получателя, вводится имя компьютера с целевым администратором очередей. Формат имени соединения зависит от выбираемого протокола передачи. Например, если используется протокол TCP/IP, и известно, что соединение с целевым администратором очередей осуществляется с использованием другого номера порта, а не порта 1414, применяемого в IBM MQ по умолчанию, то введите имя_компьютера(номер_порта), где имя_компьютера - имя или IP-адрес компьютера с целевым администратором очередей и номер_порта - порт, используемый обработчиком целевого администратора очередей.

[UNIX, Linux, Windows]Не указывайте это свойство для кластерных каналов получателя на платформах Windows и UNIX и Linux®, которые используют протокол TCP/IP; IBM MQ создает имя, используя значение порта по умолчанию и текущий адрес системы в формате IPv4. В отсутствие адреса IPv4 у системы применяется текущий адрес IPv6 системы. Для кластерных каналов получателя на других платформах и для кластерных каналов получателя, не использующих протокол передачи TCP/IP указывается имя компьютера с локальным администратором очередей.

CONNAME
Очередь передачи Указывается имя очереди передачи, которая соответствует администратору очередей на принимающей стороне канала. XMITQ
Локальный адрес соединения Если канал использует TCP/IP и требуется, чтобы этот канал использовал конкретный IP-адрес, порт или диапазон портов для исходящих соединений, введите локальный адрес соединения для этого канала. Канал подключается к адресу локально. Используйте формат ip-адрес(нижний-порт, верхний-порт), где ip-адрес - IP-адрес, представленный в десятичном с точками формате IPv4, шестнадцатеричном IPv6 или алфавитно-цифровом формате имени хоста. Например, 192.0.2.0 определяет адрес IPv4 с любым портом; 192.0.2.0(1000) определяет адрес IPv4 с конкретным портом; 192.0.2.0(1000,2000) определяет адрес IPv4 и диапазон портов; (1000) определяет только порт.

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

LOCLADDR
 

Кластерные каналы получателя: Не вводите IP-адрес в поле Локальный адрес соединения кластерного канала получателя, если не все администраторы очередей находятся на одном компьютере. Это связано с тем, что любой администратор очередей, который пытается соединиться с каким-то администратором очередей с использованием IP-адреса в поле Локальный адрес соединения своего кластерного канала получателя помещает эти значения в их автоматически определенные кластерные каналы отправителя. Однако можно ввести номер порта или диапазон портов в поле Локальный адрес соединения кластерного канала получателя, если нужно, чтобы все администраторы очередей в кластере использовали некоторый конкретный порт или диапазон портов для всех их исходящих соединений.

 
Общее состояние канала Только для чтения. Это состояние канала. STATUS

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

В следующей таблице приведены свойства со страницы Расширенные окна Свойства каналов, которые можно задавать.

Свойство Назначение Параметр MQSC
Максимальная длина сообщения Задается максимальная длина сообщения, которое можно передать по каналу:
  • Для следующих платформ значение должно превышать или равняться нулю и должно быть меньше или равно максимальной длине сообщения администратора очередей:
    • [AIX]AIX
    • [IBM i]IBM i
    • [Windows]Windows
    • VSE/ESA
  • На других платформах это значение должно лежать в диапазоне 0 - 4194304 байт.
  • [z/OS]В IBM MQ для z/OS это значение должно лежать в диапазоне 0 - 104857600 байт.
MAXMSGL
Интервал пульса Укажите продолжительность периодического сигнала в диапазоне 0 - 999999. Нулевое значение означает запрет обмена периодическими сигналами. Это значение должно быть меньше значения свойства Интервал отсоединения. Выбирается наибольшее среди значений, указанных на передающей и принимающей сторонах. Интервал между периодическими сигналами - это время в секундах между периодическими потоками от передающего MCA, когда в очереди передачи нет сообщений. Обмен тактами предоставляет принимающему MCA возможность приостановить канал. HBINT
Максимальное число экземпляров

Этот параметр используется в каналах соединений с сервером и каналах AMQP. Максимальное число экземпляров определяет максимальное число одновременно существующих экземпляров отдельного канала соединения с сервером или канала AMQP.

Укажите число в диапазоне 0 - 999999999. Значение по умолчанию: 999999999

Нулевое значение означает, что доступ всем клиентам запрещен.

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

Если клиент подключается через канал AMQP с ИД, который уже подключен (то есть выполняет передачу управления клиента); передача управления будет успешной вне зависимости от того, достигло ли число подключенных клиентов значения MAXINST.

MAXINST
Максимальное число экземпляров клиента

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

Укажите число в диапазоне 0 - 999999999. Значение по умолчанию: 999999999

Нулевое значение означает, что доступ всем клиентам запрещен.

Максимальное число экземпляров отличается от Максимальное число экземпляров клиента тем, что Максимальное число экземпляров - это максимальное число соединений, а Максимальное число экземпляров клиента - - это максимальное число подключений к серверу для отдельного клиента.

MAXINSTC
Поддерживаемый интервал Укажите продолжительность поддерживаемого интервала в диапазоне 0 - 99999. Это свойство применяется только для типа передачи TCP или SPX. Значение свойства Поддержка TCP на странице Каналы окна свойств администратора очередей должно устанавливаться на Да.

[z/OS]Для администраторов очередей z/OS свойство Поддерживаемый интервал задает поддерживаемый интервал для отдельного канала.

[UNIX, Linux, Windows, IBM i]Для администраторов очередей на разных платформах свойство Поддерживаемый интервал используется только в том случае, если канал подключен к администратору очередей z/OS; для работы с функциями, предоставляемыми свойством Поддерживаемый интервал, установите для атрибута Поддерживаемый интервал значение Автоматический, чтобы применялось значение, основанное на согласованном тактовом интервале.

KAINT
Сброс порядкового номера Порядковый номер - это число сообщений, передаваемых через канал. Порядковый номер увеличивается при передаче каждого сообщения через канал.

[z/OS]Для z/OS с CICS введите максимальный номер в диапазоне 1 - 999999999, при достижении которого порядковый номер сообщения сбрасывается до 1.

Для всех остальных платформ введите максимальный номер в диапазоне 100 - 999999999, при достижении которого порядковый номер сообщения сбрасывается до 1.

Это значение должно быть достаточно большим, чтобы оно не появилось снова во время использования его предыдущим сообщением. На обоих концах канала при запуске должно быть одно и то же значение сброса порядкового номера; в противном случае возникнет ошибка.

SEQWRAP
Скорость для временных сообщений

Для указания того, чтобы временные сообщения на канале не передавались в пределах транзакции, выберите Быстрая. Это означает, что временные сообщения станут доступными для получения гораздо быстрее, чем если бы они были частью транзакции. Однако поскольку временные сообщения не являются частью транзакции, они могут быть потеряны, если, например, канал остановится во время передачи сообщений. Чтобы это не случалось, выберите Стандартная. NPMSPEED
Размер пакета Задается максимальное число передаваемых сообщений до принятия syncpoint. Сообщения всегда передаются отдельно, но фиксируются или отклоняются пакетами. Попробуйте использовать размер пакета по умолчанию 50 и измените значение только при необходимости. BATCHSZ
Сжатие сообщений Нажмите кнопку Изменить, чтобы открыть окно Изменить сжатие сообщений. Выберите методы сжатия сообщений, которые поддерживаются определением канала, в порядке предпочтения. Будет применяться первый метод, который поддерживается другим концом канала. Нет означает, что сжатие сообщений не выполняется; RLE означает, что сжатие текстов сообщений выполняется с помощью кодирования без повторов; ZLIBFAST означает, сжатие текстов сообщений выполняется с помощью метода сжатия zlib и выбирается быстрое время сжатия; ZLIBHIGH означает, что сжатие ntrcnjd сообщений выполняется с помощью метода сжатия zlib и выбирается высокий уровень сжатия; ЛЮБОЙ означает, что может использоваться любой метод, поддерживаемый администратором очередей. Дополнительные сведения можно найти в разделе Распределенные очереди и кластеры в IBM Knowledge Center. COMPMSG
Сжатие заголовков Нажмите кнопку Изменить, чтобы открыть окно Изменить сжатие заголовков. Выберите методы сжатия заголовков, которые поддерживаются определением канала, в порядке предпочтения. Будет применяться первый метод, который поддерживается другим концом канала. Нет означает, что сжатие заголовков не выполняется; Системный означает, что сжатие заголовков выполняется. Дополнительные сведения можно найти в разделе Распределенные очереди и кластеры в IBM Knowledge Center. COMPHDR
Пакетный интервал Введите время в миллисекундах (0 - 999999999), в течение которого канал сохраняет пакет открытым даже в том случае, если в очереди передачи отсутствуют сообщения. BATCHINT
Ограничение размера пакета Укажите ограничение объема данных (0 - 999999 килобайт), передаваемых по каналу перед точкой синхронизации. Нулевое значение указывает, что объем данных пакетов, передаваемых по этому каналу, не ограничен. BATCHLIM
Время отсоединения Введите время в секундах (0 - 999999) до закрытия канала после завершения передачи пакета. Значение 0 означает, что канал не отключается. DISCINT
Преобразование данных Для задания преобразования сообщения принимающим приложением в формат, требуемый принимающей системой (это стандартный способ), выберите Нет; если удаленный администратор очередей работает на платформе, которая не поддерживает преобразование данных, выберите Да для задания преобразования сообщения перед передачей в формат, требуемый принимающей системой. CONVERT
Определение прав доступа Это свойство определяет тип обработки защиты, применяемой агентом канала сообщений (MCA) при выполнении команды MQPUT для целевой очереди или вызова MQI. Для применения ИД пользователя по умолчанию выберите По умолчанию; для применения другого ИД пользователя из контекстной информации сообщения выберите Контекст. PUTAUT
Тактовый интервал для пакетов

Если канал отправителя обменивался данными с каналом получателя в течение интервала контрольного сигнала пакета, то предполагается, что канал получателя все еще активен; в противном случае для проверки канала получателя отправляется контрольный сигнал. Передающая сторона канала ожидает ответа от принимающей стороны канала в течение времени, указанного в свойстве Интервал контрольного сигнала (HBINT).

Если принимающая сторона канала неактивна, то пакет может быть отклонен, а не стать сомнительным. При отклонении пакета сообщения остаются доступными для обработки и, например, могут быть отправлены по другому каналу. Введите время в секундах (0 - 999999), в течение которого передающая сторона канала должна ожидать ответа от принимающей стороны канала, перед тем как предположить, что принимающая сторона канала неактивна.

Значение 0 означает, что тактирование для пакетов не применяется. Дополнительная информация приведена в разделе Настройка канала, позволяющая уменьшить вероятность его перехода в состояние 'под вопросом'.

BATCHHB
Размещение канала по умолчанию При выполнении команды START CHANNEL без ключевого слова размещения канала (CHLDISP) канал запускается с использованием значения размещения канала по умолчанию (DEFCDISP). Возможны следующие три значения:

Частный. Это значение по умолчанию. Канал запускается как частный для локального администратора очередей.

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

Фиксированный общий. Отправляющий канал является общим, если для его очереди передачи указано размещение SHARED, а для CONNAME задано не пустое значение.
DEFCDISP
Управляющее свойство

(Только для каналов отправителя, каналов серверов, кластерных каналов отправителя и кластерных каналов получателя)

Указывает действия над сообщениями, которые будут отправлены к администратору очередей IBM WebSphere MQ 6.0 или более ранней версии. Для сохранения поведения IBM WebSphere MQ 6.0 относительно включения RFH2 в вызов, необходимо изменить значение с Совместимость на Все. Возможны значения:

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

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

Если сообщение содержит свойство с префиксом mcd., jms., usr. или mqext., то все дополнительные свойства сообщения (где значением поддержки является MQPD_SUPPORT_OPTIONAL), кроме находящихся в дескрипторе сообщения (или расширении), будут помещены в один или несколько заголовков MQRFH2 в тексте сообщения перед передачей сообщения удаленному администратору очередей. В противном случае все свойства сообщения, за исключением свойств из дескриптора (или расширения) сообщения, удаляются из сообщения перед передачей его удаленному администратору очередей.

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

Нет означает, что все свойства сообщения, за исключением свойств из дескриптора (или расширения) сообщения, удаляются из сообщения перед передачей его удаленному администратору очередей. Если сообщение содержит свойство, в котором поле поддержки дескриптора свойств не задано как MQPD_SUPPORT_OPTIONAL, то сообщение будет отклонено и обработано в соответствии с его опциями сообщения.

PROPCTL
Совместное использование диалогов

(Только каналы соединения с сервером и каналы соединения с клиентом)

Задает максимальное число общих диалогов для определенного интерфейса канала клиента TCP/IP (сокета). Возможны значения:
0: Позволяет запретить совместное использование диалогов в сокете TCP/IP. Экземпляр канала выполняет следующие функции в режиме до IBM WebSphere MQ 7.0:
  • Остановка-приостановка администратора
  • Отправка периодического сигнала
  • Опережающее чтение

1: Позволяет запретить совместное использование диалогов в сокете TCP/IP. Доступны задание пульса клиента и опережающее чтение (в вызове MQGET или нет), приостановка канала - более управляемый вариант.

2 - 999999999: Число общих диалогов. Значение по умолчанию: 10.

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

Порядковый номер, указывающий на ожидающий обработки запрос команды RESET CHANNEL. Нулевое значение указывает на отсутствие ожидающих обработки команд RESET CHANNEL. Укажите число в диапазоне 1 - 999999999.

Если значение RESETSEQ равно 0, то команда DISPLAY CHANNEL возвращает RESETSEQ(NO).

RESETSEQ
Использовать очередь недоставленных сообщений

(Не для каналов соединений с клиентами, Все каналы соединений с сервером, Каналы телеметрии)

Позволяет разрешить или запретить применение очереди недоставленных сообщений, если каналам не удалось доставить сообщения. Возможные значения:
  • Нет указывает, что в случае неудачной попытки доставки сообщений по каналу возникает ошибка и канал завершает работу в соответствии со значением параметра Скорость временных сообщений или отклоняет сообщение.
  • Значение Да указывает, что применяется имя очереди недоставленных сообщений из свойства Очередь отклоненных сообщений администратора очередей. В противном случае применяется значение Нет.
USEDLQ
Порт

(только каналы AMQP)

Порт для соединения AMQP. Порт по умолчанию для соединений AMQP 1.0: 5672. Если порт 5672 уже занят, можно указать другой порт. PORT
Использовать ИД клиента

(только каналы AMQP)

Указывает, что ИД клиента используется для соединения через канал AMQP. Значения: Да или Нет. USECLTID
Поддерживаемый интервал AMQP

(только каналы AMQP)

Задает поддерживаемый интервал в миллисекундах. Если клиент AMQP не отправил ни одного кадра в течение поддерживаемого интервала, то соединение закрывается с кодом ошибки AMQP amqp:resource-limit-exceeded. AMQPKA
Корневой каталог темы

(только каналы AMQP)

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

Значение свойства TPROOT по умолчанию: SYSTEM.BASE.TOPIC. Если указано значение по умолчанию, то в строке темы, применяемой клиентом AMQP для публикации и подписки, отсутствует префикс и клиент может обмениваться сообщениями с другими приложениями публикации/подписки MQ.

TPROOT
[V9.2.0, июль 2020][z/OS]Защита с помощью стратегии защиты Параметр определяет поведение агента канала сообщений при получении сообщений из очереди передачи или при отправке в целевую очередь в терминах применяемых стратегий защиты AMS.
Применимо для каналов с типом отправитель, сервер, получатель и инициатор. Возможны значения:
Сквозная передача
Сквозная пересылка в неизмененном виде любых сообщений, отправленных или полученных агентом канала сообщений для данного канала.
Это значение применимо для каналов с типом отправитель, сервер, получатель или инициатор и является значением по умолчанию.
Удалить
Удалить любую защиту AMS из сообщений, полученных из очереди передачи агентом канала сообщений, и отправить сообщения партнеру.
При получении в MCA сообщения из очереди передачи, для которой определена стратегия AMS, эта стратегия применяется для удаления защиты AMS из сообщения перед его отправкой в канал. Если стратегия AMS не определена для очереди передачи, сообщение отправляется без изменений.
Значение применимо только к каналам с типом отправитель и сервер.
В соответствии со стратегией
Перед отправкой входящего сообщения в целевую очередь к этому сообщению применяется защита AMS в соответствии со стратегией, определенной для целевой очереди.
Если для целевой очереди определена стратегия AMS, то к сообщению, полученному агентом канала сообщений защита, перед его отправкой в целевую очередь применяется защита AMS. Если стратегия AMS не определена для целевой очереди, сообщение отправляется без изменений.
Значение применимо только к каналам с типом получатель и инициатор.
SPLPROT

Страница MCA

В следующей таблице приведены свойства со страницы MCA окна Свойства канала. Свойства на странице MCA позволяют настроить агента канала сообщений (MCA) для данного канала.

Свойство Назначение Параметр MQSC
ИД пользователя MCA Идентификатор пользователя агента канала сообщений. Ненулевое значение задает идентификатор пользователя, от имени которого агент канала сообщений обращается к ресурсам IBM MQ, включая (если для параметра PUTAUT указано значение DEF) права на добавление сообщений в целевую очередь для канала получателя или отправителя.
Если значение не указан, то агент канала сообщений применяет ИД пользователя по умолчанию. Идентификатор пользователя по умолчанию определяется с учетом ИД пользователя, запустившего принимающий канал. Возможны значения:
  • [z/OS](z/OS) ИД пользователя, присвоенный задаче инициатора канала таблицей запущенных процедур z/OS.
  • Для TCP/IP, для платформ, отличных от z/OS, ИД пользователя из записи inetd.conf или ИД пользователя, запустившего получатель запросов.
  • Для SNA, для платформ, отличных от z/OS, ИД пользователя из записи сервера SNA или, в случае его отсутствия, входящий запрос подключения или ИД пользователя, запустившего получатель запросов.
  • (NetBIOS или SPX) ИД пользователя, запустившего получатель запросов.
Максимальная длина строки:
  • [Windows]64 символа в Windows.

    [V9.2.0, июль 2020]Для каналов с параметром CHLTYPE AMQP, в версиях ниже IBM MQ 9.1.1, настройка ИД пользователя MCAUSER поддерживается только для ИД длиной не более 12 символов. Начиная с версии IBM MQ 9.1.1 Continuous Delivery и версии IBM MQ 9.2.0 Long Term Support, ограничение длины не применяется.

  • 12 символов в системах, отличных от Windows.

[Windows]В системе Windows в качестве спецификатора имени пользователя можно указать имя домена в формате пользователь@домен.

MCAUSER
Тип MCA Для указания того, что программа агента канала сообщения (MCA) должна работать как нить, выберите Нить; для того чтобы программа MCA работала как процесс, выберите Процесс. MCATYPE
Имя MCA Только для чтения. Это свойство изменять нельзя, поскольку имя MCA резервируется и должно задаваться только пробелами. MCANAME

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

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

Свойство Назначение Параметр MQSC
Имя программы выхода по передаче Нажмите кнопку Изменить, чтобы открыть окно Изменить имя точки выхода отправки. Добавьте имена своих программ выхода по передаче:
  • [Linux][UNIX]В системе UNIX и Linux введите имена программ выхода. Максимальная общая длина всех имен вместе не должна превышать 999 символов. Используйте формат имя-библиотеки(имя-функции), для которого максимальное число символов в имени составляет 128.
  • [Windows]В системе Windows введите имена одной или нескольких программ. Максимальная общая длина всех имен вместе не должна превышать 999 символов. Используйте формат имя-dll(имя-функции), для которого максимальное число символов в имени составляет 128.
  • [IBM i]В IBM i можно указать до 10 программ. Используйте формат имя-программы имя-библиотеки, где имя-программы занимает первые 10 символов, а имя-библиотеки - вторые 10 символов. Добавьте пробелы в конец имен, чтобы их длина была ровно 10 символов.
  • [z/OS]В системе z/OS можно указать до 8 программ. Используйте имя модуля загрузки, максимальное число символов в имени которого равно 8.
  • На других платформах можно указать имя только одной программы выхода по передаче для каждого канала.
SENDEXIT
Пользовательские данные программы выхода по передаче Вводятся данные (максимум 32 символа), передаваемые для выхода по передаче для канала при вызове программы выхода по передаче:
  • [UNIX, Linux, Windows]В системах Windows и UNIX и Linux введите данные для одной или нескольких программ. Разделяйте данные запятыми. Максимальная общая длина поля составляет 999 символов.
  • [IBM i]В IBM i введите до 10 строк данных, каждая строка длиной 32 символа. Первая строка данных передается первому выходу по передаче, вторая строка - второму и т. д.
  • [z/OS]В системе z/OS введите до 8 строк данных, каждая строка длиной 32 символа. Первая строка данных передается первому выходу по передаче, вторая строка - второму и т. д.
  • На других платформах можно задать только одну строку данных выхода по передаче для каждого канала.
SENDDATA
Имя программы выхода по приему Нажмите кнопку Изменить, чтобы открыть окно Изменить имя точки выхода приема. Добавьте имена своих программ выхода по приему:
  • [UNIX, Linux, Windows]В системе UNIX и Linux введите имена программ выхода. Максимальное общее число символов во всех именах вместе не должна превышать 999 символов. Используйте формат имя-библиотеки(имя-функции), для которого максимальное число символов в строке составляет 128.
  • [Windows]В системе Windows введите имена одной или нескольких программ. Разделяйте имена запятыми. Максимальная общая длина поля составляет 999 символов. Используйте формат имяdll(имяфункции), для которого максимальное число символов в строке составляет 128.
  • [Windows]В Windows можно указать до 10 программ. Разделяйте имена запятыми. Используйте формат имя-программы имя-библиотеки, где имя-программы занимает первые 10 символов, а имя-библиотеки - вторые 10 символов. Добавьте пробелы в конец имен, чтобы их длина была ровно 10 символов.
  • [z/OS]В системе z/OS можно указать до 8 программ. Разделяйте имена запятыми. Используйте имя модуля загрузки, максимальное число символов в котором равно 8.
  • На других платформах можно указать имя только одной программы выхода по передаче для каждого канала.
RCVEXIT
Пользовательские данные программы выхода по приему Введите данные (максимум 32 символа), передаваемые в программу выхода по приему для канала при вызове:
  • [UNIX, Linux, Windows]В системах Windows и UNIX и Linux введите данные для одной или нескольких программ. Разделяйте данные запятыми. Максимальная общая длина поля составляет 999 символов.
  • [IBM i]В IBM i введите до 10 строк данных, каждая строка длиной 32 символа. Первая строка данных передается первому выходу по приему, вторая строка - второму и т. д.
  • [z/OS]В системе z/OS введите до 8 строк данных, каждая строка длиной 32 символа. Первая строка данных передается первому выходу по приему, вторая строка - второму и т. д.
  • На других платформах можно задать только одну строку данных выхода по приему для каждого канала.
RCVDATA
Имя защитной программы выхода Введите имя защитной программы выхода:
  • [UNIX, Linux, Windows]В системе UNIX и Linux используйте формат имя-библиотеки(имя-функции), для которого максимальное число символов в строке составляет 128.
  • [IBM i]В IBM i используйте формат имя-программы имя-библиотеки, где имя-программы занимает первые 10 символов, а имя-библиотеки - вторые 10 символов. Добавьте пробелы в конец имен, чтобы их длина была ровно 10 символов.
  • [z/OS]В системе z/OS используется имя загрузочного модуля. Максимальная длина имени составляет 8 символов.
SCYEXIT
Пользовательские данные защитной программы выхода Введите данные (максимум 32 символа), передаваемые в защитную программу выхода для канала при вызове. SCYDATA
Имя программы выхода по сообщению Нажмите кнопку Изменить, чтобы открыть окно Изменить имя точки выхода сообщений. Добавьте имена своих программ выхода по сообщению:
  • [UNIX, Linux, Windows]В системе UNIX и Linux введите имена программ выхода. Максимальная общая длина всех имен вместе не должна превышать 999 символов. Используйте формат имя-библиотеки(имя-функции), для которого максимальное число символов в имени составляет 128.
  • [Windows]В системе Windows введите имена одной или нескольких программ. Максимальная общая длина всех имен вместе не должна превышать 999 символов. Используйте формат имя-dll(имя-функции), для которого максимальное число символов в имени составляет 128.
  • [IBM i]В IBM i можно указать до 10 программ. Используйте формат имя-программы имя-библиотеки, где имя-программы занимает первые 10 символов, а имя-библиотеки - вторые 10 символов. Добавьте пробелы в конец имен, чтобы их длина была ровно 10 символов.
  • [z/OS]В системе z/OS можно указать до 8 программ. Используйте имя модуля загрузки, максимальное число символов в имени которого равно 8.
  • На других платформах можно указать имя только одной программы выхода по сообщению для каждого канала.
MSGEXIT
Пользовательские данные программы выхода по сообщению Вводятся данные (максимум 32 символа), передаваемые для выхода по сообщению для канала при вызове программы выхода по сообщению:
  • [UNIX, Linux, Windows]В системах Windows и UNIX и Linux введите данные для одной или нескольких программ. Разделяйте данные запятыми. Максимальная общая длина поля составляет 999 символов.
  • [IBM i]В IBM i введите до 10 строк данных, каждая строка длиной 32 символа. Первая строка данных передается первому выходу по сообщению, вторая строка - второму и т. д.
  • [z/OS]В системе z/OS введите до 8 строк данных, каждая строка длиной 32 символа. Первая строка данных передается первому выходу по сообщению, вторая строка - второму и т. д.
  • На других платформах можно задать только одну строку данных выхода по сообщению для каждого канала.
MSGDATA

Страница LU6.2

В следующей таблице приведены свойства со страницы LU6.2 окна Свойства канала. Если канал использует протокол передачи LU 6.2, настройте свойства на странице LU6.2.

Свойство Назначение Параметр MQSC
Имя режима Вводится имя режима LU 6.2, которым является имя режима SNA. Если значение свойства Имя соединения на странице Общие содержит побочный объект, то оставьте значение Имя режима пустым. Максимальная длина равна 8 символам. MODENAME
Имя TP Вводится имя или шаблон имени программы MCA, которая выполняется на дальнем конце соединения. TPNAME
ИД пользователя Вводится идентификатор пользователя, который использует MCA при попытке запуска сеанса с защитой LU 6.2 с удаленного MCA. Максимальная длина составляет 12 символов, но используются только первые 10. USERID
Пароль Выберите пункт Изменить пароль канала, затем в окне диалога Изменение пароля введите пароль, который MCA будет использовать при попытке запуска сеанса с защитой LU 6.2 с удаленного MCA. Максимальная длина равна 12 символам. PASSWORD

Страница Повторение

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

Свойство Назначение Параметр MQSC
Малое число повторений Укажите максимальное число попыток канала установить соединение с удаленным администратором очередей. Допустимые значения: 0 - 999999999 (1 - 999999999 для z/OS с CICS). SHORTRTY
Короткий интервал повторений Вводится приблизительный интервал в секундах между попытками канала установить соединение с удаленным администратором очередей при малом числе повторений. Значение 0 означает, что канал повторяет попытку сразу. SHORTTMR
Большое число повторений Введите максимальное число попыток (0 до 999999999) подключения канала к удаленному администратору очередей. Значение этого свойства используется, только когда число попыток, заданное в атрибуте Малое число повторений, исчерпано, но каналу еще не удалось установить соединение с удаленным администратором очередей. LONGRTY
Длинный интервал повторений Вводится приблизительный интервал в секундах между попытками канала установить соединение с удаленным администратором очередей при большом числе повторений. Значение 0 означает, что канал повторяет попытку сразу. LONGTMR
Поддерживаемый интервал Значение свойства Поддерживаемый интервал определяет значение тайм-аута для канала. Для того чтобы поддерживаемый интервал основывался на согласованном тактовом интервале, выберите Автоопределение. Если согласованный тактовый интервал больше нуля, то Поддерживаемый интервал равен согласованному тактовому интервалу плюс 60 секунд. Если согласованный тактовый интервал равен нулю, то Поддерживаемый интервал тоже равен нулю. Для того чтобы определить значение тайм-аута, введите время в секундах в диапазоне 0 - 99999. Значение 0 запрещает функцию KeepAlive на данном канале. KAINT

Страница Повторение сообщения

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

Свойство Назначение Параметр MQSC
Число повторений сообщения Введите число повторных попыток (0 - 999999999) отправки сообщения в удаленную очередь. Это свойство определяет действие MCA, только если свойство Имя выхода по повторениям сообщения имеет пустое значение. Если значение свойства Имя выхода по повторениям сообщения не пустое, то значение свойства Число повторений сообщения передается для использования программой выхода, но число попыток канала отправить сообщение определяется программой выхода, а не атрибутом Число повторений сообщения. MRRTY
Интервал повторения сообщения Вводится минимальное время в миллисекундах перед следующей попыткой канала поставить сообщение в удаленную очередь. MRTMR
Имя выхода по повторениям сообщения Вводится имя программы выхода по числу повторений сообщения каналом:
  • [Linux][UNIX]В системе UNIX и Linux используйте формат имя-библиотеки(имя-функции), для которого максимальное число символов в строке составляет 128.
  • [IBM i]В IBM i используйте формат имя-программы имя-библиотеки, где имя-программы занимает первые 10 символов, а имя-библиотеки - вторые 10 символов. Добавьте пробелы в конец имен, чтобы их длина была ровно 10 символов.
  • [z/OS]В системе z/OS используется имя загрузочного модуля. Максимальная длина имени составляет 8 символов.
MRDATA
Пользовательские данные выхода по повторениям сообщения Вводятся данные (максимум 32 символа), передаваемые для выхода по повторениям сообщения для канала при вызове программы выхода по повторениям сообщения. MREXIT

Страница Кластер

В следующей таблице приведены свойства со страницы Кластер окна Свойства канала. Свойства на странице Кластеры позволяют настроить совместное использование канала в одном или нескольких кластерах.
Прим.: Укажите свойства канала кластера для каналов приемников кластера в целевых администраторах очередей. Любые свойства, указанные для соответствующих каналов получателей кластера, как правило, игнорируются. См. Каналы кластеров в IBM Knowledge Center.
Свойство Назначение Параметр MQSC
Совместное использование в кластере запрещено Это опция по умолчанию, которое запрещает совместное использование канала в каком-либо кластере. Не применяется.
Совместное использование в кластере Выберите эту опцию, чтобы разрешить совместное использование канала в кластере, затем введите имя кластера. См. Строки в окнах свойств. CLUSTER
Совместное использование в списке кластеров Выберите эту опцию, чтобы разрешить совместное использование канала в нескольких кластерах, затем введите имя объекта списка имен с именами кластеров. См. Строки в окнах свойств. CLUSNL
Приоритет в сети Значение этого свойства отражает приоритет канала для сетевого соединения. Введите значение в диапазоне 0 - 9, где 0 - самый низкий приоритет. См. Атрибут канала NETPRTY в IBM Knowledge Center. NETPRTY
Ранг канала CLWL Введите ранг канала в кластере в диапазоне 0 - 9, где 0 - самый низкий ранг. См. Атрибут канала CLWLRANK в IBM Knowledge Center. CLWLRANK
Приоритет канала CLWL Введите приоритет канала в кластере в диапазоне 0 - 9, где 0 - самый низкий приоритет. См. Атрибут канала CLWLPRTY в IBM Knowledge Center. CLWLPRTY
Вес канала CLWL Задаваемый вес применяется к каналу для определения пропорциональной части сообщений, передаваемых через этот канал. Значение должно лежать в диапазоне 1 - 99; 1 - это наименьший вес. См. Атрибут канала CLWLWGHT в IBM Knowledge Center. CLWLWGHT

Страница SSL

В следующей таблице приведены свойства со страницы SSL окна Свойства канала. Свойства на странице SSL позволяют настроить канал на применение защиты SSL.

Свойство Назначение Параметр MQSC
CertificateLabel Метка сертификата для канала. С учетом метки выбирается личный сертификат из хранилища ключей для отправки удаленному узлу. Если оставить значение этого свойства пустым, то сертификат определяется с помощью свойства CertificateLabel администратора очередей. CERTLABL
CipherSpec Вводится имя (максимум 32 символа) CipherSpec для соединения TLS. Значение данного свойства должно быть одним и тем же на обоих концах определения канала SSL IBM MQ. За дополнительной информацией обратитесь к описанию свойства SSLCIPH в разделе DEFINE CHANNEL в IBM Knowledge Center.

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

SSLCIPH
Идентификация сторон, инициирующих соединения Для указания того, что канал должен получать и идентифицировать сертификат TLS от клиента TLS, выберите опцию Обязательна; для указания того, что каналу не нужно получать и идентифицировать сертификат TLS от клиента TLS, выберите опцию Необязательна. Когда выбрана опция Необязательна, и равноправный клиент TLS передает сертификат, канал идентифицирует этот сертификат как нормальный. SSLCAUTH
Имя издателя Фильтр отличительного имени издателя сертификата. Это поле содержит фильтр отличительного имени, которое должно совпадать с DN издателя личного сертификата удаленного узла. Имя издателя - это ключевое поле карты равноправных серверов SSL, применяемое для выбора записей прав доступа к каналу для входящих соединений. SSLCERTI
Принимаются только сертификаты с отличительными именами, совпадающими с задаваемыми значениями Введите значение отличительного имени в сертификате из парного администратора очередей или клиента на другом конце канала IBM MQ. При запуске канала значение этого свойства сравнивается с отличительным именем сертификата. SSLPEER
Принимаются только сертификаты с отличительными именами, совпадающими с задаваемыми значениями Эта запись идентификации канала позволяет связать отличительные имена (DN) TLS со значениями MCAUSER. Вместе с параметром SSLPEERMAP должен быть указан параметр SSLPEER. SSLPEERMAP

Страница Распределение нагрузки

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

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

Когда клиент запускает соединение в некоторой группой администраторов очередей с запросом MQCONN, указывая имя администратора очередей, начинающееся со звездочки, и в таблице определений каналов клиента (CCDT) доступны несколько подходящих определений каналов, одно из них выбирается случайно на основании веса с любым соответствующим определением CLNTWGHT(0), выбираемым первым в алфавитном порядке. Задайте значение в диапазоне от 0 до 99. Значение по умолчанию - 0. Значение 0 означает, что уравновешивание нагрузки не выполняется и соответствующие определения выбираются в алфавитном порядке. Для того чтобы разрешить уравновешивание нагрузки укажите значение между 1 и 99, где 1 - наименьший вес, а 99 - наибольший. Распределение сообщений между двумя или несколькими каналами с ненулевыми весами приблизительно пропорционально соотношению их весов.

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

ПРЕДПОЧТИТЕЛЬНЫЙ. Это значение по умолчанию. Первое соединение при чтении процессом таблицы определений каналов клиента (CCDT) создает список соответствующих определений на основании веса канала клиента со всеми определениями сначала с весом 0 и в алфавитном порядке. Каждое соединение в процессе пытается установить соединение с помощью первого определения в списке. Если соединение не выполняется, берется следующее определение. Неудачные определения со значениями весов каналов клиента, отличными от 0, перемещаются в конец списка. Определения с весом канала клиента 0 остаются в начале списка и выбираются первыми для каждого соединения. Каждый обслуживаемый процесс с одним и тем же именем хоста создает один и тот же список.

НЕТ. Первое соединение при чтении процессом CCDT создает список соответствующих определений. Все соединения в процессе выбирают соответствующее определение на основании веса канала клиента со всеми определениями сначала с весом 0 и в алфавитном порядке.

ПРИВЯЗКА

Страница Статистические данные

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

Свойство Назначение Параметр MQSC
Дата изменения Только для чтения. Дата последнего изменения свойств очереди. ALTDATE
Время изменения Только для чтения. Время последнего изменения свойств очереди. ALTTIME
Мониторинг канала Можно настроить IBM MQ для сбора данных интерактивного мониторинга текущего быстродействия канала. Для того чтобы значение свойства Мониторинг канала администратора очередей использовалось (см. Свойства администраторов очередей), выберите пункт Администратор очередей. Если значением свойства Мониторинг канала администратора очередей является Нет, то свойство Мониторинг канала игнорируется. Если значение свойства Мониторинг канала не равно Нет: для отмены настроек администратора очередей и запрещения сбора данных для канала выберите значение Выключен; для сбора данных с низкой частотой выберите Медленный; для сбора данных со средней частотой выберите Средний; для сбора данных с высокой частотой выберите Быстрый. MONCHL
Статистика канала IBM MQ можно настроить для сбора статистики о деятельности канала. Для того чтобы значение свойства Статистика канала администратора очередей использовалось (см. Свойства администратора очередей), выберите пункт Администратор очередей. Если значение свойства Статистика канала администратора очередей равно Нет, то свойство Статистика канала игнорируется. Если значение свойства Статистика канала не равно Нет, то для переопределения параметров администратора очередей и запрещения сбора данных для канала выберите значение Выключен, для сбора данных с низкой частотой выберите Медленный, для сбора данных со средней частотой выберите Средний, для сбора данных с высокой частотой выберите Быстрый. STATCHL