Die THROW-Anweisung generiert eine Benutzerausnahme.
SEVERITY ist eine optionale Klausel, die den Schweregrad bestimmt, der der Ausnahme zugeordnet ist. Die Klausel kann jeden Ausdruck enthalten, der einen ganzzahligen Wert ungleich Null zurückgibt. Falls Sie die Klausel übergehen, erhält sie standardmäßig den Wert 1 ausgefüllt.
CATALOG ist eine optionale Klausel; falls Sie sie übergehen, wird ihr als Standardwert der aktuelle WebSphere Message Broker-Versionskatalog zugewiesen. Zur expliziten Verwendung des aktuellen Versionsnachrichtenkatalogs von WebSphere Message Broker setzen Sie BIPV600 auf allen Betriebssystemen ein.
MESSAGE ist eine optionale Klausel; falls Sie sie übergehen, wird ihr als Standardwert die erste Nachrichtennummer des Nachrichtenblocks, der für die Verwendung von THROW-Anweisungen im WebSphere Message Broker-Katalog (2951) bereitgestellt wird, zugewiesen. Sie können die Nachrichtennummern 2951 bis 2999 in die THROW-Anweisung eingeben. Alternativ können Sie entsprechend den Anweisungen unter Ereignisprotokollierung von einer benutzerdefinierten Erweiterung aus verwenden Ihren eigenen Katalog generieren.
Verwenden Sie das optionale VALUES-Feld, um Daten in Ihre Nachricht einzusetzen. Sie können beliebig viele Informationen einsetzen, für die bereitgestellten Nachrichten (2951 - 2999) sind jedoch nur acht Implementierungen vorgesehen.
THROW USER EXCEPTION;
THROW USER EXCEPTION CATALOG 'BIPv600' MESSAGE 2951 VALUES(1,2,3,4,5,6,7,8) ;
THROW USER EXCEPTION CATALOG 'BIPv600' MESSAGE 2951 VALUES('The SQL State: ',
SQLSTATE, 'The SQL Code: ', SQLCODE, 'The SQLNATIVEERROR: ', SQLNATIVEERROR,
'The SQL Error Text: ', SQLERRORTEXT ) ;
THROW USER EXCEPTION CATALOG 'BIPv600' MESSAGE 2951 ;
THROW USER EXCEPTION CATALOG 'MyCatalog' MESSAGE 2951 VALUES('Hello World') ;
THROW USER EXCEPTION MESSAGE 2951 VALUES('Insert text 1', 'Insert text 2') ;
Weitere Informationen darüber, wie eine Ausnahme ausgelöst wird, sowie zu SQLSTATE, SQLCODE, SQLNATIVEERROR und SQLERRORTEXT finden Sie unter ESQL-Datenbankstatusfunktionen.