Propriedades de Mensagem

Atributos de mensagens são exibidos na caixa de diálogo Propriedades de mensagens. Não é possível editar nenhum dos atributos de mensagens.

As tabelas a seguir listam os atributos de mensagens do IBM® MQ que podem ser colocados e obtidos de filas:

Para cada atributo, há uma breve descrição de seu significado. As tabelas também mostram o formulário MQMD do nome, conforme usado na API. Isso é descrito em Visão Geral do MQMD na documentação on-line do produto IBM MQ.

Página Geral

A tabela a seguir lista os atributos na página Geral do diálogo Propriedades de Mensagem.

Atributo Significado Formulário do MQMD
Posição Somente leitura. A posição atual da mensagem na fila. (Não aplicável.)
Tipo da mensagem Somente leitura. Esse é o tipo da mensagem: Datagrama significa que a mensagem não requer uma resposta; Pedido significa que a mensagem requer uma resposta; Resposta significa que a mensagem é uma resposta para uma mensagem de pedido anterior; Relatório significa que a mensagem está relatando uma ocorrência esperada ou inesperada, em geral relacionada a uma outra mensagem. Por exemplo, uma mensagem de pedido que continha dados inválidos. MsgType
Prioridade Somente leitura. Essa é a prioridade da mensagem. A menor prioridade é 0. Prioridade
Persistence Somente leitura. Isso indica se a mensagem é persistente ou não persistente. Se a mensagem for persistente, ela sobreviverá às falhas de sistema e aos reinícios do gerenciador de filas. Se a mensagem for não persistente, ela sobreviverá a uma reinicialização apenas se estiver presente em uma fila que possui o atributo NPMCLASS(HIGH). No entanto, mesmo com o atributo NPMCLASS(HIGH), uma mensagem não sobrevive a uma classe QMGR. As mensagens não persistentes nas filas que possuem o atributo NPMCLASS(NORMAL) são descartadas na reinicialização do gerenciador de filas, mesmo que a mensagem esteja localizada no armazenamento auxiliar durante o procedimento de reinicialização. Persistência
Data/hora de colocação Somente leitura. Esta é a data de quando a mensagem foi colocada. PutDate; PutTime
Expiração Somente leitura. Esse é o período de tempo, em décimos de segundo, após o qual a mensagem se torna elegível para ser descartada se ela ainda não tiver sido removida da fila de destino. O intervalo de expiração é definido pelo aplicativo que gravou a mensagem. Expiração
Fila responder para Somente leitura. Esse é o nome da fila de mensagens para a qual o aplicativo que emitiu o pedido de obtenção da mensagem deve enviar as mensagens de resposta e relatório. ReplyToQ
Gerenciador de filas responder para Somente leitura. Esse é o nome do gerenciador de filas no qual a fila de resposta é definida. ReplyToQmgr
Contagem de backout Somente leitura. Esse é o número de vezes que a mensagem foi retornada anteriormente pela chamada MQGET como parte de uma unidade de trabalho e subseqüentemente restaurada. BackoutCount

Página Relatório

A tabela a seguir lista os atributos na página Relatório do diálogo Propriedades de Mensagem. Um relatório é uma mensagem sobre outra mensagem, utilizada para informar o aplicativo sobre eventos esperados ou não esperados que se relacionam à mensagem original. A página Relatório exibe os atributos relacionados às mensagens de relatório. Para obter mais informações, veja Opções de Relatório e Sinalizadores de Mensagem na documentação on-line do produto IBM MQ.

Atributo Significado Formulário do MQMD
Report Somente leitura. Este campo é onde o aplicativo emissor especifica se as mensagens de relatório são obrigatórias, se os dados do aplicativo devem ser incluídos nas mensagens de relatório e também como a mensagem e os identificadores de correlação na mensagem de relatório ou resposta devem ser definidos. Report
Feedback Somente leitura. Isso é utilizado apenas com mensagens de relatório para indicar a natureza do relatório. Feedback
Comprimento original Somente leitura. Isso é utilizado apenas com mensagens de relatório para indicar o comprimento da mensagem original à qual o relatório está relacionado. OriginalLength

Página Contexto

A tabela a seguir lista os atributos na página Contexto do diálogo Propriedades de Mensagem. A página Contexto exibe informações do aplicativo emissor sobre a mensagem.

