Свойства сообщения

В окне Свойства сообщения отображаются свойства сообщения. Никакие из этих свойств не доступны для изменения.

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

Для каждого свойства приведено краткое описание его назначения. Таблицы также показывают форму MQMD имени, как она используется в API. См. раздел Обзор MQMD в IBM Knowledge Center.

Общие

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

Свойство Назначение Форма MQMD
Позиция Только для чтения. Текущая позиция сообщения в очереди. (Нет.)
Тип сообщения Только для чтения. Это тип сообщения: Дейтаграмма означает, что сообщение не требует ответа; Запрос означает, что сообщение требует ответа; Ответ означает, что сообщение является ответом на более ранее сообщение запроса; Отчет означает, что сообщение сообщает о некотором ожидаемом или неожиданном событии, обычно относящемся к другому сообщению. Например, сообщение-запрос, содержащее неверные данные. MsgType
Приоритет Только для чтения. Это приоритет сообщения. Самый низкий приоритет - это 0. Приоритет
Постоянство Только для чтения. Указывает, является ли сообщение постоянным или непостоянным. Постоянные сообщения сохраняются после сбоев системы и перезапуска администратора очередей. Непостоянные сообщения сохраняются после перезапуска только в том случае, если для очереди указано свойство NPMCLASS(HIGH). Однако даже при наличии свойства NPMCLASS(HIGH) сообщение не сохраняется в классе QMGR. Временные сообщения из очередей с атрибутом NPMCLASS(NORMAL) удаляются при перезапуске администратора очередей даже в том случае, если в ходе перезапуска сообщения расположены во внешней памяти. Постоянство
Дата/время размещения Только для чтения. Это дата, когда помещено сообщение. PutDate; PutTime
Срок действия Только для чтения. Это период времени в десятых долях секунды, после которого сообщение становится допустимым для отклонения, если оно еще не удалено из целевой очереди. Срок хранения устанавливается приложением, которое помещает сообщение. Срок действия
Очередь ответов Только для чтения. Это имя очереди сообщений, в которую приложение, разместившее запрос на получение сообщения, должно отправлять сообщения ответов и отчетов. ReplyToQ
Администратор очередей ответов Только для чтения. Это имя администратора очередей, в котором определена очередь ответов. ReplyToQmgr
Количество отклонений Только для чтения. Это количество раз, которое сообщение было предварительно возвращено вызовом MQGET и впоследствии отклонено. BackoutCount

Страница Отчет

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

Свойство Назначение Форма MQMD
Отчет Только для чтения. Это поле, в котором приложение отправителя указывает, требуются ли сообщения-отчеты, должны ли данные приложения включаться в сообщения-отчеты, и как должны устанавливаться сообщение и идентификаторы зависимости в сообщении отчета или ответе. Отчет
Комментарии Только для чтения. Используется только в сообщениях-отчетах для указания природы отчета. Комментарии
Исходная длина Только для чтения. Используется только в сообщениях-отчетах для указания длины первоначального сообщения, к которому относится отчет. OriginalLength

Страница Контекст

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

Свойство Назначение Форма MQMD
Идентификатор пользователя Только для чтения. Это идентификатор пользователя приложения, породившего сообщение. UserIdentifier
Тип приложения Только для чтения. Это тип приложения, отправившего сообщение, например CICS или AIX. PutApplType
Имя поместившего приложения Только для чтения. Это имя приложения, которое поместило сообщение. Это имя может показываться неполностью. PutApplName
Данные идентификатора приложения Только для чтения. Это информация, которая определена набором приложения и может быть использована для предоставления информации о сообщении или его отправителе. ApplIdentityData
Данные исходного приложения Только для чтения. Это информация, которая определена набором приложения и может быть использована для предоставления дополнительной информации об источнике сообщении. ApplOriginData
Маркер учетной записи Только для чтения. Это информация, которая позволяет приложению соответствующим образом оценить работу, выполненную в результате сообщения. AccountingToken

Страница Идентификаторы

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

Свойство Назначение Форма MQMD
Идентификатор сообщения Только для чтения. Это идентификатор сообщения, который используется для различения сообщений. MsgId
Байты идентификатора сообщения Только для чтения. Это идентификатор сообщения в двоичной форме. MsgId
Идентификатор зависимости Только для чтения. Это идентификатор зависимости, который приложение может использовать для соотнесения одного сообщения с другим, или для соотнесения сообщения с другой выполняемой приложением работой. CorrelId
Байты идентификатора зависимости Только для чтения. Это идентификатор зависимости в двоичной форме. CorrelId
Идентификатор группы Только для чтения. Это идентификатор группы, который используется для идентификации определенной группы сообщений или логического сообщения, к которому принадлежит физическое сообщение. GroupId
Байты идентификатора группы Только для чтения. Это идентификатор группы в двоичной форме. GroupId

Страница Разбиение

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

Свойство Назначение Форма MQMD
Логический порядковый номер Только для чтения. Это порядковый номер логического сообщения внутри группы. Порядковые номера начинаются с 1 и увеличиваются на 1 для каждого нового логического сообщения. Максимальное значение - 999999999. Физическое сообщение, которое не принадлежит группе, имеет порядковый номер 1. MsgSeqNumber
Смещение Только для чтения. Это смещение данных в физическом сообщении от начала логического сообщения. Смещение
Флаги Только для чтения. Это флаги сообщения, которые задают его свойства или управляют его обработкой. MsgFlags

Страница Именованные свойства

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

Опция MQGMO - MQGMO_PROPERTIES_IN_HANDLE, дополнительная информация о связанных опциях сообщений Get приведена в следующем разделе: Опции сообщений Get MQ.

Дополнительная информация об окне Параметры приведена в разделе Настройка MQ Explorer.

Свойство Назначение
Имя Только для чтения. Имя свойства сообщения.
Значение Только для чтения. Это фактическое значение именованного свойства.

Страница Свойства MQRFH2

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

    Свойства сообщения, за исключением тех, которые находятся в дескрипторе или расширении сообщения, должны быть представлены на панели Свойства MQRFH2, и свойства остаются в данных сообщения. Опция MQGMO - MQGMO_PROPERTIES_FORCE_MQRFH2, дополнительная информация о связанных опциях сообщений Get приведена в следующем разделе: Опции сообщений Get MQ.

  • Выберите как структуру MQRFH2 в теле сообщения, совместимую с WebSphere MQ V6 на странице Сообщения окна Параметры. Страница Свойства MQRFH2 будет показана только в том случае, если сообщение содержит свойство с префиксом mcd, jms, usr или mqext.

    Если сообщение содержит свойство с приставкой mcd., jms., usr. или mqext., все свойства сообщения, за исключением тех, которые находятся в дескрипторе или расширении сообщения, должны быть представлены на панели "Свойства MQRFH2", и свойства остаются в данных сообщения. В ином случае все свойства сообщения, за исключением тех, которые находятся в дескрипторе или расширении сообщения, отбрасываются и не отображаются. Опция MQGMO - MQGMO_PROPERTIES_IN_COMPATIBILITY, дополнительная информация о связанных опциях сообщений Get приведена в следующем разделе: Опции сообщений Get MQ.

Дополнительная информация об окне Параметры приведена в разделе Настройка MQ Explorer.

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

Свойство Назначение
Имя Только для чтения. Имя свойства сообщения.
Значение Только для чтения. Это фактическое значение именованного свойства.

Страница Данные

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

Свойство Назначение Форма MQMD
Длина данных Только для чтения. Это длина исходного сообщения. OriginalLength
Формат Только для чтения. Это имя, которое отправитель сообщения использует для того, чтобы указать получателю природу данных в сообщении. Формат
Закодированный идентификатор набора символов Только для чтения. Это закодированный идентификатор набора символов символьных данных в сообщении приложения. CodedCharSetId
Кодировка Только для чтения. Это кодировка чисел числовых данных в сообщении. Это значение не применяется к числовым данным самой структуре MQMD. Кодировка
Данные сообщения Только для чтения. Это данные сообщения в удобочитаемом текстовом виде. (Нет.)
Байты данных сообщения Только для чтения. Это данные сообщения в шестнадцатеричной форме. (Нет.)

Страница Заголовок недоставленного сообщения

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

Свойство Назначение Форма MQMD
Причина Определяет причину, по которой сообщение было помещено в очередь недоставленных сообщений вместо исходной целевой очереди. Причина
Целевая очередь Имя очереди сообщений, которая первоначально являлась назначением для сообщения. DestQName
Целевой администратор очередей Имя администратора очередей, который первоначально являлся назначением для сообщения. DestQMgrName
Исходная кодировка Указывает числовую кодировку данных структуры MQDLH (обычно данные из исходного сообщения). Она не применяется к числовым данным в самой структуре MQDLH. Кодировка
Исходный CCSID Указывает идентификатор набора символов данных структуры MQDLH (обычно данные из исходного сообщения). Она не применяется к символьным данным в самой структуре MQDLH. CodedCharSetId
Исходный формат Указывает имя формата данных структуры MQDLH (обычно данные из исходного сообщения). Формат
Тип поместившего приложения Тип приложения, которое поместило сообщение. Это часть исходного контекста сообщения. Дополнительная информация о контексте сообщения приведена в разделе Контекст сообщения в IBM Knowledge Center. PutApplType
Имя поместившего приложения Это имя приложения, которое поместило сообщение в очередь недоставленных сообщений. Формат имени зависит от свойства Тип поместившего приложения. Это имя может показываться неполностью. PutApplName
Дата помещения Это дата, когда сообщение помещено в очередь недоставленных сообщений. PutDate
Время помещения Это время, когда сообщение помещено в очередь недоставленных сообщений. PutTime