Start of change

Real-time nodes parameter values

Select the properties and values associated with the Real-time nodes that you want to change.

To change these properties, you must specify the broker name and -e with the name of an execution group. You must also specify DynamicSubscriptionEngine for the ObjectName.

The following properties and values are valid for use with Real-timeInput and Real-timeOptimizedFlow nodes:

-n httpDispatchThreads
The number of threads that the broker dedicates to managing HTTP tunneling clients.
  • Value type - integer
  • Initial value -32
-n httpProtocolTimeout
The number of milliseconds in the HTTP protocol timeout interval. You can change this value to update the amount of time a broker is to wait for the next event during any phase of the HTTP tunneling protocol. A value of 0 causes the broker to wait indefinitely.
  • Value type - integer
  • Initial value -10000
-n enableClientDiscOnQueueOverflow
If true, and if after deleting all possible messages the maxClientQueueSize is still exceeded, the broker disconnects the client.
  • Value type - Boolean
  • Initial value - False
-n enableQopSecurity
Enables the level of quality of protection for messages.

By default, Quality of Protection is enabled if either the isysQopLevel or sysQopLevel value has been changed from the default value of none.

  • Value type - string
  • Initial value - none
-n interbrokerHost
The IP host name of the broker. A single broker configuration can be left to default as null.
mqsichangeproperties <broker> -o DynamicSubscriptionEngine -n interbrokerHost -v <IP host name>
  • Value type - string
  • Initial value - null

If you change the value, the broker must be stopped and restarted. Then you must redeploy the full topology.

-n interbrokerPort
The port number on which the Broker listens for incoming inter-broker connections. If you want to run more than one broker on the same machine, set the interbrokerPort property to a different value for each broker. For example:
mqsichangeproperties <broker> -o DynamicSubscriptionEngine -n interbrokerPort -v <port number>

If you do not set the interbrokerPort value before the topology is deployed, restart the broker.

  • Value type - integer
  • Initial value -1507

If you change the value, you must stop and restart the broker, and redeploy the topology.

-n isysQopLevel
Applies to the system and allows brokers only to publish and subscribe.
  • Value type - string
  • Initial value - none
-n jvmMaxHeapSize
The size of the Java™ Virtual Machine (JVM) heap size used with the JVMManager for your Java user-defined nodes.

This value must be in the range 16 777 216 to 8 589 934 592.

  • Value type - integer
  • Initial value - 134 217 728
-n maxBrokerQueueSize
The maximum number of bytes that the broker can queue for transmission to another broker. If the maximum is exceeded, the broker deletes all messages queued to that broker, except for the latest message, high-priority messages, and responses. If 0, the broker does not limit the number of bytes queued to another broker.
  • Value type - integer
  • Initial value - 1000000
-n maxClientQueueSize
The maximum number of bytes that the broker can queue for transmission to a client. If the maximum is exceeded, the broker deletes all messages queued to that client, except for the latest message, high-priority messages, and response messages. If 0, the broker does not limit the number of bytes queued to a client.
  • Value type - integer
  • Initial value - 100000

The value of this property must be greater than, or equal to, the maxMessageSize value.

-n maxConnections
The maximum number of concurrently-connected clients that the broker permits. If this limit is reached, the broker denies new connection requests from clients. If this value is less than 0, the number of clients is unlimited.
  • Value type - integer
  • Initial value - 100
-n maxHopCount
The maximum number of multibroker links over which a message is sent, to ensure that messages never loop in a multibroker network. Set this value large enough to ensure that messages can travel the entire multibroker network.
  • Value type - integer
  • Initial value - 20
-n maxMessageSize
The maximum allowed message size in bytes. If a message exceeding this maximum size is received from a client, that client is disconnected.
  • Value type - integer
  • Initial value - 100000

The value of this property must be less than, or equal to, the maxClientQueueSize value.

-n multicastAddressRangeMax
The highest IPv4 address that the broker can use for its multicast transmissions.
This address must be in the range 224.0.0.2 to 239.255.255.255.
  • Value type - string
  • Initial value - 239.255.255.255
-n multicastAddressRangeMin
The lowest IPv4 address that the broker can use for its multicast transmissions.
This address must be in the range 224.0.0.2 to 239.255.255.255.
  • Value type - string
  • Initial value - 224.0.0.2
-n multicastBackoffTimeMillis
The maximum time, in milliseconds, that a client listens for another's NACKs before sending its own NACK. This value can be in the range 0 to 1000.
  • Value type - integer
  • Initial value - 100
-n multicastDataPort
The UDP data port through which multicast packets are sent and received.
  • Value type - integer
  • Initial value - 34343
-n multicastEnabled
Indicates whether the topics that are defined in the multicastTopicsConfigFile are delivered multicast. If the value is true, the topics in the multicastTopicsConfigFile are delivered multicast.
  • Value type - Boolean
  • Initial value - false
-n multicastHeartbeatTimeoutSec
The time in seconds between the arrival of control packets at each client. If a control packet does not arrive within the number, defined as twice the value specified by this property, of seconds of the previous control packet's arrival an error can be suspected.
  • Value type - integer
  • Initial value - 20