Atributo Significado Formulário do MQMD
Identificador de usuário Somente leitura. Esse é o identificador do usuário do aplicativo que originou a mensagem. UserIdentifier
Tipo de aplicativo Somente leitura. Esse é o tipo de aplicativo que coloca a mensagem, por exemplo, CICS ou AIX. PutApplType
Colocar nome do aplicativo Somente leitura. Esse é o nome do aplicativo que coloca a mensagem. Esse nome poderá aparecer truncado. PutApplName
Dados de identidade de aplicativo Somente leitura. Essa é a informação definida pelo conjunto de aplicativos e que pode ser utilizada para fornecer informações sobre a mensagem ou seu originador. ApplIdentityData
Dados de origem de aplicativo Somente leitura. Essa é a informação definida pelo conjunto de aplicativos e que pode ser utilizada para fornecer informações adicionais sobre a origem da mensagem. ApplOriginData
Token de Contabilidade Somente leitura. Essa é a informação que permite ao aplicativo cobrar apropriadamente o trabalho feito como resultado da mensagem. AccountingToken

Página Identificadores

A tabela a seguir lista os atributos na página Identificadores do diálogo Propriedades de Mensagem. A página Identificadores exibe informações de identificação que são associadas à mensagem.

Atributo Significado Formulário do MQMD
Identificador de mensagem Somente leitura. Esse é o identificador de mensagem, que é utilizado para distinguir uma mensagem de outra. MsgId
Bytes do identificador de mensagem Somente leitura. Esse é o identificador da mensagem no formato de byte. MsgId
Identificador de correlação Somente leitura. Esse é o identificador de correlação, que o aplicativo pode utilizar para relacionar uma mensagem a outra ou para relacionar a mensagem a outro trabalho que o aplicativo está desempenhando. CorrelId
Bytes do identificador de correlação Somente leitura. Esse é o identificador de correlação no formato de byte. CorrelId
Identificador de grupo Somente leitura. Esse é o identificador do grupo, que é utilizado para identificar o grupo de mensagens específico ou a mensagem lógica à qual a mensagem física pertence. GroupId
Bytes do identificador de grupo Somente leitura. Esse é o identificador de grupo no formato de byte. GroupId

Página Segmentação

A tabela a seguir lista os atributos na página Segmentação do diálogo Propriedades de Mensagem. A página Segmentação exibe os atributos relacionados à segmentação de mensagens grandes.

Atributo Significado Formulário do MQMD
Número de seqüência lógica Somente leitura. Esse é o número de seqüência da mensagem lógica no grupo. Os números de sequência iniciam em 1 e são aumentados por 1 a cada nova mensagem lógica no grupo, até o máximo de 999.999.999. Uma mensagem física que não esteja em um grupo possui um número de seqüência 1. MsgSeqNumber
Offset Somente leitura. Esse é o deslocamento dos dados na mensagem física a partir do início da mensagem lógica. Offset
Sinalizadores Somente leitura. Esses são os sinalizadores da mensagem que especificam os atributos da mensagem ou controlam seu processamento. MsgFlags

Página Propriedades Nomeadas

A tabela a seguir lista os atributos na página Propriedades Nomeadas do diálogo Propriedades de Mensagem. A página Propriedades Nomeadas estará presente apenas quando você tiver selecionado Como Propriedades Nomeadas na página Propriedades de Mensagens do diálogo Preferências e se a mensagem selecionada possuir propriedades. As propriedades da mensagem, exceto aquelas contidas no descritor de mensagens ou extensão, devem ser representadas no painel Propriedades Nomeadas em pares de nome e valor, e as propriedades são removidas dos dados da mensagem.

A Opção MQGMO é MQGMO_PROPERTIES_IN_HANDLE; para obter informações adicionais sobre Opções de Mensagens de Obtenção relevantes, consulte Opções de Obtenção de Mensagens do MQ.

Para obter mais informações sobre o diálogo Preferências, consulte Configurando o MQ Explorer.

Atributo Significado
Nome Somente leitura. O nome da propriedade de mensagem.
Valor Somente leitura. Esse é o valor real da propriedade nomeada.

Página Propriedades de MQRFH2

A tabela a seguir lista os atributos na página Propriedades de MQRFH2 do diálogo Propriedades de Mensagem. Existem duas maneiras de tornar a página Propriedades MQRFH2 visível:
  • Selecione conforme uma estrutura MQRFH2 no corpo da mensagem na página Mensagens do diálogo Preferências.

    As propriedades da mensagem, exceto aquelas contidas no descritor de mensagens ou extensão, devem ser representadas nas Propriedades MQRFH2 e as propriedades permanecem nos dados da mensagem. A Opção MQGMO é MQGMO_PROPERTIES_FORCE_MQRFH2; para obter informações adicionais sobre as Opções de Mensagens de Obtenção relevantes, consulte Opções de Obtenção de Mensagens do MQ.

  • Selecione conforme uma estrutura MQRFH2 no corpo da mensagem compatível com o WebSphere MQ V6 na página Mensagens do diálogo Preferências. A página Propriedades MQRFH2 apenas estará visível, se a mensagem contiver uma propriedade com um prefixo mcd, jms, usr ou mqext

    Se a mensagem contiver uma propriedade com um prefixo mcd, jms, usr ou mqext, todas as propriedades da mensagem, exceto aquelas contidas no descritor de mensagens ou extensão, devem ser representadas no painel Propriedades MQRFH2 e as propriedades permanecem nos dados da mensagem. Caso contrário, todas as propriedades da mensagem, exceto as contidas no descritor de mensagens ou extensão, serão descartadas e não exibidas. A Opção MQGMO é MQGMO_PROPERTIES_IN_COMPATIBILITY; para obter informações adicionais sobre as Opções de Mensagens de Obtenção relevantes, consulte Opções de Obtenção de Mensagens do MQ.

