mqsicvp-Befehl

Mit dem Befehl mqsicvp können Sie Funktionstests auf einem Broker ausführen.

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Plattformen

Beim Starten eines Brokers mit dem Befehl mqsistart wird dieser Befehl automatisch zum Prüfen der Komponente ausgeführt.

Unter z/OS werden beim Starten eines Brokers die gleichen Prüfprozeduren automatisch ausgeführt.

Sie können diesen Befehl für einen aktiven oder inaktiven Broker ausführen. Wenn der Broker nicht aktiv ist, werden die Funktionstests ausgeführt, die Komponente wird aber nicht gestartet.

Zweck

Der Befehl mqsicvp:

  • Stellt sicher, dass die Brokerumgebung ordnungsgemäß eingerichtet ist, dass also beispielsweise die installierte Java-Stufe unterstützt wird.
  • Es wird geprüft, ob die WebSphere MQ-Warteschlangen definiert und zugänglich sind.

Der Befehl mqsicvp beendet alle diese Prüfungen und schlägt fehl, wenn mindestens eine Prüfung fehlschlägt. Es werden sämtliche Fehler im Systemprotokoll und/oder der Befehlszeile dokumentiert.

Mit dem Befehl Informationen zu Benutzerdatenquellen bereitstellen

Dem Befehl mqsicvp wurden zusätzliche Aufrufmöglichkeiten hinzugefügt, um eine ODBC-Testtoolfunktion bereitzustellen, die folgende Aktionen ausführt:
  • Angabe hilfreicher Informationen und Diagnosedaten zu einer Benutzerdatenquelle oder
  • Vergleich zweier Benutzerdatenquellen im Hinblick auf die Äquivalenz.
Beachten Sie, dass diese Aufrufe getrennt vom bestehenden Aufruf des Befehls mqsicvp erfolgen und nicht beim Brokerstart ausgeführt werden.

Allerdings wurden der bestehende Aufruf und der Brokerstart auch auf Linux- und UNIX-Systemen erweitert, um diese ODBC-Testfunktion für neue Benutzerdatenquellen, die dem Broker zugeordnet wurden, bereitzustellen. Dies gilt, wenn das Database Extender SupportPac von WebSphere Message Broker für die Datenbankkonnektivität zusammen mit dem Befehl mqsisetdbparms verwendet wird.

Wird der Befehl mqsicvp als ODBC-Testtool verwendet, gibt der Befehl eine Informationsnachricht bezüglich der erfolgreichen Verbindung aus, wobei er den Namen der Datenquelle, den Datenbanktyp und die Version angibt. Bei einer sekundären Datenquelle gibt der Befehl mqsicvp eine zweite Informationsnachricht über die erfolgreiche Verbindung zu dieser Datenquelle aus, und zwar mit denselben Informationen für die sekundäre Datenquelle. Sie werden informiert, dass ein Vergleich stattfinden soll.

Wird das Tool für eine Datenquelle ausgeführt, nimmt es einige Prüfungen der ODBC-Schnittstelle vor, um festzustellen, welche Datentypen und Funktionen unterstützt werden; dabei werden auch Informationen zu den Namen und Größen dieser Datentypen abgefragt. Falls einige Datentypen oder Funktionen nicht unterstützt werden, werden diese in einer letzten Informationsnachricht zusammengefasst.

Erfolgt die Ausführung für zwei Datenquellen, werden diese Prüfungen für beide Datenquellen durchgeführt; beide Ergebnisse werden im Bildschirm angezeigt. In einer letzten Informationsnachricht ist angegeben, ob die beiden Datenquellen sich funktional entsprechen und für die Verwendung innerhalb desselben Nachrichtenverarbeitungsknotens infrage kommen; weitere Informationen finden Sie im Abschnitt Über ESQL auf Datenbanken zugreifen.

Syntax

Bestehender Aufruf

Format des Syntaxdiagramms      Pfeildiagram      Nummeriert

Syntax

Neuer Aufruf unter Verwendung vollständig angegebener Datenquellennamen

Jeder Datenquellenname (Data Source Name, DSN) wird vollständig mit einem Benutzernamen und Kennwort angegeben.

Format des Syntaxdiagramms      Pfeildiagram      Nummeriert

Syntax

Neuer Aufruf im Fall einer Zuordnung von Datenquellennamen zum Broker

Jeder Datenquellenname (Data Source Name, DSN) wird dem Broker mit dem Befehl mqsisetdbparms zugeordnet.

Format des Syntaxdiagramms      Pfeildiagram      Nummeriert

