mqsireportproperties-Befehl

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 eine Wert mit dem Befehl mqsichangeproperties ändern, müssen Sie den Broker oder die Ausführungsgruppe stoppen und erneut starten, damit die Änderung wirksam wird.
  • 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-'   
   '- -r--------------------'                        

Parameter

Brokername
(Erforderlich) Der Name des Brokers.

-b Komponentenname
(Optional) Der Name der ausgewählten Komponente. Gültige Werte sind httplistener, securitycache 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-Knoten definiert, die Sie im Broker definiert haben.

    Durch die Festlegung eines Parameters können Sie das brokerweite Empfangsprogramm für HTTP-Knoten inaktivieren oder aktivieren; standardmäßig ist dieses Empfangsprogramm aktiv.

  • 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 SOAP-Knoten definiert, die Sie in der angegebenen Ausführungsgruppe implementiert haben.

    Sie können auch die Ausführungsgruppe so konfigurieren, dass alle HTTP-Knoten das eingebettete Empfangsprogramm anstelle des brokerweiten Empfangsprogramms verwenden.

  • 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 den Wert AllReportableEntityNames an, um eine Liste mit allen gültigen Objektnamen zurückzugeben. Wenn Sie den Befehl mqsireportproperties in einer Befehlszeile ohne Eigenschaften ausführen, wird der Wert AllReportableEntityNames verwendet.

-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 Eigenschaftenwerte 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.

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

Für die Ausführung dieses Befehls ist keine bestimmte Berechtigung erforderlich.

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 Sie, ob das brokerweite Empfangsprogramm in einer oder mehreren Ausführungsgruppen für implementierte HTTP-Knoten aktiv ist:
    mqsireportproperties TEST -b httplistener -o HTTPListener -n startListener
  • Zeigt alle aktuellen Einstellungen des HTTP-Empfangsprogramm an, die HTTP-Knoten zugeordnet sind (in der Komponente 'httplistener' definiert):
    mqsireportproperties TEST -b httplistener -o HTTPListener -a
  • Zeigt alle Porteinstellungen für den HTTPS-Connector für die HTTP-Knoten an (in der Komponente 'httplistener' definiert):
    mqsireportproperties TEST -b httplistener -o HTTPSConnector -n port
  • Zeigen Sie alle Service Federation-Objekteigenschaften und ihre Werte an:
    mqsichangeproperties TEST -b servicefederation -o AllReportableEntityNames -r

Eigenschaften anzeigen, die Ausführungsgruppen zugeordnet wurden

Das folgende Beispiel enthält 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.
  • Prüfen Sie, ob die implementierten HTTP-Knoten das eingebettete Ausführungsgruppen-Empfangsprogramm verwenden:
    mqsireportproperties TEST -e exgroup1 -o ExecutionGroup -n httpNodesUseEmbeddedListener
  • Zeigen Sie die Eigenschaften an, welche die Erstellung eines SFM-Proxys für eine Ausführungsgruppe steuern, der als SFM Connectivity-Provider fungieren soll:
    mqsireportproperties TEST -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.

  • Alle konfigurierbaren Aggregationsservices anzeigen:
    mqsireportproperties MB8BROKER -c Aggregation -o AllReportableEntityNames -r
  • Alle konfigurierbaren CICSConnection-Services anzeigen:
    mqsireportproperties MB8BROKER -c CICSConnection -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 konfigurierbaren Collector-Services anzeigen:
    mqsireportproperties MB8BROKER -c Collector -o AllReportableEntityNames -r
  • Alle konfigurierbaren CORBA-Services anzeigen:
    mqsireportproperties MB8BROKER -c CORBA -o AllReportableEntityNames -r
  • Alle konfigurierbaren EmailServer-Services anzeigen, die EmailInput-Knoten oder Nachrichtenflüsse zur Laufzeit referenzieren:
    mqsireportproperties MB8BROKER -c EmailServer -o AllReportableEntityNames -r
  • 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
  • Alle konfigurierbaren Services des TCP/IP-Servers anzeigen:
    mqsireportproperties MB8BROKER -c IMSConnect -o AllReportableEntityNames -r
  • 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'
  • Alle konfigurierbaren PeopleSoftConnection-Services anzeigen:
    mqsireportproperties MB8BROKER -c PeopleSoftConnection -o AllReportableEntityNames -r
  • Zeigen Sie alle Richtliniensätze für den Broker MB8BROKER an:
    mqsireportproperties MB8BROKER -c PolicySets 
         -o AllReportableEntityNames -a
  • Zeigen Sie alle Richtliniensatzbindungen für den Broker MB8BROKER an:
    mqsireportproperties MB8BROKER -c PolicySetBindings 
         -o AllReportableEntityNames -a
  • Exportiert den Richtliniensatz 'Policy_2' im Broker MB8BROKER in die Datei policyset.xml:
    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.
  • Exportieren Sie eine Richtliniensatzbindung aus einem Broker in eine Datei:
    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.
  • Alle konfigurierbaren Resequence-Services anzeigen:
    mqsireportproperties WBRK7 -c Resequence -o AllReportableEntityNames -r
  • Dokumentieren Sie die Abhängigkeiten für den WebSphere Adapter for SAP:
    mqsireportproperties MB8BROKER -c EISProviders -o SAP -r
  • Zeigt alle konfigurierbaren Services vom Typ SAPConnection an:
    mqsireportproperties MB8BROKER -c SAPConnection -o AllReportableEntityNames -r
  • 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 = ''
    		Mapping = 'NONE'
    		MappingConfig = ''
    		Authorization = 'NONE'
    		AuthorizationConfig = ''
    		Propagation = 'TRUE'
    		passwordValue = 'PLAIN'
  • 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'
    		Mapping = 'TFIM'
    		MappingConfig = 'http://tfimhost1:80'
    		Authorization = 'NONE'
    		AuthorizationConfig = ''
    		Propagation = 'TRUE'
    		passwordValue = 'PLAIN'
    		
  • Alle konfigurierbaren SiebelConnection-Services anzeigen:
    mqsireportproperties MB8BROKER -c SiebelConnection -o AllReportableEntityNames -r
  • Zeigt alle konfigurierbaren Services des TCP/IP-Clients an:
    mqsireportproperties MB8BROKER -c TCPIPClient 
          -o AllReportableEntityNames -r
  • Zeigt alle konfigurierbaren Services des TCP/IP-Servers an:
    mqsireportproperties MB8BROKER -c TCPIPServer 
          -o AllReportableEntityNames -r
  • Alle konfigurierbaren Zeitgeberservices anzeigen:
    mqsireportproperties MB8BROKER -c Timer -o AllReportableEntityNames -r
  • Alle JavaClassLoader-Services anzeigen:
    mqsireportproperties MB8BROKER -c JavaClassLoader 
          -o AllReportableEntityNames -r
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-01-20 09:49:28


ReferenzthemaReferenzthema | Version 8.0.0.0 | an09150_