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:
- 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.
- 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.
- 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:
- Stoppen Sie den Broker.
- Legen Sie mit dem Befehl mqsichangebroker die Eigenschaft activeUserExits des Brokers fest.
- 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.