Parameter

Brokername
(Erforderlich - wenn Sie einen Aufruf verwenden, der die Angabe Brokername enthält.) Geben Sie einen zu prüfenden Brokernamen an, oder den Brokernamen, dem die primäre Datenquelle zugeordnet ist.

Linux platformUNIX platform Auf Linux- und UNIX-Systemen muss bei allen Namen die Groß-/Kleinschreibung beachtet werden.

-n primäre Datenquelle
(Erforderlich - wenn Sie einen Aufruf verwenden, der die Angabe primäre Datenquelle enthält.) Name der zu prüfenden ODBC-Verbindung.
-u Benutzer-ID für primäre Datenquelle
(Erforderlich - wenn Sie einen Aufruf verwenden, der die Angabe Benutzer-ID für primäre Datenquelle enthält.) Benutzername, dem die primäre Datenquelle zugeordnet ist.
-p Kennwort für primäre Datenquelle
(Erforderlich - wenn Sie einen Aufruf verwenden, der die Angabe Kennwort für primäre Datenquelle enthält.) Kennwort, das in Verbindung mit der Benutzer-ID für primäre Datenquelle verwendet wird.
-c sekundäre Datenquelle
(Optional) Wenn zwei Datenquellen im Hinblick auf die Äquivalenz verglichen werden, ist dies der zweite ODBC-Verbindungsname.
-i Benutzer-ID für sekundäre Datenquelle
(Optional) Benutzername, mit dem eine Verbindung zur sekundären Datenquelle hergestellt werden soll.
-a Kennwort für sekundäre Datenquelle
(Optional) Das Kennwort der Benutzer-ID für sekundäre Datenquelle.
-v
(Optional) Veranlasst, dass zusätzliche, nicht übersetzte Diagnosedaten im Zusammenhang mit unterstützten CASTS vom Befehl ausgegeben werden.

Autorisierung

Auf allen Windows-Systemen müssen Sie diesen Befehl als Benutzer-ID ausführen, die als Servicebenutzer-ID für den Broker definiert ist. Die Servicebenutzer-ID wurde im Parameter -i angegeben, als der Broker mithilfe des Befehls mqsicreatebroker erstellt wurde.

Unter Windows Vista und Windows Server 2008 muss die Servicebenutzer-ID deshalb zur Gruppe Administratoren gehören, wenn Sie diesen Befehl ausführen möchten.

Führen Sie diesen Befehl auf Linux- und UNIX-Systemen als Benutzer-ID aus, unter der der Broker mithilfe des Befehls mqsistart gestartet wurde bzw. wird.

