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 Datenbankttyp 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

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsicvp--Brokername-----------------------------------------><

Syntax

Neuer Aufruf unter Verwendung vollständig angegebener Datenquellennamen

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

Dieser Aufruf basiert nicht auf einer Beziehung zwischen Broker und Datenquelle und gibt auch dann Informationen zur Datenquelle zurück, wenn keine Beziehung zu einem Broker besteht.

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsicvp-- -n--Name_der_ersten_Datenquelle-------------------->

>-- -u--Benutzer-ID_der_ersten_Datenquelle---------------------->

>-- -p--Kennwort_der_ersten_Datenquelle------------------------->

>--+--------------------------------------------------------------------------------------------------------------------+-->
   '- -c--Name_der_zweiten_Datenquelle-- -i--Benutzer-ID_der_zweiten_Datenquelle-- -a--Kennwort_der_zweiten_Datenquelle-'   

>--+-----+-----------------------------------------------------><
   '- -v-'   

Syntax

Neuer Aufruf, in dem die Datenquellennamen einem Broker zugeordnet werden

Für diesen Aufruf muss eine Beziehung zwischen dem Broker und dem Datenquellennamen bestehen. Für eine erfolgreiche Verwendung dieses Aufrufs müssen zunächst mit dem Befehl mqsisetdbparms eine bestimmte Benutzer-ID und ein Kennwort angegeben werden, die der Broker beim Herstellen der Verbindung zur Datenquelle verwenden soll. Die Ausgabe dieses Aufrufs ist identisch mit der Ausgabe des Aufrufs, in dem vollständig angegebene Datenquellennamen verwendet werden.

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsicvp--Brokername-- -n--erste_Datenquelle------------------>

>--+-------------------------+--+-----+------------------------><
   '- -c--zweite_Datenquelle-'  '- -v-'   

Parameters

Brokername
(Erforderlich bei Verwendung eines Aufrufs unter Angabe von Brokername) Geben Sie den Namen eines Brokers an, der überprüft werden soll, oder den Namen des Brokers, dem die erste_Datenquelle zugeordnet ist.

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

-n erste_Datenquelle
(Erforderlich bei einem Aufruf mit erste_Datenquelle) Der Name der zu prüfenden ODBC-Verbindung.
-u Benutzer-ID_der_ersten_Datenquelle
(Erforderlich, falls der Datenquellenname nicht zuvor dem Broker zugeordnet wurde) Der Benutzername, der eine Verbindung zur ersten_Datenquelle herstellen soll.
-p Kennwort_der_ersten_Datenquelle
(Erforderlich, falls der Datenquellenname nicht zuvor dem Broker zugeordnet wurde) Das mit der Benutzer-ID_der_ersten_Datenquelle verwendete Kennwort.
-c zweite_Datenquelle
(Optional) Bei einem Vergleich zweier Datenquellen auf Übereinstimmung ist dies der Name der zweiten ODBC-Verbindung.
-i Benutzer-ID_der_zweiten_Datenquelle
(Optional) Der Benutzername, mit die Verbindung zur zweiten_Datenquelle hergestellt wird.
-a Kennwort_der_zweiten_Datenquelle
(Optional) Das Kennwort für die Benutzer-ID_der_zweiten_Datenquelle.
-v
(Optional) Bei Angabe dieses Parameters gibt der Befehl zusätzliche Diagnosedaten zu unterstützten CASTS aus; diese Diagnosedaten werden nicht in Nachrichten umgesetzt.

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
Die Datenquelle mit dem Namen MyDB wird mit dem Befehl mqsisetdbparms mit einer zweiten, dem Broker MB8BROKER zugeordneten Datenquelle namens MyDB2 verglichen:
mqsicvp MB8BROKER -n MyDB -c MyDB2
Der vollständig qualifizierte Datenquellenname MyDB wird unter Verwendung der ersten und zweiten Benutzer-IDs und Kennwörter mit einem zweiten vollständig qualifizierten Datenquellennamen MyDB2 verglichen:
mqsicvp –n MyDB –u username –p password –c MyDB2 –i username2 –a password2
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:20:52


ReferenzthemaReferenzthema | Version 8.0.0.1 | an07235_