Benutzerexit implementieren

Vorbereitungen:

  • Schreiben und kompilieren Sie den Benutzerexitcode. Weitere Informationen hierzu finden Sie unter Benutzerexit entwickeln.
  • Stellen Sie sicher, dass der Exit:
    1. in einer Bibliothek mit der Erweiterung .lel gespeichert ist
    2. die Funktionen bipInitializeUserExits und bipTerminateUserExits exportiert

Sie können den Status des Benutzerexits für jeden einzelnen Nachrichtenfluss auf 'aktiv' oder 'inaktiv' setzen, ohne den Broker neu starten zu müssen.

So implementieren Sie den Benutzerexit:

  1. Installieren Sie den Benutzerexitcode auf einem Broker.
    Die Bibliothek mit dem Benutzerexit-Code muss in einem Dateisystem installiert werden, auf das der Broker zugreifen kann. Beispielsweise muss die Benutzer-ID, unter der der Broker ausgeführt wird, über die Berechtigung zum Lesen und Ausführen der Datei verfügen. Der Broker sucht an folgenden Orten nach Bibliotheken mit Benutzerexits:
    • In der Brokereigenschaft UserExitPath (UserExitPath64 bei einer 64-Bit-Ausführungsgruppe). Sie definiert eine Liste von Verzeichnissen, die durch Doppelpunkte (unter Windows durch Semikolons) voneinander getrennt sind. Die Eigenschaft kann durch das Attribut '–x' in den Befehlen mqsicreatebroker und mqsichangebroker für bestimmte Broker festgelegt werden.
    • In der Umgebungsvariablen MQSI_USER_EXIT_PATH (MQSI_USER_EXIT_PATH64 bei einer 64-Bit-Ausführungsgruppe). Sie ist eine Liste von Verzeichnissen, die durch Doppelpunkte (unter Windows durch Semikolons) voneinander getrennt sind. In der Regel wird diese Umgebungsvariable gesetzt, um den Benutzerexit in jeden Broker einer bestimmten Umgebung zu laden.

    Wenn beide festgelegt werden, hat die Umgebungsvariable Vorrang. Alle Verzeichnisse in der Umgebungsvariable werden in der Reihenfolge, in der sie in der Variablen stehen, durchsucht. Anschließend werden alle in der Brokereigenschaft angegebenen Verzeichnisse in der Reihenfolge, in der sie in der Eigenschaft stehen, durchsucht.

  2. Laden Sie die Benutzerexit-Bibliothek in die Prozesse des Brokers.
    Nachdem die Benutzerexit-Bibliothek auf dem Broker installiert wurde, muss sie geladen werden. Dies kann auf zwei Arten geschehen:
    • Den Broker stoppen und erneut starten.
    • Geben Sie den Befehl mqsireload aus. Er sorgt dafür, dass die Prozesse der Ausführungsgruppe erneut gestartet werden.
  3. Aktivieren Sie den Benutzerexit.

    Benutzerexits können aktiv oder inaktiv sein. Standardmäßig sind sie inaktiv. Mit Hilfe des Befehls mqsichangeflowuserexits können Sie den Status eines Benutzerexits für jeden einzelnen Nachrichtenfluss ändern, ohne den Broker neu starten zu müssen. Sie können auch den Standardstatus für eine Gruppe von Benutzerexits für jeden einzelnen Broker in 'aktiv' ändern. Verwenden Sie dazu den Befehl mqsichangebroker.

    So legen Sie den Standardstatus von Benutzerexits für einen Broker fest:

    1. Stoppen Sie den Broker.
    2. Legen Sie mit dem Befehl mqsichangebroker die Eigenschaft activeUserExits des Brokers fest.
    3. Starten Sie den Broker, und stellen Sie durch eine Überprüfung des Systemprotokolls sicher, dass alle Ausführungsgruppen ohne Fehler gestartet werden. Wenn für einen Benutzerexit ein ungültiger Name angegeben wird (d. h., der Benutzerexit wird nicht durch eine von der Ausführungsgruppe geladene Bibliothek bereitgestellt), wird die Fehlernachricht BIP2314 in das Systemprotokoll geschrieben, und die Nachrichtenflüsse in den Ausführungsgruppen können erst gestartet werden, nachdem Sie eine der folgenden Aktionen ausgeführt haben:
      • Stellen Sie im Benutzerexitpfad eine Bibliothek zum Implementieren des Exits bereit; geben Sie dann den Befehl mqsireload aus, oder starten Sie den Broker erneut, um einen Exit aus der Bibliothek zu laden.
      • Geben Sie den Befehl mqsichangeflowuserexits aus, um den Exit sowohl aus der Liste der aktiven als auch der Liste der inaktiven Exits zu entfernen.

    Sie können den Standardstatus von Benutzerexits für einen Broker auch überschreiben. Mit dem Befehl mqsichangeflowuserexits können Benutzerexits für einzelne Ausführungsgruppen oder einzelne Nachrichtenflüsse aktiviert oder inaktiviert werden, wobei Nachrichtenflüsse Vorrang vor Ausführungsgruppen haben. Wenn für einen bestimmten Nachrichtenfluss mehrere Exits aktiv sind, werden sie vom Broker in der Reihenfolge aufgerufen, wie sie von mqsichangeflowuserexits festgelegt wurde.

Zugehörige Konzepte
Benutzerexits
Zugehörige Tasks
Benutzerexit entwickeln
Benutzerexits nutzen
Zugehörige Verweise
Befehl 'mqsicreatebroker'
Befehl 'mqsichangebroker'
Befehl 'mqsireportflowuserexits'
Befehl 'mqsichangeflowuserexits'
Befehl 'mqsireload'
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac02160_