MQSubscription.NET class

Use MQSubscription to request that retained publications are sent to the subscriber. MQSubscription is a property of an MQTopic object opened for subscription.


Class

System.Object
        |
        └─ IBM.WMQ.MQBase
                |
                └─ IBM.WMQ.MQBaseObject
                        |
                        └─ IBM.WMQ.MQManagedObject
                                |
                                └─ IBM.WMQ.MQSubscription
public class IBM.WMQ.MQSubscription extends IBM.WMQ.MQManagedObject;


Properties

Access subscription properties using the MQManagedObject class; see Properties.


Methods

Access subscription Inquire, Set and Get methods using the MQManagedObject class; see Methods.

    public int RequestPublicationUpdate(int options);

    Throws MQException.

    Request an updated publication for the current topic. If the queue manager has a retained publications for the topic, they are sent to the subscriber.

    Before calling RequestPublicationUpdate, open a topic for subscription to obtain an MQSubscription object.

    Typically, open the subscription with the MQC.MQSO_PUBLICATIONS_ON_REQUEST option. If no wildcards are present in the topic string, then only one publication is sent as a result of this call. If the topic string contains wildcards, many publications might be sent. The method returns the number of retained publications that are sent to the subscription queue. There is no guarantee that this many publications are received, especially if they are non-persistent messages.

      options

        MQC.MQSRO_FAIL_IF_QUIESCING
        The method fails if the queue manager is in a quiescent state. On z/OS®, for a CICS® or IMS application, MQC.MQSRO_FAIL_IF_QUIESCING also forces the method to fail if the connection is in a quiescent state.

        MQC.MQSRO_NONE
        No options are specified.


Constructors

No Public constructor.

An MQSubscription object is returned in the SubscriptionReference property of an MQTopic object that is opened for subscription,

Call the RequestPublicationUpdate method. MQSubscription is a subclass of MQManagedObject. Use the reference to access the properties and methods of MQManagedObject.