mqsireportproperties command

Supported platforms

  • Windows systems.
  • Linux and UNIX systems.
  • z/OS. Run this command by customizing and submitting BIPRPPR; see Contents of the broker PDSE.

Purpose

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

Usage notes

  • Before you run this command, ensure that the broker is running.
  • If you use the mqsichangeproperties command to change any value, 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.
Start of change-c ConfigurableServiceEnd of change
Start of change(Required) The type of the configurable service, such as JMSProviders. Use the mqsireportproperties command to view the list of valid values. Specify a value of AllTypes to report on all configurable service types.End of change
Start of change-o ObjectNameEnd of change
Start of change(Required) The name of the object for which you want to change the properties.

For example, if you set the -c parameter to JMSProvider, the expected object name is either a default JMS provider name that has been predefined by IBM, or a user-defined JMS provider name. Use the mqsireportproperties command to view the list of JMS provider names that are configured for this broker. Specify a value of AllReportableEntityNames to return a list of all valid object names. If you run the mqsireportproperties command on the command line without any properties, the AllReportableEntityNames is used.

End of change
-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.

    For a list of the options you can select, see the mqsichangeproperties command.

  • 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
Start of changeDisplay the properties for all the broker's JMS provider resources (default JMS provider resources and those configurable services that are defined using the mqsicreateconfigurableservice command).
mqsireportproperties WBRK6_DEFAULT_BROKER -c JMSProvider -o AllReportableEntityNames -r
End of change
Start of changeDisplay the properties for all the JMS provider resources of JMS_Default_IBM_MQ.
mqsireportproperties WBRK6_DEFAULT_BROKER -c JMSProvider -o IBM_MQ -r
End of change
Related concepts
Broker domains