Attributes

Table 1. Admin MBean attributes
Attribute name Attribute description Attribute type Read/Write
AdminMsgExpiry The default expiry time (in milliseconds) for sent admin messages java.lang.Integer RW
AdminQName The default name of the admin queue to use for sending admin messages java.lang.String RW
CacheInterval The default time (in milliseconds) to retain cached values (see below) java.lang.Long RW
InquireOnConnect Indicates whether remote queue manager resources are inquired upon and MBeans for these created when new connection definitions are created java.lang.Boolean RW
MsgPollInterval The default time (in milliseconds) to wait for admin reply messages when performing remote admin java.lang.Long RW
LocalMsgTimeout The default length of time (in milliseconds) to check for admin reply messages when performing local admin java.lang.Long RW
RemoteMsgTimeout The default length of time (in milliseconds) to check for admin reply messages when performing remote admin java.lang.Long RW
Note:
  1. In the current implementation, the values set for these MQeAdminJmx attributes are not persistent between deletion and re-creation of the MBean so must be reset whenever a new MQeAdminJmx MBean is created. This effectively means that remote queue managers must be refreshed so that their children are all visible via JMX.
  2. The attribute CacheInterval relates to a caching mechanism employed in the MQe JMX interface. Attribute values are cached for this duration and inquires during the cache interval do not result in a refresh of the values. Attribute values are refreshed whenever an update is done (that is to say, the value of one or more of the attributes is changed). In that instance, the cache clock is reset to zero and no refresh will take place until either the CacheInterval expires or another update is done. The default value is 0.
  3. InquireOnConnect is used whenever new connection definitions are created or loaded. If this attribute has a value of true, an attempt will be made to inquire upon the remote queue manager accessed directly by this connection definition. If the inquire is successful, an attempt will be made to create MBeans for all of the remote queue manager child resources. If the attribute value is false, an MBean will be created for the remote queue manager but no MBeans will be created or registered for its child resources. The creation of the children MBeans can be effected when desired by using the MQeRemoteQueueManagerJmx refresh() method. The default setting is false which means that no children MBeans for remote queue managers are created at start-up.
  4. MsgPollInterval specifies how frequently the admin reply message should be looked for. The lower the number, the more times the reply message will be searched for during the Local/RemoteMsgTimeout period. This relates effectively to remote administration — for local administration, there should only need to be a single attempt to retrieve the reply message.
  5. LocalMsgTimeout and RemoteMsgTimeout indicate the length of time that it takes to check for a reply message. If a reply message is not returned within the specified time, then the inquire/update returns in an unknown state. For all local administration, a reply message should always be received. A case when a reply message may not be received is if remote administration is taking place and the remote queue manager does not have a connection definition back to the originating queue manager. In this case setting the RemoteMsgTimeout value to zero may be useful as it is already known that a reply message will not be received. In every case where a reply message is not received an exception will always be thrown. Setting the RemoteMsgTimeout to zero does not change this.
  6. LocalMsgTimeout, RemoteMsgTimeout and MsgPollInterval have defaults 10,000ms, 10,000ms and 10ms respectively. Resetting these values takes effect immediately and the new values are in force until they are reset again or the application is terminated.

Terms of use | WebSphere software

(c) Copyright IBM Corporation 2004, 2005. All rights reserved.