WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

cniDispatchThread

Mit dieser Funktion können Sie einen neuen Nachrichtenflussthread zuteilen, um eine weitere Threadinstanz für die Ausführung des benutzerdefinierten Nachrichtenflussempfangsknotens aufzurufen.

Dieser Nachrichtenflussthread wird von einer Gruppe von Threads für jeden Nachrichtenfluss unter Kontrolle der Eigenschaft Zusätzliche Instanzen des Nachrichtenflusses zugewiesen. Falls keine Threads verfügbar sind, da sie alle verwendet werden, wird CCI_SUCCESS zurückgegeben und returnCode wird auf CCI_NO_THREADS_AVAILABLE gesetzt. Diese Rückgabe ist kein Fehler; sie weist lediglich auf eine der folgenden Ursachen hin:
  • Der Nachrichtenfluss wurde nicht für die Ausführung bei zusätzlichen Threads konfiguriert.
  • Alle zusätzlichen konfigurierten Threads sind derzeit aktiv.

Die Funktion cniDispatchThread kann nur von einem Empfangsknoten aufgerufen werden. In jedem anderen Zusammenhang wird CCI_FAILURE zurückgegeben und returnCode wird auf CCI_INV_NODE_ENV gesetzt.

Syntax

int cniDispatchThread(
  int*        Rückkkehrcode,
  CciNode*    nodeObject);

Parameter

returnCode
Der Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_NO_THREADS_AVAILABLE
  • CCI_INV_NODE_OBJECT
  • CCI_INV_NODE_ENV
nodeObject
Die Adresse des Knotenobjekts, das ausgeführt wird, wenn der Broker den Thread erstellt oder wiederverwendet. Dieser Parameter wird an den Knoten übermittelt, wenn die Implementierungsfunktion cniCreateNodeContext aufgerufen wird (Eingabe).

Rückgabewerte

  • Wurde ein Thread erfolgreich zugewiesen, wird CCI_SUCCESS zurückgegeben und returnCode wird auf CCI_SUCCESS gesetzt.
  • Konnte kein Thread zugeteilt werden, weil die in der Nachrichtenfluss-Threadgruppe verfügbaren Threads nicht zur Ausführung der Anforderung ausreichten, wird CCI_SUCCESS zurückgegeben und returnCode wird auf CCI_NO_THREADS_AVAILABLE gesetzt.
  • Wurde die Funktion nicht aus einem Empfangsknoten aufgerufen, wird CCI_FAILURE zurückgegeben und returnCode wird auf CCI_INV_NODE_ENV gesetzt.
  • Bei allen anderen Fehlerbedingungen wird CCI_FAILURE zurückgegeben und returnCode gibt den Grund für den Fehler an.

Beispiel

  cniDispatchThread(&rcDispatch, ((NODE_CONTEXT_ST *)context)->nodeObject);
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:00


ReferenzthemaReferenzthema | Version 8.0.0.5 | as07520_