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. Sie können damit testen, ob eine Nachricht an ein Terminal weitergegeben werden kann. Es ist jedoch nicht erforderlich, diese Funktion aufzurufen, bevor Sie eine Nachricht mit der Dienstprogrammfunktion cniPropagate weitergeben. Mit der Funktion cniIsTerminalAttached kann ein Knoten sein Verhalten modifizieren, wenn ein Terminal nicht angeschlossen 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.
  • Beim Auftreten eines Fehlers gibt der Wert des Parameters returnCode den Grund dafür an.

Beispiel

  if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
        retvalue = cniPropagate(
                                &rc, 
                                terminalObject, 
                                destinationList, 
                                exceptionList, 
                                message);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07550_