Propriedades de Mensagem

As propriedades da mensagem são exibidas no diálogo de propriedades da Mensagem. Não é possível editar nenhuma das propriedades da mensagem.

As tabelas a seguir listam as propriedades de mensagens do IBM® MQ que podem ser colocadas e obtidas das filas:

Para cada propriedade, há uma breve descrição de significado da propriedade. As tabelas também mostram o formulário MQMD do nome, conforme usado na API. Isso é descrito em Visão geral do MQMD na IBM Knowledge Center.

Página Geral

A tabela a seguir lista as propriedades na página Geral do diálogo de propriedades da Mensagem.

Propriedade 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 propriedade NPMCLASS(HIGH). No entanto, mesmo com a propriedade NPMCLASS(HIGH), uma mensagem não sobrevive a uma classe QMGR. As mensagens não persistentes em filas que têm a propriedade NPMCLASS(NORMAL) serão descartadas no reinício do gerenciador de filas, mesmo se a mensagem for 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 as propriedades na página Relatório do diálogo de propriedades da 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 as propriedades relacionadas a mensagens de relatório. Para obter mais informações, consulte Opções de relatório e sinalizações de mensagens na IBM Knowledge Center.

Propriedade 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 as propriedades na página Contexto do diálogo de propriedades da Mensagem. A página Contexto exibe informações do aplicativo emissor sobre a mensagem.

Propriedade Significado Formulário do MQMD
Identificador de usuários 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 as propriedades na página Identificadores do diálogo de propriedades da Mensagem. A página Identificadores exibe informações de identificação que são associadas à mensagem.

Propriedade 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 as propriedades na página Segmentação do diálogo de propriedades da Mensagem. A página Segmentação exibe as propriedades relacionadas à segmentação de mensagens grandes.

Propriedade 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. Estas são as sinalizações de mensagem que especificam propriedades da mensagem ou controlam seu processamento. MsgFlags

Página Propriedades Nomeadas

A tabela a seguir lista as propriedades na página Propriedades nomeadas do diálogo de Propriedades da 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.

Propriedade 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 as propriedades na página Propriedades MQRFH2 do diálogo de Propriedades da 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.

Propriedade 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 as propriedades na página Dados do diálogo de propriedades da Mensagem. A página Dados exibe os próprios dados da mensagem e as informações sobre o formato dos dados.

Propriedade Significado Formulário do MQMD
Comprimento de dados Somente leitura. Esse é o comprimento da mensagem original. OriginalLength
Formato Somente 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 as propriedades na página Cabeçalho de mensagens não entregues do diálogo de propriedades da Mensagem. A página Cabeçalho de Devoluções só está presente quando a mensagem possui um cabeçalho de devoluções.

Propriedade 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 o contexto da mensagem, consulte Contexto da Mensagem na IBM Knowledge Center. PutApplType
Colocar nome do aplicativo O nome do aplicativo que colocou a mensagem na fila de devoluções. O formato do nome depende da propriedade Put Application Type. 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