Mapeando os campos Relatório MQMD para as propriedades específicas ao provedor JMS

Os aplicativos JMS podem utilizar mensagens de relatório como forma de processamento gerenciado de pedido/resposta, para fornecer feedback remoto aos produtores sobre o resultado de suas operações de envio e o destino de suas mensagens. Os aplicativos JMS podem solicitar diferentes tipos de mensagem de relatório ao configurar as opções e propriedades de mensagem do JMS_IBM_Report_Xxxx.

Os aplicativos JMS podem solicitar os seguintes tipos de mensagem de relatório ao configurar as opções e propriedades de mensagem apropriadas do JMS_IBM_Report_Xxxx. As opções possuem a mesma sintaxe geral e significado:
MQRO_report-type
É gerada uma mensagem de relatório do tipo indicado que contém o MQMD da mensagem original do IBM MQ. Ela não contém qualquer dado do corpo da mensagem.
MQRO_report-type_WITH_DATA
É gerada uma mensagem de relatório do tipo indicado que contém o MQMD, quaisquer cabeçalhos MQ e 100 bytes de dados do corpo.
MQRO_report-type_WITH_FULL_DATA
É gerada uma mensagem de relatório do tipo indicado que contém todos os dados da mensagem original.

Use o seguinte prefixo com cada opção: com.ibm.websphere.sib.api.jms.

Por exemplo, para solicitar uma mensagem de relatório Confirmar na Entrega (COD) com dados completos, o aplicativo JMS deve definir JMS_IBM_Report_COD com o valor com.ibm.websphere.sib.api.jms.MQRO_COD_WITH_FULL_DATA.

Para cada tipo de mensagem, a seguinte tabela mostra a propriedade de mensagem JMS_IBM_Report_Xxxx que um aplicativo JMS pode configurar e as opções de campo do Relatório MQMD que são mapeadas para a propriedade.

Tipo de Mensagem de Relatório Description Propriedade e Opções de Mensagens do JMS_IBM_Report_Xxxx
Exceção Envie a mensagem de relatório se a mensagem de pedido não puder ser colocada na fila de destino. As mensagens de relatório de exceção são geradas quando uma mensagem tiver sido roteada novamente para um destino de exceção. JMS_IBM_Report_Exception
  • MQRO_EXCEPTION
  • MQRO_EXCEPTION_WITH_DATA
  • MQRO_EXCEPTION_WITH_FULL_DATA
Descartar Descarta a mensagem de solicitação original ao invés de enviá-la para um destino da exceção. É possível usar essa opção com a propriedade JMS_IBM_Report_Exception configurada para MQRO_EXCEPTION_WITH_FULL_DATA para retornar uma mensagem de solicitação não passível de entrega para o seu emissor. JMS_IBM_Report_Discard_Msg
  • TRUE
  • FALSE
Expiração Envie a mensagem de relatório se a mensagem de pedido ultrapassar seu tempo de expiração. JMS_IBM_Report_Expiration
  • MQRO_EXPIRATION
  • MQRO_EXPIRATION_WITH_DATA
  • MQRO_EXPIRATION_WITH_FULL_DATA
COA (Confirm On Arrival) Envie uma mensagem de relatório quando a mensagem de pedido tiver sido colocada na fila de destino.

Para o sistema de mensagens de publicação/assinatura, a mensagem de relatório COA é gerada apenas no mecanismo de sistema de mensagens dos produtores. Portanto, esses relatórios são relevantes apenas para assinaturas locais.

Para o sistema de mensagens ponto-a-ponto, as mensagens COA são geradas quando a mensagem chega ao destino final. Para filas particionadas, a mensagem de relatório é gerada apenas quando a operação de inserção tiver sido consolidada e, portanto, um destino final tiver sido selecionado. Quaisquer opções de relatório With_Data ou With_Full_Data especificadas são ignoradas; a mensagem de relatório COA trata apenas dos cabeçalhos da mensagem.

Se for utilizado um caminho de roteamento de encaminhamento, a mensagem COA será gerada quando a mensagem chegar ao destino final no caminho.

JMS_IBM_Report_COA
  • MQRO_COA
  • MQRO_COA_WITH_DATA
  • MQRO_COA_WITH_FULL_DATA
COD (Confirm On Delivery) Envie uma mensagem de relatório quando a mensagem de pedido tiver sido removida do espaço de filas ou de tópicos por um consumidor de mensagens.

Para o sistema de mensagens de publicação/assinatura, a mensagem COD será gerada quando todos os assinantes tiverem recebido a mensagem de pedido. Portanto, há uma mensagem COD gerada para cada COA. Quando uma mensagem é consumida por um assinante, a contagem de referência da mensagem no espaço do tópico é reduzida. Quando a contagem de referência atinge zero, a mensagem é removida do espaço de tópico e, em seguida, uma mensagem de relatório COD é gerada.

Para o sistema de mensagens ponto-a-ponto, a mensagem COD é gerada depois que a mensagem tiver sido recebida com êxito por um aplicativo de consumo. Quaisquer opções de relatório With_Data ou With_Full_Data especificadas são ignoradas; a mensagem de relatório COD trata apenas dos cabeçalhos da mensagem.

JMS_IBM_Report_COD
  • MQRO_COD
  • MQRO_COD_WITH_DATA
  • MQRO_COD_WITH_FULL_DATA
PAN (Positive Action Notification) Peça ao aplicativo consumidor para enviar uma mensagem de relatório quando tiver processado com êxito a mensagem de pedido. JMS_IBM_Report_PAN
  • TRUE
  • FALSE
NAN (Negative Action Notification) Peça ao aplicativo consumidor para enviar uma mensagem de relatório se não tiver processado com êxito a mensagem de pedido. JMS_IBM_Report_NAN
  • TRUE
  • FALSE
O aplicativo solicitante pode controlar outros aspectos da mensagem de relatório da seguinte maneira:
  • Como o ID de mensagem é gerado para a mensagem de relatório e qualquer mensagem de resposta:
    MQRO_New_Msg_Id
    Esse é o padrão. Um novo ID de mensagem é gerado para a mensagem de relatório.
    MQRO_Pass_Msg_Id
    O ID de mensagem para a mensagem de relatório é definido para o ID de mensagem da mensagem de pedido.
  • Como o ID de correlação da mensagem de relatório e de resposta deve ser definido.
    MQRO_Copy_Msg_Id_To_Correl_Id
    Esse é o padrão. O ID de correlação da mensagem de relatório é definido para o ID de mensagem da mensagem de pedido.
    MQRO_Pass_Correl_Id
    O ID de correlação da mensagem de relatório é definido para o ID de correlação da mensagem de pedido.

Para obter mais informações sobre as mensagens de relatório e as propriedades e opções associadas, consulte a seção Usando Java™ do centro de informações do WebSphere MQ, disponíveis a partir da Biblioteca do WebSphere MQ.


Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjc0009_
Nome do arquivo: rjc0009_.html