Para obter mais informações sobre o diálogo Preferências, consulte Configurando o MQ Explorer.

Como a estrutura MQRFH2 é xml aninhado, a página Propriedades de MQRFH2 exibe as propriedades de MQRFH2 em uma visualização em árvore. Todas as propriedades com o mesmo sinônimo são agrupadas sob a árvore de sinônimos, que pode ser expandida para exibir todas as propriedades e reduzida para ocultar todas as propriedades.

Atributo Significado
Nome Somente leitura. O nome da propriedade de mensagem.
Valor Somente leitura. Esse é o valor real da propriedade nomeada.

Página Dados

A tabela a seguir lista os atributos na página Dados do diálogo Propriedades de Mensagem. A página Dados exibe os próprios dados da mensagem e as informações sobre o formato dos dados.

Atributo Significado Formulário do MQMD
Comprimento de dados De leitura. Esse é o comprimento da mensagem original. OriginalLength
Formato De leitura. Esse é o nome que o emissor da mensagem utilizou para indicar ao receptor a natureza dos dados na mensagem. Formato
Identificador do conjunto de caracteres codificados Somente leitura. Esse é o identificador do conjunto de caracteres codificados dos dados de caracteres nos dados da mensagem do aplicativo. CodedCharSetId
Codificação Somente leitura. Essa é a codificação numérica dos dados numéricos na mensagem. Esse valor não se aplica aos dados numéricos na própria estrutura do MQMD. Codificação
Dados da mensagem Somente leitura. Esses são os dados da mensagem em texto ASCII legível pelo usuário. (Não aplicável.)
Bytes de dados da mensagem Somente leitura. Esses são os dados da mensagem no formato hexadecimal. (Não aplicável.)

Página Cabeçalho de Devoluções

A tabela a seguir lista os atributos na página Cabeçalho de Devoluções do diálogo Propriedades da Mensagem. A página Cabeçalho de Devoluções só está presente quando a mensagem possui um cabeçalho de devoluções.

Atributo Significado Formulário do MQMD
Reason Isso identifica a razão pela qual a mensagem foi colocada na fila de devoluções (mensagem não entregue) em vez de na fila de destino original. Reason
Fila de destino O nome da fila de mensagens que foi o destino original da mensagem. DestQName
Gerenciador de filas de destino O nome do gerenciador de filas que foi o destino original da mensagem. DestQMgrName
Codificação original Isso especifica a codificação numérica dos dados que se seguem à estrutura MQDLH (normalmente, os dados da mensagem original); não se aplica aos dados numéricos na estrutura MQDLH propriamente dita. Codificação
CCSID Original Isso especifica o identificador do conjunto de caracteres dos dados que se seguem à estrutura MQDLH (normalmente, os dados da mensagem original); não se aplica aos dados de caractere na estrutura MQDLH propriamente dita. CodedCharSetId
Formato original Isso especifica o nome do formato dos dados que se seguem à estrutura MQDLH (normalmente, os dados da mensagem original). Formato
Tipo de aplicativo de gravação O tipo do aplicativo que gravou a mensagem. Essa é a parte do contexto original da mensagem. Para obter mais informações sobre contexto da mensagem, veja Contexto da Mensagem na documentação on-line do produto IBM MQ. PutApplType
Colocar nome do aplicativo O nome do aplicativo que colocou a mensagem na fila de devoluções. O formato do nome depende do atributo Tipo de Aplicativo de Gravação. Esse nome poderá aparecer truncado. PutApplName
Data de gravação A data em que a mensagem foi colocada na fila de devoluções. PutDate
Hora de gravação A hora em que a mensagem foi colocada na fila de devoluções. PutTime

Referência Referência

Feedback

Ícone de registro de data e hora Última atualização: Wednesday, 14 February 2018
http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.mq.explorer.doc/com.ibm.mq.explorer.doc/e_properties_message.htm