WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Befehl mqsireportproperties

Mit dem Befehl mqsireportproperties können Sie Eigenschaften anzeigen, die sich auf einen Broker, eine Ausführungsgruppe oder einen konfigurierbaren Service beziehen.

Mit dem WebSphere Message Broker Explorer können Sie auch konfigurierbare Services erstellen und anzeigen. Weitere Informationen finden Sie im Abschnitt Konfigurierbare Services im WebSphere Message Broker Explorer bearbeiten.

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS. Führen Sie diesen Befehl aus, indem Sie BIPRPPR anpassen und übergeben; weitere Informationen erhalten Sie unter Inhalt der Broker-PDSE.

Zweck

Mit dem Befehl mqsireportproperties können Sie die Werte der Eigenschaften oder Brokerressourcen überprüfen, die mit dem Befehl mqsichangeproperties gesetzt bzw. mit dem Befehl mqsicreateconfigurableservice erstellt wurden.

Hinweise zur Nutzung

  • Stellen Sie vor Ausführung des Befehls mqsireportproperties sicher, dass der Broker aktiv ist.
  • Wenn Sie mit dem Befehl mqsichangeproperties einen Wert ändern, wird diese Änderung erst nach dem Stopp und anschließenden Neustart des Brokers bzw. der Ausführungsgruppe wirksam.
  • Wenn Sie den Befehl mqsireportproperties nach der Änderung von Eigenschaften, jedoch vor dem Neustart des Brokers oder der Ausführungsgruppe ausführen, zeigt der Befehl den geänderten Wert an, obwohl dieser zu diesem Zeitpunkt noch nicht wirksam ist.

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsireportproperties--Brokername----------------------------->

>--+-------------------------------------+-- -o --Objektname---->
   +- -b --Komponentenname---------------+                     
   +- -e --Kennung der Ausführungsgruppe-+                     
   '- -c --KonfigurierbarerService-------'                     

>--+- -n --Eigenschaftsname-+--+-----------------+--+-----+----><
   +- -a--------------------+  '- -p --Dateiname-'  '- -f '   
   '- -r--------------------'                                 

Parameter

Brokername
(Erforderlich) Der Name des Brokers.

-b Komponentenname
(Optional) Der Name der ausgewählten Komponente. Gültige Werte sind httplistener, securitycache, cachemanager, webadmin und servicefederation.

-c KonfigurierbarerService
(Optional) Der konfigurierbare Servicetyp. Geben Sie den Wert AllTypes (Alle Typen) an, um Berichte zu allen konfigurierbaren Servicetypen zu erstellen.

Eine Liste der bereitgestellten konfigurierbaren Services und der zugehörigen Eigenschaften und Werte finden Sie unter Eigenschaften von konfigurierbaren Services.

-e Kennung der Ausführungsgruppe
(Optional) Die Bezeichnung der Ausführungsgruppe, für die ein Bericht erforderlich ist.

-o Objektname
(Erforderlich) Der Name des Objekts, dessen Eigenschaften Sie lesen möchten.

Sie müssen nach -o auch -b, -e oder -c angeben, es sei denn, Sie haben den Objektnamen Brokerregistry angegeben.

