cciThrowException

Mit Hilfe von cciThrowException kann eine Ausnahmebedingung ausgelöst werden.

Die Ausnahmebedingung wird von der Brokerschnittstelle ausgelöst, wobei die angegebenen Argumente die Ausnahmedaten bilden.

Syntax

void cciThrowException(
  int*                Rückkehrcode,
  CCI_EXCEPTION_TYPE  Typ,
  char*               Datei,
  int                 Zeile,
  char*               Funktion,
  CciChar*            Nachrichtenquelle,
  int                 Nachrichtennummer,
  char*               Tracetext,
                      ...);

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe). Der mögliche Rückkehrcode lautet CCI_INV_DATA_POINTER.
type
Der Typ der Ausnahmebedingung (Eingabe). Gültige Werte sind:
  • CCI_FATAL_EXCEPTION
  • CCI_RECOVERABLE_EXCEPTION
  • CCI_CONFIGURATION_EXCEPTION
  • CCI_PARSER_EXCEPTION
  • CCI_CONVERSION_EXCEPTION
  • CCI_DATABASE_EXCEPTION
  • CCI_USER_EXCEPTION
file
Der Name der Quellendatei, von der aus die Ausnahmebedingung generiert wurde (Eingabe). Der Wert ist optional, er ist jedoch für die Fehlerbehebung hilfreich.
line
Die Zeilennummer der Quellendatei, von der aus die Ausnahmebedingung generiert wurde (Eingabe). Der Wert ist optional, er ist jedoch für die Fehlerbehebung hilfreich.
function
Der Name der Funktion, die die Ausnahmebedingung generiert hat (Eingabe). Der Wert ist optional, er ist jedoch für die Fehlerbehebung hilfreich.
messageSource
Der vollständig qualifizierte Standort und Name der Windows-Nachrichtenquelle bzw. des Linux-, UNIX- oder z/OS-Nachrichtenkatalogs.

Beginn der ÄnderungGeben Sie zur Verwendung des aktuellen Broker-Nachrichtenkataloges in allen Betriebssystemen BIPv600 an. Sie haben auch die Möglichkeit, einen eigenen Nachrichtenkatalog zu erstellen.Ende der Änderung

Nachrichtennummer
Die Nachrichtennummer, die die Ausnahmebedingung bezeichnet (Eingabe). Wenn die Nachrichtennummer null ist, wird vorausgesetzt, dass keine Nachricht verfügbar ist. Wenn die Nachrichtennummer ungleich null ist, wird die angegebene Nachricht mit allen Einfügungen, die in der Argumentenliste für Variablen bereitgestellt werden, in das Brokerereignisprotokoll geschrieben.
Tracetext
Trace-Informationen, die in das Broker-Service-Traceprotokoll geschrieben werden (Eingabe). Die Informationen sind optional, aber nützlich für Debugzwecke.
...
Eine Argumentenliste für C-Variablen, die alle Nachrichteneinfügungen, die die Nachricht begleiten, enthält (Eingabe). Diese Einfügungen werden als Zeichenfolgen behandelt, und es wird vorausgesetzt, dass die Variablenargumente den Typ pointer to char haben.

char*-Zeichen müssen Zeichenfolgen in ASCII (Latin) oder EBCDIC (1047) sein.

Das letzte Argument in dieser Liste muss (char*)0 lauten.

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:30:00

as08554_