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:
- Geral
- Relatório
- Contexto
- Identificadores
- Segmentação
- Propriedades Nomeadas
- Propriedades de MQRFH2
- Dados
- Cabeçalho de mensagem não entregue
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
- 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.
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 |