Mensagens de Relatório 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.
- MQRO_report-type
- É gerada uma mensagem de relatório do tipo indicado que contém o MQMD da mensagem original. 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.
Tipo de Mensagem de Relatório | Descrição | 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
|
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
|
Expiração | Envie a mensagem de relatório se a mensagem de pedido ultrapassar seu tempo de expiração. | JMS_IBM_Report_Expiration
|
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
|
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
|
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
|
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
|
- 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 informações adicionais sobre as mensagens de relatório e as opções e propriedades associadas, consulte a seção Mensagens de Relatório do centro de informações do IBM MQ.