com.ibm.mq

Class MQSubscription

  1. java.lang.Object
  2. extended bycom.ibm.mq.jmqi.JmqiObject
  3. extended bycom.ibm.mq.MQManagedObject
  4. extended bycom.ibm.mq.MQSubscription
  1. public class MQSubscription
  2. extends MQManagedObject
MQSubscription is a helper object designed to encapsulate the HSUB reference. Under normal operating circumstances the user will not use or modify the object. It is a sub class of MQManagedObject and in this fashion can take advantage of the close features offered by the base class.

Field Summary

Fields inherited from class com.ibm.mq.MQManagedObject
alternateUserId, closeOptions, connectionReference, isOpen, name, openOptions
Fields inherited from class com.ibm.mq.jmqi.JmqiObject
COMP_JM, COMP_JN, COMP_JO

Method Summary

Modifier and Type Method and Description
  1. java.lang.String
 getAlternateUserId()
This property is not valid for an MQSubscription.
  1. java.lang.String
 getAttributeString(int aSelector,int length)
Although available on the MQManagedObject base class, this method has no relevance upon MQSubscription.
  1. java.lang.String
 getDescription()
This property is not valid for an MQSubscription.
  1. int
 getOpenOptions()
This property is not valid for an MQSubscription.
  1. void
 inquire(int[] selectors,int[] intAttrs,byte[] charAttrs)
Although available on the MQManagedObject base class, this method has no relevance upon MQSubscription.
  1. int
 requestPublicationUpdate(int options)
Requests an update publication to be sent for the current topic.
  1. void
 set(int[] selectors,int[] intAttrs,byte[] charAttrs)
Although available on the MQManagedObject base class, this method has no relevance upon MQSubscription.
  1. void
 setAttributeString(int aSelector,java.lang.String aValue,int length)
Although available on the MQManagedObject base class, this method has no relevance upon MQSubscription.
Methods inherited from class com.ibm.mq.MQManagedObject
close, getCloseOptions, getConnectionReference, getName, getResolvedObjectString, getResolvedQName, getResolvedType, inquire, isOpen, setCloseOptions
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

requestPublicationUpdate

  1. public int requestPublicationUpdate( int options)
  2. throws MQException
Requests an update publication to be sent for the current topic. This is normally used if the user specified the CMQC.MQSO_PUBLICATIONS_ON_REQUEST option. If the queue manager has a retained publication for the topic, this is sent to the subscriber.

The method returns the number of retained publications to be sent to the subscription queue or multicast address. There is no guarantee that this many messages will be available for the application to get, especially if they are non-persistent messages, or if the transport being used is multicast.

There may be more than one publication if the subscribed topic contained a wildcard. If no wildcards were present in the topic string when the subscription was made, then only one publication will be sent as a result of this call.

Parameters:
options - This parameter maps directly to the options field of the MQSRO structure. Any or none of the following options can be specified.
  • CMQC.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, this option also forces the method to fail if the connection is in a quiescent state.

  • CMQC.MQSRO_NONE

    If none of the options described above are required, this option can be used. Use this value to indicate that no other options have been specified.

Returns:
The number of retained publications to be sent to the subscription queue or multicast address.
Throws:
MQException - If the call fails.

inquire

  1. public void inquire(int[] selectors,
  2. int[] intAttrs,
  3. byte[] charAttrs)
  4. throws MQException
Although available on the MQManagedObject base class, this method has no relevance upon MQSubscription.
Overrides:
inquire in class MQManagedObject
Parameters:
selectors - Ignored as this method is not relevant to this class.
intAttrs - Ignored as this method is not relevant to this class.
charAttrs - Ignored as this method is not relevant to this class.
Throws:
MQException - if the inquire fails.
See Also:
MQManagedObject.inquire(int[], int[], byte[])

set

  1. public void set(int[] selectors,
  2. int[] intAttrs,
  3. byte[] charAttrs)
  4. throws MQException
Although available on the MQManagedObject base class, this method has no relevance upon MQSubscription.
Overrides:
set in class MQManagedObject
Parameters:
selectors - Ignored as this method is not relevant to this class.
intAttrs - Ignored as this method is not relevant to this class.
charAttrs - Ignored as this method is not relevant to this class.
Throws:
MQException - if the set call fails.
See Also:
MQManagedObject.set(int[], int[], byte[])

getAttributeString

  1. public java.lang.String getAttributeString( int aSelector,
  2. int length)
  3. throws MQException
Although available on the MQManagedObject base class, this method has no relevance upon MQSubscription.
Overrides:
getAttributeString in class MQManagedObject
Parameters:
aSelector - Ignored as this method is not relevant to this class.
length - Ignored as this method is not relevant to this class.
Returns:
String attribute string
Throws:
MQException - if the call fails.
See Also:
MQManagedObject.getAttributeString(int, int)

setAttributeString

  1. public void setAttributeString( int aSelector,
  2. java.lang.String aValue,
  3. int length)
  4. throws MQException
Although available on the MQManagedObject base class, this method has no relevance upon MQSubscription.
Overrides:
setAttributeString in class MQManagedObject
Parameters:
aSelector - Ignored as this method is not relevant to this class.
aValue - Ignored as this method is not relevant to this class.
length - Ignored as this method is not relevant to this class.
Throws:
MQException - if the call fails.
See Also:
MQManagedObject.setAttributeString(int, String, int)

getAlternateUserId

  1. public java.lang.String getAlternateUserId( )
  2. throws MQException
This property is not valid for an MQSubscription.
Overrides:
getAlternateUserId in class MQManagedObject
Returns:
This method will always return null.
Throws:
MQException - If the call fails.
See Also:
MQManagedObject.getAlternateUserId()

getDescription

  1. public java.lang.String getDescription( )
  2. throws MQException
This property is not valid for an MQSubscription.
Overrides:
getDescription in class MQManagedObject
Returns:
This method will always return null.
Throws:
MQException - If this method is called after the resource has been closed, to indicate that the resource is no longer available.
See Also:
MQManagedObject.getDescription()

getOpenOptions

  1. public int getOpenOptions()
  2. throws MQException
This property is not valid for an MQSubscription.
Overrides:
getOpenOptions in class MQManagedObject
Returns:
This method will always return -1.
Throws:
MQException - If the call fails.
See Also:
MQManagedObject.getOpenOptions()