Mensajes de informes JMS

Las aplicaciones de JMS pueden utilizar mensajes de informe como forma de proceso de solicitudes/respuestas gestionado para proporcionar información remota a los productores sobre el resultado de sus operaciones de envío y el destino de sus mensajes.

Las aplicaciones JMS pueden solicitar los siguientes tipos de mensajes de informe estableciendo las propiedades y opciones de mensaje JMS_IBM_Report_Xxxx apropiadas. Las opciones tienen la misma sintaxis y significado general:
MQRO_report-type
Se genera un mensaje de informe del tipo indicado que contiene el MQMD del mensaje original. No contiene ningún dato del cuerpo del mensaje.
MQRO_report-type_WITH_DATA
Se genera un mensaje de informe del tipo indicado que contiene el MQMD, cabeceras MQ y 100 bytes de datos del cuerpo.
MQRO_tipo_informe_WITH_FULL_DATA
Se genera un mensaje de informe del tipo indicado que contiene todos los datos del mensaje original.

Utilice el prefijo siguiente con cada opción: com.ibm.websphere.sib.api.jms.

Por ejemplo, para solicitar un mensaje de informe de confirmación a la entrega (COD) con todos los datos la aplicación JMS debe establecer JMS_IBM_Report_COD en el valor com.ibm.websphere.sib.api.jms.MQRO_COD_WITH_FULL_DATA.

Tipo de mensaje de informe Descripción Propiedad y opciones del mensaje JMS_IBM_Report_Xxxx
Excepción Envía un mensaje de informe si el mensaje de solicitud no se puede poner en la cola de destino. Los mensajes de informe de excepción se generan cuando se ha redireccionado un mensaje a un destino de excepciones. JMS_IBM_Report_Exception
  • MQRO_EXCEPTION
  • MQRO_EXCEPTION_WITH_DATA
  • MQRO_EXCEPTION_WITH_FULL_DATA
Descartar Descarta el mensaje de solicitud original en lugar de enviarlo a un destino de excepciones.Puede utilizar esta opción con la propiedad JMS_IBM_Report_Exception establecida en MQRO_EXCEPTION_WITH_FULL_DATA para devolver un mensaje de solicitud que no puede entregarse a su emisor. JMS_IBM_Report_Discard_Msg
  • TRUE
  • FALSE
Caducidad Envía un mensaje de informe si el mensaje de solicitud supera su tiempo de caducidad. JMS_IBM_Report_Expiration
  • MQRO_EXPIRATION
  • MQRO_EXPIRATION_WITH_DATA
  • MQRO_EXPIRATION_WITH_FULL_DATA
Confirmación a la llegada (COA) Envía un mensaje de informe cuando el mensaje de solicitud se ha puesto en la cola de destino.

Para mensajería de publicación/suscripción, el mensaje de informe de COA se genera sólo en los motores de mensajería de productores. Por lo tanto, dichos informes son de interés sólo para suscripciones locales.

Para mensajería punto a punto, los mensajes de COA se generan cuando el mensaje llega al destino final. Para colas particionadas, el mensaje de informe se genera sólo cuando se ha comprometido la operación y se ha seleccionado, por lo tanto, un destino final. Cualquier opción de informe With_Data o With_Full_Data especificada se ignora; el mensaje de informe de COA sólo se ocupa de cabeceras de mensaje.

Si se utiliza una ruta de direccionamiento de reenvío, el mensaje de COA se genera cuando el mensaje llega al destino final de la ruta.

JMS_IBM_Report_COA
  • MQRO_COA
  • MQRO_COA_WITH_DATA
  • MQRO_COA_WITH_FULL_DATA
Confirmación a la entrega (COD) Envía un mensaje de informe cuando un consumidor de mensajes ha eliminado el mensaje de solicitud del espacio de cola o tema.

Para la mensajería de publicación/suscripción, el mensaje de COD se genera cuando todos los suscriptores han recibido el mensaje de solicitud. Por lo tanto, hay un mensaje de COD generado por cada COA. Cuando un suscriptor consume un mensaje, se reduce el contador de referencia del mensaje en el espacio de tema. Cuando el contador de referencia llega a cero, se elimina el mensaje del espacio de tema, entonces se genera un mensaje de informe de COD.

Para la mensajería punto a punto, el mensaje de COD se genera después de que la aplicación consumidora ha recibido correctamente el mensaje. Cualquier opción de informe With_Data o With_Full_Data especificada se ignora; el mensaje de informe de COD sólo se ocupa de cabeceras de mensaje.

JMS_IBM_Report_COD
  • MQRO_COD
  • MQRO_COD_WITH_DATA
  • MQRO_COD_WITH_FULL_DATA
Notificación de acción positiva (PAN) Solicita a la aplicación consumidora que envíe un mensaje de informe cuando se ha procesado correctamente el mensaje de solicitud. JMS_IBM_Report_PAN
  • TRUE
  • FALSE
Notificación de acción negativa (NAN) Solicita a la aplicación consumidora que envíe un mensaje de informe si no se ha procesado correctamente el mensaje de solicitud. JMS_IBM_Report_NAN
  • TRUE
  • FALSE
La aplicación solicitante puede controlar otros aspectos del mensaje de informe, como se detalla a continuación:
  • Cómo se genera el ID de mensaje para el mensaje de informe y cualquier mensaje de respuesta:
    MQRO_New_Msg_Id
    Este es el valor predeterminado. Se genera un nuevo ID de mensaje para el mensaje de informe.
    MQRO_Pass_Msg_Id
    El ID de mensaje del mensaje de informe se establece en el ID de mensaje del mensaje de solicitud.
  • Cómo se va a establecer el ID de correlación del informe o el mensaje de respuesta.
    MQRO_Copy_Msg_Id_To_Correl_Id
    Este es el valor predeterminado. El ID de correlación del mensaje de informe se establece en el ID de mensaje del mensaje de solicitud.
    MQRO_Pass_Correl_Id
    El ID de correlación del mensaje de informe se establece en el ID de correlación del mensaje de solicitud.

Para obtener más información acerca de los mensajes de informe y las propiedades y opciones asociadas, consulte la sección Mensajes de informes del Information Center de IBM MQ.


Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rmj_reports
File name: rmj_reports.html