IBM Integration Bus, Version 10.0.0.5 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Delete Publication message

The Delete Publication command message is sent to an integration node from a publisher, or from another integration node, to tell the integration node to delete any retained publications for the specified topics.

This message is sent to the input queue of a message flow that contains a Publication node. You must have the authority to put a message onto this queue, and to publish on the topic, or topics, that are specified in the message.

The input queue should be the queue that the original publication was sent to.

If you have the authority for some, but not all, of the topics that are specified in the Delete Publication command message, only those topics are deleted. A Broker Response message indicates which topics are not deleted.

Similarly, if a Publish command contains more than one topic, a Delete Publication command matching some, but not all, of those topics deletes only the publications for the topics that are specified in the Delete Publication command.

Properties

<Command> (MQPSC_COMMAND)
The value is DeletePub(MQPSC_DELETE_PUBLICATION).

This property must be specified.

<Topic> (MQPSC_TOPIC)
The value is a string that contains a topic for which retained publications are to be deleted. Wildcard characters can be included in the string to delete publications on more than one topic.

This property must be specified; it can be repeated for as many topics as needed.

<DelOpt> (MQPSC_DELETE_OPTION)
The delete options property can take one of the following values:
Local (MQPSC_LOCAL)  

All retained publications for the specified topics are deleted at the local integration node (that is, the integration node to which this message is sent), whether they were published with the Local option or not.

Publications at other integration nodes are not affected.

None (MQPSC_NONE)  

All options take their default values. This has the same effect as omitting the DelOpt property. If other options are specified at the same time, None is ignored.

The default if this property is omitted is that all retained publications for the specified topics are deleted at all integration nodes in the network, regardless of whether they were published with the Local option.

Example

Here is an example of NameValueData for a Delete Publication command message. This is used by the sample application to delete, at the local integration node, the retained publication that contains the latest score in the match between Team1 and Team2.
 <psc>
  <Command>DeletePub</Command>
  <Topic>Sport/Soccer/State/LatestScore/Team1 Team2</Topic>
  <DelOpt>Local</DelOpt>
 </psc>

aq06960_.htm | Last updated 2016-06-25 08:08:09