cniIsTerminalAttached

Diese Funktion überprüft, ob ein Terminal mit einem anderen Knoten verbunden ist. Sie gibt einen ganzzahligen Wert zurück, der angibt, ob das angegebene Terminalobjekt mit einem oder mehreren Terminals auf anderen Nachrichtenflussknoten verbunden ist. Sie können damit testen, 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 auf eine zugeordnete Verbindung überprüft werden soll (Eingabe). Die Adresse wird von cniCreateOutputTerminal zurückgegeben.

Rückgabewerte

  • Wenn das Terminal mit einem anderen Knoten verbunden ist, wird der Wert 1 zurückgegeben.
  • Wenn keine Verbindung besteht oder ein Fehler aufgetreten ist, wird der Wert null zurückgegeben.
  • 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, 
                                destinationList, 
                                exceptionList, 
                                message);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as07550_