Correlación de campos del informe MQMD con propiedades específicas del proveedor de 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. Una aplicación JMS puede solicitar diferentes tipos de mensajes de informe estableciendo propiedades y opciones de mensaje JMS_IBM_Report_Xxxx.
- MQRO_report-type
- Se genera un mensaje de informe del tipo indicado que contiene el descriptor de mensaje IBM MQ (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.
Para cada tipo de mensaje de informe, en la tabla siguiente se muestra la propiedad de mensaje JMS_IBM_Report_Xxxx que una aplicación JMS puede establecer y las opciones de campo de Informe MQMD que se correlacionan con la propiedad.
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
|
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
|
Caducidad | Envía un mensaje de informe si el mensaje de solicitud supera su tiempo de caducidad. | JMS_IBM_Report_Expiration
|
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
|
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
|
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
|
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
|
- 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 Uso de Java™ del Information Center de WebSphere MQ, disponible en la biblioteca de WebSphere MQ.