El mensaje de mandato de publicación se envía de un publicador a un intermediario, o de un intermediario a un suscriptor, para publicar información sobre un tema o temas especificados.
Este mensaje se envía a la cola de entrada de un flujo de mensajes que contiene un nodo Publication. Es necesario tener autorización para colocar mensajes en esta cola y para publicar en el tema o temas especificados.
Si el usuario tiene autorización sobre alguno de los temas, pero no sobre todos, únicamente se publicarán los temas para los que esté autorizado; una respuesta de aviso indicará qué temas no se han publicado.
Si un suscriptor tiene alguna suscripción coincidente, el intermediario reenvía el mensaje de publicación a las colas de suscriptores definidas en los mensajes de mandato de registro de suscriptor correspondientes.
Consulte el apartado Mensaje de respuesta de intermediario para obtener información detallada de los parámetros del descriptor de mensaje (MQMD) necesarios cuando se envía un mensaje de mandato al intermediario y se utiliza cuando un intermediario reenvía una publicación a un suscriptor.
El intermediario reenvía el mensaje de publicación a otros intermediarios de la red que tengan suscripciones coincidentes, a menos que se trate de una suscripción local.
Los datos de la publicación, si los hay, se incluyen en el cuerpo del mensaje. Los datos pueden describirse en una carpeta <mcd> en el campo NameValueData de la cabecera MQRFH2.
Esta propiedad ha de especificarse.
Esta propiedad ha de especificarse y puede repetirse, opcionalmente, para tantos temas como se desee.
Esta propiedad no debe incluirse en un mensaje de publicación enviado al intermediario, pero el intermediario la añade automáticamente a los mensajes de publicación antes de enviarlo a los suscriptores correspondientes. El valor de la propiedad <SubPoint> (subpunto) es el valor del atributo de punto de suscripción del nodo Publication que maneja las publicaciones.
El intermediario ha de retener una copia de la publicación. Si no se ha establecido esta opción, la publicación se suprimirá tan pronto como el intermediario haya enviado la publicación a todos los suscriptores actuales.
(Sólo puede establecerla un intermediario.) Esta publicación la ha retenido el intermediario. El intermediario establece esta opción para notificar a un suscriptor que la publicación se publicó antes y se ha retenido, siempre y cuando la suscripción se haya registrado con la opción InformIfRetained (informar si se ha retenido). Se establece únicamente en respuesta a un mensaje de mandato de registro de suscriptor o de petición de actualización. Las publicaciones retenidas que se envían directamente a suscriptores no tiene establecida esta opción.
Esta opción indica al intermediario que esta publicación no ha de enviarse a otros intermediarios. Todos los suscriptores registrados en este intermediario reciben la publicación si tienen suscripciones coincidentes.
Esta opción permite el proceso más sencillo de aplicaciones de tipo conferencia, en las que un publicador es también suscriptor del mismo tema. Indica al intermediario que no envíe la publicación a la cola de suscriptores del publicador incluso si ésta tiene una suscripción coincidente. La cola de suscriptores del publicador está formada por su nombre de gestor de colas (QMgrName), nombre de cola (QName) e id de correlación (CorrelId) opcional, como se explica a continuación.
El CorrelId del MQMD (que no ha de ser cero) forma parte de la cola de suscriptores del publicador en aplicaciones donde el publicador es también un suscriptor.
Todas las opciones adoptan su valor por omisión. Esto surte el mismo efecto que omitir la propiedad de opciones de publicación. Si se especifican otras opciones simultáneamente, se ignora None.
El valor por omisión, si se omite esta propiedad, es que no se establece ninguna opción de publicación.
AAAAMMDDHHMMSSTH
y utiliza la Hora Universal. El intermediario no comprueba esta información antes de enviarla a los suscriptores.
Puede incrementarse en 1 con cada publicación. Sin embargo, el intermediario no comprueba esta operación y simplemente la transmite a los suscriptores.
Si se publican publicaciones sobre el mismo tema para distintos intermediarios conectados, es responsabilidad de los publicadores asegurarse de que los números de secuencia, si se utilizan, son significativos.
Si se omite esta propiedad, el valor por omisión es el nombre del gestor de la cola de respuestas (ReplyToQMgr) que hay en el descriptor del mensaje (MQMD). Si el nombre resultante está en blanco, se adopta por omisión el nombre del gestor de colas del intermediario.
Si se omite esta propiedad, el valor por omisión es el nombre de la cola de respuestas (ReplyToQ) en el descriptor del mensaje (MQMD), que no ha de estar en blanco si se ha establecido OtherSubsOnly.
A continuación puede ver algunos ejemplos de NameValueData para un mensaje de mandato de Publicación.
<psc> <Command>Publish</Command> <Topic>Sport/Soccer/Event/MatchStarted</Topic> </psc>
<psc> <Command>Publish</Command> <PubOpt>RetainPub</PubOpt> <Topic>Sport/Soccer/State/LatestScore/Team1 Team2</Topic> </psc>