mqsireportproperties command

Supported platforms

Purpose

Use the mqsireportproperties command to examine the values of properties set using the mqsichangeproperties command.

Start the broker using mqsistart, and then issue the command on the machine running the broker.

If you change any value (with mqsichangeproperties) you must stop and restart the broker for the change to take effect.

Syntax

Parameters

brokername
(Required) The name of the broker.
-e ExecutionGroupLabel
(Optional) The label of the execution group for which a report is required.
-b httplistener
(Optional) The name of the http listener component.
-o ObjectName
(Required) The name of the object whose properties you want to change. This must be set to one of the values listed below.
-n name
(Optional) Display only the named property
-a
(Optional) Indicates that all property values of the object are displayed, and does not recurse into properties that have child values.
-r
(Optional) Indicates that all property values of the object are displayed and, additionally, displays the child values for all properties that have child values.
  • You must select one, and only one, option from -n, -a, and -r.

    Start of changeFor a list of the options you can select, see the mqsichangeproperties command.End of change

  • You must select one, and only one, option from -e and -b.
The ObjectName parameter can have a value for inter-broker communications or for the httplistener component. For inter-broker communications, use the following value:
  • DynamicSubscriptionEngine
For the httplistener component, which includes the HTTPInput and HTTPReply nodes, the following ObjectName values are available:
  • HTTPListener for controlling the HTTPListener process.
  • HTTPConnector for controlling HTTP communication with the HTTPInput and HTTPReply nodes.
  • HTTPSConnector for controlling HTTPS communication with the HTTPInput and HTTPReply nodes.
httplistener is required when using the HTTP ObjectName settings.

For the httplistener component, mqsireportproperties does not report those properties that have not been explicitly set with mqsichangeproperties, even if those properties have a default setting. For example, the default HTTPSConnector port that is used (unless it has been changed) is 7083. However this value is not reported by mqsireportproperties unless it has been changed from this default with mqsichangeproperties. To see the default values for all properties that mqsireportproperties can report on, see the documentation for mqsichangeproperties.

Authorization

No specific authority is required to invoke this command.

Examples

Display all the current HTTPListener settings (that have been changed from their default value)
mqsireportproperties TEST -b httplistener -o HTTPListener -a
Display the HTTPSConnector port setting (if it has been changed from the default value)
mqsireportproperties TEST -b httplistener -o HTTPSConnector -n port
Display recursively all the current settings for the inter-broker communication.
mqsireportproperties TEST -e default -o DynamicSubscriptionEngine -r
Related concepts
Broker domains