Befehl 'mqsichangeflowuserexits'

Unterstützte Betriebssysteme

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS. Führen Sie diesen Befehl auf eine der folgenden zwei Arten aus - als einen Konsolbefehl oder durch Anpassen und Übergeben von BIPCHUE; weitere Informationen erhalten Sie unter Inhalt der Broker-PDSE

Zweck

Verwenden Sie den Befehl mqsichangeflowuserexits, um die Liste der aktiven oder inaktiven Benutzerexits festzulegen. Für jede Ausführungsgruppe und jeden Nachrichtenfluss gibt es eine Liste aktiver und eine Liste inaktiver Benutzerexits. Der effektive Status der Benutzerexits für einen bestimmten Fluss wird beim Start des Flusses festgelegt.

Die Ausführungspriorität lautet wie folgt: Nachrichtenfluss, Ausführungsgruppe und dann Brokerstandardwert. Die Liste aktiver Elemente hat in den Einstellungen des Nachrichtenflusses und der Ausführungsgruppe Vorrang vor der Liste inaktiver Elemente.

Wenn der Status für einen bestimmten Benutzerexit nicht für den Nachrichtenfluss festgelegt ist, wird der zugehörige Status der Einstellung der Ausführungsgruppe entnommen. Wenn der zugehörige Status nicht für den Nachrichtenfluss oder die Ausführungsgruppe festgelegt ist, wird der Standardstatus übernommen, der implizit inaktiv ist. Er kann jedoch auch über die Brokereigenschaft activeUserExits im Befehl mqsichangebroker explizit als aktiv definiert werden.

Wenn für einen Nachrichtenfluss oder eine Ausführungsgruppe ein bestimmter Benutzerexitname in den Listen aktiver und inaktiver Elemente enthalten ist, hat die Liste aktiver Elemente Vorrang, und der Benutzerexit ist für diese Ebene aktiv. Wenn Sie also einen Benutzerexit von aktiv in inaktiv ändern möchten, müssen Sie ihn mit Hilfe des Attributs -i als Teil der Liste inaktiver Elemente angeben. Außerdem müssen Sie ihn aus der Liste aktiver Elemente entfernen, indem Sie die neue Liste aktiver Elemente mit Hilfe des Attributs -a erneut angeben.

Wenn für einen bestimmten Fluss mehrere Exits aktiv sind, werden sie in einer definierten Reihenfolge aufgerufen. Die Exits in der Liste aktiver Elemente des Nachrichtenflusses werden zuerst in der Reihenfolge aufgerufen, in der sie im Attribut -a angegeben wurden.

Nach dem Aufruf dieser Exits werden die Exits in der Liste aktiver Elemente der Ausführungsgruppe (die sich weder in der Liste aktiver noch in der Liste inaktiver Elemente des Nachrichtenflusses befanden) aufgerufen. Sie werden in der Reihenfolge aufgerufen, in der sie im Attribut -a angegeben wurden.

Sämtliche Benutzerexits, die in der Liste aktiver oder inaktiver Elemente der Ausführungsgruppe oder des Nachrichtenflusses nicht erwähnt werden, sondern sich in der Liste aktiver Elemente des Brokers befinden, werden in der Reihenfolge aufgerufen, in der sie bei der Festlegung der Brokereigenschaft activeUserExits angegeben wurden.

Falls einer der Benutzerexits, die in der Liste aktiver oder inaktiver Elemente angegeben sind, nicht für die Zielausführungsgruppe registriert ist, schlägt der Befehl mit dem Fehler BIP8858 fehl.

Wenn ein Benutzerexit nach erfolgreicher Ausführung des Befehls ungültig wird, wird abhängig davon, in welcher Liste der Benutzerexit angezeigt wurde, folgende Maßnahme ergriffen:
  • Wenn der Benutzerexit in der Liste aktiver oder inaktiver Elemente des Nachrichtenflusses angegeben wurde, kann der Fluss nicht gestartet werden, und die Nachricht BIP2315 wird in das Systemprotokoll geschrieben.
  • Wenn der Benutzerexit in der Liste aktiver oder inaktiver Elemente der Ausführungsgruppe angegeben wurde, kann die Ausführungsgruppe nicht gestartet werden, und die Nachricht BIP2314 wird in das Systemprotokoll geschrieben.
Dies kann aus einem der folgenden drei Gründe vorkommen:
  • Der Broker oder die Ausführungsgruppe wird nach Änderung der Variable MQSI_USER_EXIT_PATH durch Entfernung des Verzeichnisses mit der Benutzerexitbibliothek neu gestartet.
  • Der Broker oder die Ausführungsgruppe wird nach Änderung der Brokereigenschaft userExitPath durch Entfernung des Verzeichnisses mit der Benutzerexitbibliothek neu gestartet.
  • Die Benutzerexitbibliothek (oder eine ihrer Abhängigkeiten) wird entfernt, oder der Broker kann sie nicht laden.
Wählen Sie den entsprechenden Link für Details zu diesem Befehl für die Plattform(en) aus, die in Ihrem Unternehmen verwendet wird (werden):

Berechtigung

Auf Windows-, Linux- und UNIX-Systemen muss die Benutzer-ID, mit der dieser Befehl aufgerufen wird, über die Gruppenberechtigung mqbrkrs verfügen.

Zugehörige Konzepte
Benutzerexits
Zugehörige Verweise
Befehl 'mqsireportflowuserexits'
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an35900_