IBM Integration Bus, Version 9.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Befehl mqsireportproperties

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

Mit dem IBM® Integration Explorer können Sie auch konfigurierbare Services erstellen und anzeigen. Weitere Informationen finden Sie im Abschnitt Konfigurierbare Services in IBM Integration 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. des Integrationsservers wirksam.
Wenn Sie den Befehl mqsireportproperties nach der Änderung von Eigenschaften, jedoch vor dem Neustart des Brokers oder des Integrationsservers ausführen, zeigt der Befehl den geänderten Wert an, obwohl dieser zu diesem Zeitpunkt noch nicht wirksam ist.

Syntax


>>-mqsireportproperties--Brokername----------------------------->

>--+---------------------------------------+-------------------->
   +- -b --Komponentenname-----------------+   
   +- -e --Kennung_des_Integrationsservers-+   
   '- -c --konfigurierbarer_Service--------'   

>-- -o --Objektname--+- -n --Eigenschaftsname-+----------------->
                     +- -a--------------------+   
                     '- -r--------------------'   

>--+-----------------+--+-----+--------------------------------><
   '- -p --Dateiname-'  '- -f '

Parameter

Brokername: (Erforderlich) Der Name des Brokers.
-b Komponentenname: (Optional) Der Name der ausgewählten Komponente. Gültige Werte sind httplistener, securitycache, cachemanager oder webadmin.

-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 im Abschnitt Eigenschaften von konfigurierbaren Services.

-e Integrationsservername

(Optional) Die Bezeichnung des Integrationsservers, 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 den brokerweiten Listener für HTTP- und SOAP-Knoten inaktivieren oder aktivieren. Standardmäßig ist dieser Listener aktiv und wird für HTTP-Knoten verwendet. SOAP-Knoten verwenden standardmäßig den eingebetteten Listener des Integrationsservers.
Geben Sie ein Übertragungsobjekt für den Integrationsserver an, den 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 auf dem angegebenen Integrationsserver implementiert wurden.
Sie können den Integrationsserver so konfigurieren, dass alle HTTP-Knoten anstelle des brokerweiten Listeners den eingebetteten Listener verwenden. Sie können den Integrationsserver auch so konfigurieren, dass SOAP-Knoten den brokerweiten Listener verwenden. Weitere Informationen finden Sie im Abschnitt HTTP-Listener.
Geben Sie DynamicSubscriptionEngine für brokerübergreifende Übertragungseigenschaften für den Integrationsserver 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 für den Integrationsserver, den Sie mit -e angegeben haben, ComIbmActivityLogManager für die Eigenschaften des Aktivitätenprotokolls ein. Weitere Informationen hierzu finden Sie im Abschnitt Laufzeiteigenschaften für Aktivitätenprotokolle anzeigen und festlegen.
Geben Sie Connectors für alle Verbindungseigenschaften für den Integrationsserver an, den 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 zulässig, wenn Sie ein Objekt auf Integrationsserverebene angeben.

Dieser Parameter kann nur verwendet werden, wenn der Integrationsserver gestoppt ist. Außerdem muss mit diesem Parameter -e und -o angegeben sein.

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 Befehl mqsichangeproperties.

Für die Komponente HTTP-Listener 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 Berechtigungen:

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 der brokerweite Listener für die implementierten HTTP- und SOAP-Knoten auf einem oder mehreren Integrationsservern aktiv ist:
```
mqsireportproperties IB9NODE -b httplistener -o HTTPListener -n startListener
```

Anzeigen der Eigenschaften für den Cache-Manager:

mqsireportproperties IB9NODE -b cachemanager -o CacheManager -r

Alle aktuellen HTTPListener-Einstellungen anzeigen, die HTTP- und SOAP-Knoten zugeordnet sind (in der Komponente 'httplistener' definiert):
```
mqsireportproperties IB9NODE -b httplistener -o HTTPListener -a
```
Porteinstellung für den HTTPS-Connector für die HTTP-Knoten anzeigen (in der Komponente 'httplistener' definiert):
```
mqsireportproperties IB9NODE -b httplistener -o HTTPSConnector -n port
```

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 im Abschnitt Eigenschaften von konfigurierbaren Services.

Alle konfigurierbaren Aggregationsservices anzeigen:

mqsireportproperties IB9NODE -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 IB9NODE -c CDServer -o AllReportableEntityNames -r

Das Ergebnis dieses Befehls hat das folgende Format:

CDServer
  Standard
    hostname='localhost'
    port='1363'
    brokerPathToStagingDir=''
    cdPathToStagingDir=''
    brokerPathToInputDir=''
    cdPathToInputDir=''
    queuePrefix= ''
    securityIdentity=”Default”

Alle Eigenschaften des konfigurierbaren FtpServer-Service TEST1 anzeigen:
```
mqsireportproperties IB9NODE -c FtpServer -o TEST1 -r
```
Die Einstellung der Eigenschaft protocol des konfigurierbaren FtpServer-Service TEST1 anzeigen:
```
mqsireportproperties IB9NODE -c FtpServer -o TEST1 -n protocol
```
Die Eigenschaften des konfigurierbaren Oracle-JDBCProvider-Service auflisten:
```
mqsireportproperties IB9NODE -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 IB9NODE -c JMSProviders 
     -o AllReportableEntityNames -r
```

Die Eigenschaften aller JMS-Providerressourcen von WebSphere MQ anzeigen:

mqsireportproperties IB9NODE -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 IB9NODE -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 IB9NODE in die Datei policyset.xml exportieren:
```
mqsireportproperties IB9NODE -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 IB9NODE -c PolicySetBindings 
     -o Bindings_2 -n ws-security -p bindings.xml
```
Mit diesem Befehl wird die Datei 'Bindings_2' für Richtliniensatzbindungen im Broker IB9NODE 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 IB9NODE -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 IB9NODE -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'

an09150_.htm |

Letzte Aktualisierung Monday, 27 March 2017