cniIsTerminalAttached

Prüft, ob ein Terminal durch eine Verbindung an einen anderen Knoten angehängt wird. Es wird ein ganzzahliger Wert ausgegeben, der angibt, ob das angegebene Terminalobjekt an ein oder mehrere Terminals auf anderen Nachrichtenflussknoten angehängt wird.

Testen Sie mit dieser Funktion, ob eine Nachricht an ein Terminal weitergegeben werden kann; es ist jedoch erforderlich, diese Funktion aufzurufen, bevor eine Nachricht mit der Dienstprogrammfunktion cniPropagate weitergegeben wird. Mit Hilfe der Funktion cniIsTerminalAttached kann ein Knoten sein Verhalten ändern, wenn ein Terminal nicht verbunden ist.

Syntax

int cniIsTerminalAttached(
  int*          returnCode,
  CciTerminal*  terminalObject);

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
terminalObject
Die Adresse des Eingabe- oder Ausgabeterminals, das in Bezug auf eine zugeordnete Verbindung überprüft werden soll (Eingabe). Die Adresse wird von cniCreateOutputTerminal ausgegeben.

Rückgabewerte

  • Ist das Terminal an einen anderen Knoten über eine Verbindung angehängt, wird der Wert 1 ausgegeben.
  • Wenn das Terminal nicht angehängt ist oder ein Fehler auftritt, wird der Wert Null ausgegeben.
  • Wenn ein Fehler auftritt, gibt der Wert des Parameters returnCode die Fehlerursache an.

Beispiel

  if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
        retvalue = cniPropagate(
                                &rc, 
                                terminalObject, 
                                localEnvironment, 
                                exceptionList, 
                                message);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:29:56

as07550_