Legen Sie Objektname so fest, dass er mit anderen Parametern übereinstimmt:
  • Geben Sie Brokerregistry für die Parameter der Brokerregistry an.
  • Geben Sie den Namen eines (vordefinierten oder benutzerdefinierten) konfigurierbaren Service des Typs an, den Sie über -c angegeben haben.
    Beispiel:
    • -c EISProviders mit SAP, Siebel oder PeopleSoft für einen vordefinierten konfigurierbaren Service für WebSphere Adapters.
    • -c JMSProviders mit dem Namen eines vordefinierten oder benutzerdefinierten Service, z. B. WebSphere_MQ.
  • Geben Sie ein Übertragungsobjekt für die Komponente httplistener an, die Sie mit -b angegeben haben, sowie eine der Optionen HTTPListener, HTTPConnector oder HTTPSConnector. Die Werte werden für alle HTTP- und SOAP-Knoten definiert, die Sie im Broker implementiert haben.

    Durch Festlegung eines Parameters können Sie das brokerweite Empfangsprogramm für HTTP- und SOAP-Knoten inaktivieren oder aktivieren. Standardmäßig ist dieses Empfangsprogramm aktiv und wird für HTTP-Knoten verwendet. SOAP-Knoten verwenden standardmäßig das (integrierte) Ausführungsgruppen-Empfangsprogramm.

  • Geben Sie ein Übertragungsobjekt für die Ausführungsgruppe an, die Sie mit -e angegeben haben, sowie eine der Optionen HTTPListener, HTTPConnector oder HTTPSConnector. Die Werte werden für alle HTTP- und SOAP-Knoten definiert, die in der angegebenen Ausführungsgruppe implementiert wurden.

    Sie können die Ausführungsgruppe so konfigurieren, dass alle HTTP-Knoten anstelle des brokerweiten Empfangsprogramms das integrierte Empfangsprogramm verwenden. Sie können die Ausführungsgruppe auch so konfigurieren, dass SOAP-Knoten das brokerweite Empfangsprogramm verwenden. Weitere Informationen finden Sie im Abschnitt HTTP-Empfangsprogramme.

  • Geben Sie DynamicSubscriptionEngine für brokerübergreifende Übertragungseigenschaften für die Ausführungsgruppe an, die Sie mit -e angegeben haben. Diese Eigenschaften gelten für Broker, die in Brokerverbünden konfiguriert oder geklont wurden.
  • Geben Sie die Option SecurityCache für Eigenschaften der Komponente securitycache an, die Sie mit -b angegeben haben.
  • Geben Sie ein Objekt für die Komponente servicefederation an, die Sie mit -b angegeben haben, sowie eine der Optionen scmp, HTTPConnector oder HTTPSConnector. Die Eigenschaften gelten für den Broker-HTTP(S)-Port, der die SCMP Atom-Anforderungen von Service Federation Management (SFM) verarbeitet.
  • Geben Sie ServiceFederationManager für Eigenschaften im Zusammenhang mit der Erstellung eines SFM-Proxys für die Ausführungsgruppe an, die Sie mit -e angegeben haben.
  • Geben Sie für die Ausführungsgruppe, die Sie mit -e angegeben haben, ComIbmActivityLogManager für die Eigenschaften des Aktivitätenprotokolls ein. Weitere Informationen hierzu finden Sie unter Laufzeiteigenschaften für Aktivitätenprotokolle anzeigen und festlegen.
  • Geben Sie Connectors für alle Verbindungseigenschaften für die Ausführungsgruppe an, die Sie mit -e angegeben haben. Verschachtelte Eigenschaftsinformationen können angezeigt werden, indem für jede in der Struktur erforderliche Ebene ein Schrägstrich (/) angegeben wird.
    Beispiel:
    • -o Connectors/MQTT, um nur die Eigenschaftsinformationen anzuzeigen, die sich auf den Verbindungsprovider MQTT beziehen.

Geben Sie den Wert AllReportableEntityNames an, um eine Liste mit allen gültigen Objektnamen zurückzugeben.

-n Eigenschaftsname
(Optional) Es wird nur die angegebene Eigenschaft angezeigt.

Es darf nur eine der Optionen -n, -a und -r ausgewählt werden.

-a
(Optional) Gibt an, dass alle Eigenschaftswerte des Objekts angezeigt werden sollen und funktioniert bei Eigenschaften, die über untergeordnete Werte verfügen, nicht rekursiv.

-r
(Optional) Gibt an, dass alle Eigenschaftswerte des Objekts angezeigt werden sollen, einschließlich der Werte aller untergeordneten Eigenschaften.

Beachten Sie, dass diese Option nicht alle möglichen Werte für AllReportableEntityNames anzeigt. Zudem unterstützen nicht alle Entitäten diesen Parameter.

-p Dateiname
(Optional) Die Position und der Name der Datei, in die der Befehl alle ausgewählten Eigenschaften schreibt. Wenn Sie -n nicht angeben, werden zwar die Eigenschaftswerte, aber nicht die Eigenschaftsnamen in die Datei geschrieben.

-f
(Optional) Dieser Parameter ist nur bei Angabe eines Objekts auf Ausführungsgruppenebene gültig.

Diesen Parameter können Sie nur verwenden, wenn die Ausführungsgruppe gestoppt wurde; außerdem müssen Sie auch -e und -o angeben.

Wenn Sie diesen Parameter für andere konfigurierbare Services oder Komponenten verwenden, wird ein Fehler generiert.

Weitere Informationen zu Objekten, Eigenschaften und Werten sowie gültige Kombinationen dieser Parameter finden Sie unter mqsichangeproperties-Befehl.

Für die Komponente HTTP-Empfangsprogramm meldet der Befehl mqsireportproperties nur Eigenschaften, die explizit mit dem Befehl mqsichangeproperties festgelegt wurden, auch wenn für diese Eigenschaften Standardeinstellungen gesetzt sind.

Beispielsweise ist 7083 der Standardport für HTTPSConnector (es sei denn, dieser Wert wurde geändert). Dieser Wert wird jedoch vom Befehl mqsireportproperties nicht gemeldet, es sei denn, Sie haben den Standardwert mit dem Befehl mqsichangeproperties geändert. Informationen zu den Standardwerten für alle Eigenschaften, die der Befehl mqsireportproperties melden kann, finden Sie in der Beschreibung des Befehls mqsichangeproperties.

Berechtigung

In den folgenden Abschnitten finden Sie Informationen zu plattformspezifischen Autorisierungen: Wenn Sie die Brokerverwaltungssicherheit aktiviert haben, müssen Sie auch die Berechtigung einrichten. Ausführliche Informationen hierzu finden Sie im Abschnitt Tasks und Berechtigungen für Verwaltungssicherheit.

Antworten

Antworten haben folgendes Format:
  • HTTPConnector
    • PortNumber = 7800
  • HTTPSConnector
    • PortNumber = 7843

Beispiele

Geben Sie den Befehl immer in einer einzigen Zeile ein. In einigen Beispielen wurde der Zeilenumbruch lediglich zur besseren Lesbarkeit eingefügt.

Eigenschaften anzeigen, die Brokerkomponenten zugeordnet wurden

Die folgenden Beispiele enthalten den Parameter -b zur Angabe der Komponente, die angezeigt werden soll.

  • Prüfen, ob das brokerweite Empfangsprogramm für die implementierten HTTP- und SOAP-Knoten in einer oder mehreren Ausführungsgruppen aktiv ist:
    mqsireportproperties MB8BROKER -b httplistener -o HTTPListener -n startListener
  • Anzeigen der Eigenschaften für den Cache-Manager:
    mqsireportproperties MB8BROKER -b cachemanager -o CacheManager -r
  • Alle aktuellen HTTPListener-Einstellungen anzeigen, die HTTP- und SOAP-Knoten zugeordnet sind (in der Komponente 'httplistener' definiert):
    mqsireportproperties MB8BROKER -b httplistener -o HTTPListener -a
  • Porteinstellung für den HTTPS-Connector für die HTTP-Knoten anzeigen (in der Komponente 'httplistener' definiert):
    mqsireportproperties MB8BROKER -b httplistener -o HTTPSConnector -n port
  • Alle Service Federation-Objekteigenschaften und ihre Werte anzeigen:
    mqsichangeproperties MB8BROKER -b servicefederation -o AllReportableEntityNames -r

Eigenschaften anzeigen, die Ausführungsgruppen zugeordnet wurden

Die folgenden Beispiele enthalten den Parameter -e zur Angabe der Ausführungsgruppe, die angezeigt werden soll.

  • Name des FTE-Agenten für Ausführungsgruppe FTESAMPLE in Broker MB8BROKER anzeigen:
    mqsireportproperties MB8BROKER -e FTESAMPLE -o FTEAgent -n agentName
    Falls der Agent erstellt wurde, wird der Agentenname von dem Befehl zurückgegeben. Falls der Agent nicht erstellt wurde, gibt der Befehl eine leere Zeichenfolge zurück.
  • Überprüfen, ob die implementierten HTTP-Knoten das in der Ausführungsgruppe integrierte Empfangsprogramm verwenden:
    mqsireportproperties MB8BROKER -e exgroup1 -o ExecutionGroup -n httpNodesUseEmbeddedListener
  • Überprüfen, ob die implementierten SOAP-Knoten das in die Ausführungsgruppe integrierte Empfangsprogramm verwenden:
    mqsireportproperties MB8BROKER -e exgroup1 -o ExecutionGroup -n soapNodesUseEmbeddedListener
  • Eigenschaften anzeigen, welche die Erstellung eines SFM-Proxys für eine Ausführungsgruppe steuern, der als SFM Connectivity-Provider fungieren soll:
    mqsireportproperties MB8BROKER -e exgroup1 -o ServiceFederationManager -a
    Das Ergebnis dieses Befehls hat folgendes Format:
    ServiceFederationManager
      uuid='ServiceFederationManager'
      userTraceLevel='none'
      traceLevel='none'
      userTraceFilter='none'
      traceFilter='none'
      port='8811'
      securePort='8844'
      maxWaitTime='180'
      proxyURLHostName=' mbhost.ibm.com '
      proxyPathPrefix='proxy'
      proxyPathPrefixesEnabled='TRUE'
      creationTime='2009-09-11 15:37:52.639219'
      nextProxyPathPrefixCount='8'
      ownedProxyGroupCount='2'

Eigenschaften anzeigen, die konfigurierbaren Services zugeordnet wurden

Die folgenden Beispiele enthalten den Parameter -c zur Angabe des konfigurierbaren Service, er angezeigt werden soll. Eine Liste der bereitgestellten konfigurierbaren Services und der zugehörigen Eigenschaften und Werte finden Sie unter Eigenschaften von konfigurierbaren Services.

  • Alle konfigurierbaren Aggregationsservices anzeigen:
    mqsireportproperties MB8BROKER -c Aggregation -o AllReportableEntityNames -r
  • Alle konfigurierbaren Services für Connect:Direct-Server anzeigen (die Sie für diesen Broker mit dem Befehl mqsicreateconfigurableservice definiert haben)
    mqsireportproperties MB8BROKER -c CDServer -o AllReportableEntityNames -r
    Das Ergebnis dieses Befehls hat folgendes Format:
    CDServer
      Standard
        hostname='localhost'
        port='1363'
        brokerPathToStagingDir=''
        cdPathToStagingDir=''
        brokerPathToInputDir=''
        cdPathToInputDir=''
        queuePrefix= ''
        securityIdentity=”Default”
  • Alle Eigenschaften des konfigurierbaren FtpServer-Service TEST1 anzeigen:
    mqsireportproperties MB8BROKER -c FtpServer -o TEST1 -r
  • Die Einstellung der Eigenschaft protocol des konfigurierbaren FtpServer-Service TEST1 anzeigen:
    mqsireportproperties MB8BROKER -c FtpServer -o TEST1 -n protocol
  • Die Eigenschaften des konfigurierbaren Oracle-JDBCProvider-Service auflisten:
    mqsireportproperties MB8BROKER -c JDBCProviders -o Oracle -r
  • Die Eigenschaften aller JMS-Providerressourcen des Brokers anzeigen (standardmäßige JMS-Providerressourcen und die konfigurierbaren Services, die Sie mit dem Befehl mqsicreateconfigurableservice definiert haben):
    mqsireportproperties MB8BROKER -c JMSProviders 
         -o AllReportableEntityNames -r
  • Die Eigenschaften aller JMS-Providerressourcen von WebSphere MQ anzeigen:
    mqsireportproperties MB8BROKER -c JMSProviders 
         -o WebSphere_MQ -r
  • Die Eigenschaften aller JMS-Providerressourcen anzeigen (standardmäßige JMS-Providerressourcen und die konfigurierbaren Services, die Sie mit dem Befehl mqsicreateconfigurableservice für diesen Broker definiert haben):
    mqsireportproperties MB8BROKER -c JMSProviders 
         -o BEA_WebLogic –r
    Das Ergebnis dieses Befehls hat folgendes Format:
    ReportableEntityName=''
    JMSProviders
      BEA_Weblogic=''
        jarsURL='default_Path'
        nativeLibs='default_Path'
        proprietaryAPIAttr1='weblogic.jndi.WLInitialContextFactory'
        proprietaryAPIAttr2='t3://9.20.94.16:7001'
        proprietaryAPIAttr3='BEAServerName'
        proprietaryAPIAttr4='default_none'
        proprietaryAPIAttr5='default_none'proprietaryAPIHandler='BEAWebLogicAPIHandler.jar'
  • Richtliniensatz 'Policy_2' im Broker MB8BROKER in die Datei policyset.xml exportieren:
    mqsireportproperties MB8BROKER -c PolicySets 
         -o Policy_2 -n ws-security -p policyset.xml
    Mithilfe der Ausgabedatei können Sie Richtliniengruppen zwischen Brokern und zur Sicherung verschieben.
  • Richtliniensatzbindung aus einem Broker in eine Datei exportieren:
    mqsireportproperties MB8BROKER -c PolicySetBindings 
         -o Bindings_2 -n ws-security -p bindings.xml
    Mit diesem Befehl wird die Datei 'Bindings_2' für Richtliniensatzbindungen im Broker MB8BROKER in die Datei bindings.xml geschrieben. Mit dieser Datei können Sie Richtliniensatzbindungen zwischen Brokern und zur Sicherung verschieben.
  • Die Eigenschaften aller Sicherheitsprofile anzeigen (Standardsicherheitsprofile sowie alle Profile, die Sie mit dem Befehl mqsicreateconfigurableservice auf diesem Broker definiert erstellt haben):
    mqsireportproperties MB8BROKER -c SecurityProfiles 
         -o AllReportableEntityNames -r
    Das Ergebnis dieses Befehls hat das folgende Format:
    ReportableEntityName=''
    SecurityProfiles
    
    	Default_Propagation=''
    				authentication = 'NONE'
    				authenticationConfig = ''
    				authorization = 'NONE'
    				authorizationConfig = ''
    				idToPropagateToTransport = 'Message ID'
    				keyStore = 'Reserved for future use'
    				mapping = 'NONE'
    				mappingConfig = ''
    				passwordValue = 'PLAIN'
    				propagation = 'TRUE'
    				rejectBlankpassword = 'FALSE'
    				transportPropagationConfig = ''
    				trustStore = 'Reserved for future use'
  • Anzeigen der Eigenschaften für das Sicherheitsprofil 'MyFirstSecurityProfile':
    mqsireportproperties MB8BROKER -c SecurityProfiles 
         -o MyFirstSecurityProfile -r
    Das Ergebnis dieses Befehls hat das folgende Format:
    ReportableEntityName=''
    SecurityProfiles
    	MyFirstSecurityProfile=''
    				authentication = 'LDAP'
    				authenticationConfig = 'ldap://localhost:389/ou=users,o=ibm'
    				authorization = 'NONE'
    				authorizationConfig = ''
    				idToPropagateToTransport = 'Message ID'
    				keyStore = 'Reserved for future use'
    				mapping = 'TFIM'
    				mappingConfig = 'http://tfimhost1:80'
    				passwordValue = 'PLAIN'
    				propagation = 'TRUE'
    				rejectBlankpassword = 'FALSE'
    				transportPropagationConfig = ''
    				trustStore = 'Reserved for future use'
    		
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:21:45


ReferenzthemaReferenzthema | Version 8.0.0.5 | an09150_