Свойства сообщения
В окне Свойства сообщения отображаются свойства сообщения. Никакие из этих свойств не доступны для изменения.
В следующей таблице перечислены свойства сообщений IBM® MQ, которые можно поместить в очередь или извлечь из нее:
- Общие
- Отчет
- Контекст
- Идентификаторы
- Разбиение
- Именованные свойства
- Свойства MQRFH2
- Данные
- Заголовок недоставленных сообщений
Для каждого свойства приведено краткое описание его назначения. Таблицы также показывают форму 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, и свойства остаются в данных сообщения. Опция 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.
Поскольку структура 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 |