Antworten

  • BIP8040W: Kein Datenbankzugriff (keine Verbindung möglich).
  • BIP8267W: Warnung, möglicherweise bestehen Probleme in Verbindung mit der Nutzung dieser Datenquelle. Weitere Informationen finden Sie in den vorangegangenen Nachrichten.
  • BIP8268I: Die bereitgestellten beiden Datenquellen sind kompatibel und können im selben Rechenknoten verwendet werden.
  • BIP8269W: Die bereitgestellten beiden Datenquellen sind nicht kompatibel und dürfen nicht im selben Rechenknoten verwendet werden.
  • BIP8270I: Mit Datenquelle <..mehrere Einfügungen..> verbunden
  • BIP8271I: Mit zweiter Datenquelle <..mehrere Einfügungen..> zum Vergleich verbunden.
  • BIP8272W: Angegebene Datenquelle wurde dem Broker nicht zugeordnet.
  • BIP8273I: Die folgenden Datentypen und Funktionen werden von der Datenquelle '&1': <..mehrere Einfügungen..> nicht nativ unterstützt
  • BIP8274W: Die folgenden Datentypen und Funktionen führen bei der Verwendung der Datenquelle '&1' mit WebSphere Message Broker: <..mehrere Einfügungen..> möglicherweise zu Problemen.
  • BIP8873I: Die Komponentenprüfung für den Broker 'Brokername' wird gestartet.
  • BIP8874I: Die Komponentenprüfung für 'Brokernname' wurde erfolgreich beendet.
  • BIP8875W: Die Komponentenprüfung für 'Brokername' wurde beendet, aber mindestens eine Überprüfung ist fehlgeschlagen.
  • BIP8876I: Die Umgebungsprüfung für den Broker 'Brokername' wird gestartet.
  • BIP8877W: Die Umgebungsprüfung für den Broker 'Brokername' wurde beendet, aber mindestens eine Überprüfung ist fehlgeschlagen.
  • BIP8878I: Die Umgebungsprüfung für den Broker 'Brokername' wurde erfolgreich beendet.
  • BIP8882I: WebSphere MQ-Prüfung für den Broker 'Brokername' wird gestartet.
  • BIP8883W: Die WebSphere MQ-Prüfung für den Broker 'Brokername' wurde beendet, aber mindestens eine Überprüfung ist fehlgeschlagen.
  • BIP8884I: Die WebSphere MQ-Prüfung für den Broker 'Brokername' wurde erfolgreich beendet.
  • BIP8885E: Die Überprüfung ist fehlgeschlagen. Die Verbindung mit Warteschlangenmanager 'Warteschlangenmanagername' konnte nicht hergestellt werden. MQRC: Rückkehrcode MQCC: Beendigungscode
  • BIP8886I: Überprüfung für Warteschlange 'Warteschlangenname' unter Warteschlangenmanager 'Warteschlangenmanagername' bestanden.
  • BIP8887E: Überprüfung für Warteschlange 'Warteschlangenname' unter Warteschlangenmanager 'Warteschlangenmanagername' bei der Ausgabe von 'Operation' fehlgeschlagen. MQRC: Rückkehrcode MQCC: Beendigungscode
  • BIP8888E: Die Überprüfung ist fehlgeschlagen. Verbindung mit Warteschlangenmanager 'Warteschlangenmanagername' konnte nicht getrennt werden. MQRC: Rückkehrcode MQCC: Beendigungscode
  • BIP8892E: Die Überprüfung ist fehlgeschlagen. Die installierte Java-Version 'installierte_Version' stimmt nicht mit der erforderlichen Java-Version 'unterstützte_Version' überein.
  • BIP8893E: Überprüfung für Umgebungsvariable 'Variablenname' fehlgeschlagen. Auf Datei 'Dateiname' kann mit Benutzer-ID 'Benutzer-ID' nicht zugegriffen werden. Weitere Informationen für die IBM® Unterstützung: Daten1 Daten2.
  • BIP8894I: Überprüfung für 'Brokername' bestanden.
  • BIP8895E: Die Überprüfung ist fehlgeschlagen. Umgebungsvariable 'Variablenname' ist falsch oder fehlt.
  • BIP8896E: Die Überprüfung ist fehlgeschlagen. Auf die Registry kann mit Benutzer-ID 'Benutzer-ID' nicht zugegriffen werden. Weitere Informationen für die IBM Unterstützung: Daten1 Daten2
  • BIP8897E: Die Überprüfung ist fehlgeschlagen. Umgebungsvariable 'Variablenname' stimmt nicht mit dem Brokernamen 'Brokername' überein.
  • BIP8900I: Überprüfung der APF-Berechtigung für Datei 'Dateiname' war erfolgreich.
  • BIP8903E: Die Überprüfung ist fehlgeschlagen. Die Überprüfung der APF-Berechtigung für Datei 'Dateiname' ist fehlgeschlagen.
  • BIP8904E: Die Überprüfung ist fehlgeschlagen. Datei 'Dateiname1' mit Rückkehrcode 'Rückkehrcode' und Fehlernummer 'Fehlernummer' konnte nicht gestartet werden.

Beispiele

Führen Sie Überprüfungen für den Broker MB8BROKER aus:
mqsicvp MB8BROKER
Der Datenquellenname MyDB wird dem Broker MB8BROKER mit dem Befehl mqsisetdbparms zugeordnet:
mqsicvp MB8BROKER -n MyDB
Der Datenquellenname MyDB wird unter Verwendung des Befehls mqsisetdbparms mit dem sekundären Datenquellennamen MyDB2 verglichen, der dem Broker MB8BROKER zugeordnet ist:
mqsicvp MB8BROKER -n MyDB -c MyDB2
Der vollständig qualifizierte Datenquellenname MyDB wird unter Verwendung der primären und sekundären Benutzer-IDs und Kennwörter mit einem sekundären vollständig qualifizierten Datenquellennamen verglichen (MyDB2):
mqsicvp –n MyDB –u Benutzername –p Kennwort –c MyDB2 –i Benutzername2 –a Kennwort2
Bemerkungen | Marken | Dieser Link öffnet ein neues Fenster Downloads | Dieser Link öffnet ein neues Fenster Bibliothek | Dieser Link öffnet ein neues Fenster Support | Feedback

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

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2011-11-04 19:54:41


ReferenzthemaReferenzthema | Version 8.0.0.0 | an07235_