-n multicastLimitTransRate
Use this property in conjunction with the multicastTransRateLimitKbps property to control network congestion. Valid values are:
Disabled
Multicast data is transmitted as fast as possible
Static
The transmission rate is limited by the value specified in multicastTransRateLimitKbps
Dynamic
The transmission rate can vary throughout the process, but never exceeds the value specified in multicastTransRateLimitKbps
  • Value type - string
  • Initial value - Disabled
-n multicastMaxKeyAge
The maximum age, in minutes, of a topic encryption key before it must be redefined.
  • Value type - string
  • Initial value - 360
-n multicastMaxMemoryAllowedKBytes
The maximum memory consumption by client reception buffers, measured in kilobytes.
  • Value type - integer
  • Initial value - 262144

This parameter is available only if a Pragmatic General Multicast (PGM) protocol is selected.

-n multicastMCastSocketTTL
The maximum number of hops that a multicast packet can make between the client and the broker. This value is one more than the maximum number of routers that there can be between the client and the broker.
A value of 1 indicates that the packet reaches all local nodes, but cannot be relayed by routers. The maximum value is 255.
  • Value type - integer
  • Initial value - 1
-n multicastMinimalHistoryKBytes
The minimum size, in kilobytes, of a buffer that is allocated as an archive for all transmitted packets. This buffer is shared by all reliable topics, and can be used to recover lost packets. This value must be in the range 1000 to 1000000.
  • Value type - integer
  • Initial value - 60000
-n multicastMulticastInterface
The interface to use for multicast transmissions. You can specify a host name or an IP address. A value of None causes the network interface to be operating system dependent.
  • Value type - string
  • Initial value - None

If you have only one network card, the default value of none works because the operating system uses the localhost value. However, if you have more than one network card you must set this parameter to ensure that the correct card is used.

-n multicastNACKAccumulationTimeMillis
The time, in milliseconds, that NACKs are aggregated in the broker, before recovered packets are sent. This value must be in the range 50 to 1000.
  • Value type - integer
  • Initial value - 300
-n multicastNACKCheckPeriodMillis
The time, in milliseconds, between periodic checks of reception status and sequence gap detection for NACK building. This value must be in the range 10 through 1000.
  • Value type - integer
  • Initial value - 500
-n multicastOverlappingTopicBehavior
This property is used to control the behavior of the broker when a client requests a multicast subscription for a topic, that is part of a topic hierarchy containing topics, explicitly excluded for multicast. Valid values are:
Accept
A matching multicast subscription is accepted and all publications matching the topic, except those that are specifically excluded, are multicast.
Reject
A multicast subscription to a topic with children that are not enabled for multicast is rejected by the broker.
Revert
Subscriptions to a topic, or to children of that topic, that are not enabled for multicast result in unicast transmission.
  • Value type - string
  • Initial value - Accept
-n multicastPacketBuffers
The number of memory buffers that are created at startup for packet reception. Having a high number of buffers available improves the reception performance and minimizes packet loss at high delivery rates, at the price of increased memory utilization. Each buffer is 33 KB and this value can be in the range 1 to 5000.
  • Value type - integer
  • Initial value - 500
-n multicastPacketSizeBytes
The size, in bytes, of multicast packets. This value must be in the range 500 to 32000.
  • Value type - integer
  • Initial value - 7000
-n multicastProtocolType
The protocol type. Valid values are:
  • PTL
  • PGM/IP
  • PGM/UDP
  • Value type - string
  • Initial value - PTL
-n multicastSocketBufferSizeKbytes
The size, in kilobytes, of the client's socket receiver buffer. Increasing it leads to lower loss rates. This value can be in the range 65 to 10000.
  • Value type - integer
  • Initial value - 3000
-n multicastTransRateLimitKbps
Limits the overall transmission rate in Kb (kilobits) per second.
This property is effective only if the multicastLimitTransRate property is not disabled. Set the value of this property to be no higher than the maximum data transmission rate of the system or the network, and in the range 10 through 1000000
  • Value type - integer
  • Initial value - 9500
-n nonDurableSubscriptionEvents
Indicates whether the user requires event messages when a non-durable subscriber is created or deleted. A true value causes an event publication to be created, false indicates that no event publications are made.
  • Value type - Boolean
  • Initial value - False
-n pingTimeoutMultiple
The number of consecutive clientPngIntervals or brokerPngIntervals without a response that the broker waits before disconnecting a client or broker.
  • Value type - integer
  • Initial value - 3
-n statsInterval
The number of milliseconds between statistics publications. If set to 0, statistics publications are not generated. You do not have to restart the broker after changing this property; however, the broker might take up to a minute to start producing statistics after you have changed the value.
This value must be in the range 0 through 1000.
  • Value type - integer
  • Initial value - 0

This value refers to the publish/subscribe statistics interval only.

-n sysQopLevel
Applies to the system, and allows brokers only to publish.
  • Value type - string
  • Initial value - none

See the mqsichangeproperties command for examples of how to change parameters for Real-time nodes. Other examples are provided for particular tasks:

Related reference
Real-timeInput node
Real-timeOptimizedFlow node
mqsichangeproperties command
mqsireportproperties command
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. All Rights Reserved.
Last updated : 2009-01-07 15:40:46

an09146_

End of change