This topic contains sections marked as revised for this release

WebSphere Message Brokers
File: an09150_
Writer: Bill Oppenheimer

Reference topic

This build: July 31, 2007 21:33:39

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.
Start of change-e ExecutionGroupLabelEnd of change
Start of change(Required) The label of the execution group for which a report is required.

The special name AllExecutionGroups is allowed, and is used to view settings for the Connector object name; this allows you to view broker-wide settings that affect all execution groups.

End of change
Start of change-b ComponentNameEnd of change
Start of change(Required) The name of the component selected.End of change

Start of changeYou must select one, and only one, option from -e and -b.End of change

-c ConfigurableService
(Required) The type of the configurable service, such as JMSProvidersStart of change, JDBCProviders, or SecurityProfilesEnd of change. Specify a value of AllTypes to report on all configurable service types.
-o ObjectName
(Required) The name of the object for which you want to read the properties.
Start of changeThe values:
  • Axis2Manager, HTTPConnector, and HTTPSConnector are accepted for all execution groups, and display results as described in Responses.
  • HTTPConnector, and HTTPSConnector are allowed if you select the value AllExecutionGroups for ExecutionGroupLabel.
End of change

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. Similarly, if you set the -c parameter to JDBCProvider, the expected object name is either a default JDBC provider name that has been predefined by IBM, or a user-defined JDBC provider name.

Start of changeIf you set the -c parameter to SecurityProfiles, the expected object name is the name of the security profile for the broker. Use the mqsireportproperties command to view the list of JMS provider names , JDBC provider names, or security profiles 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 PropertyName
(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.

The ObjectName parameter can have a value for inter-broker communications or for the HttpListener component. For inter-broker communications, the following values are available:
  • DynamicSubscriptionEngine
  • Start of changeAxis2ManagerEnd of change
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.

Start of change

Responses

These are of the form:
  • Axis2Manager
    • ActiveHandlerChains
      	NodeLabel = “goop�
      	FlowLabel = “test�
      	WSAddressingConfigured = true
      	PolicySetName = “WSS default 1.0�
      .....
  • HTTPConnector
    • PortNumber = 7800
  • HTTPSConnector
    • PortNumber = 7843
End of change

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
Display 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
Display the properties for all the JMS provider resources of JMS_Default_IBM_MQ.
mqsireportproperties WBRK6_DEFAULT_BROKER -c JMSProvider -o IBM_MQ -r
Start of changeDisplay properties and configuration information for Axis2.
mqsireportproperties TEST –e fnerble –o Axis2Manager –r
End of change
Start of changeDisplay the properties for all the broker's security profiles (default security profiles and those defined using the mqsicreateconfigurableservice command).
mqsireportproperties WBRK_6_DEFAULT_BROKER - c SecurityProfiles -o AllReportableEntityNames -r
End of change
Start of changeResponse:
ReportableEntityName=''
SecurityProfiles

	Default_Propagation=''
		Authentication = 'NONE'
		AuthenticationConfig = ''
		Mapping = 'NONE'
		MappingConfig = ''
		Authorization = 'NONE'
		AuthorizationConfig = ''
		Propagation = 'TRUE'
		
End of change
Start of changeDisplay the properties for the security profile called MyFirstSecurityProfile:
mqsireportproperties WBRK_6_DEFAULT_BROKER - c SecurityProfiles -o MyFirstSecurityProfile -r
End of change
Start of changeResponse:
ReportableEntityName=''
SecurityProfiles
	MyFirstSecurityProfile=''
		Authentication = 'LDAP'
		AuthenticationConfig = 'ldap://localhost:389/ou=users,o=ibm'
		Mapping = 'TFIM'
		MappingConfig = 'http://tfimhost1:80'
		Authorization = 'NONE'
		AuthorizationConfig = ''
		Propagation = 'TRUE'
		
End of change
Start of changeDisplay all the properties for the object Axis2Manager on the execution group fnerble for broker TEST:
mqsireportproperties TEST –e fnerble –o Axis2Manager –r
End of change
Related concepts
Broker domains
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:33:40

an09150_ This topic's URL is: